feat(n11): add base64 document staging from e-Court

เพิ่มทางเข้าเอกสารสำหรับ e-Court ที่ไม่มี URL ให้ดึง — POST /api/note/files/stage
(x-api-key DOCVER_API_KEY) ส่งเนื้อไฟล์ PDF/รูปเป็น base64 ระบบเก็บใน RAM staging
(TTL sliding 8 ชม. + LRU + cap 100MB/ไฟล์ 256MB รวม — ห้ามเขียน disk/DB/MinIO
แม้แต่ไบต์เดียวตามโจทย์) ส่วน annotation/bookmark เก็บถาวรตามระบบเดิม:

- lib/staged-docs.ts: Map บน globalThis + sentinel "staged:<uuid>.<ext>" ใน
  pdf_url (ext จาก magic bytes — ไม่ต้อง migration) + hasStagedDoc แยกจาก getStagedDoc
- lib/ecourt-fid.ts: external_id เก็บ HMAC-SHA256(pepper, fid) แทน fid ดิบ
  (env FID_HASH_PEPPER fail-closed) + แปลง row เก่าด้วย npm run migrate:ecourt-fid
- route stage: อ่าน body แบบ stream นับไบต์ + idle 60 วิ/total 10 นาที = 408 +
  concurrency default 1 = 429 + base64 strict + magic bytes กำหนด ext เอง
- registerStagedFile: ลำดับกัน race 23505 — stage ใต้ id ก่อน insert โดนชนแล้ว
  re-stage ใต้ id ผู้ชนะ + try/finally คืน RAM ผู้แพ้ทุกทางออก
- ทางอ่าน 4 จุด: /api/note/pdf + export route (410 gate ไทย), resolvePublicPdfPath
  guard PdfPathError, PDFViewer โหลดผ่าน route + objectURL (gate ครบทุกชนิดไฟล์)
- session route (D5): ลิงก์ fid-only ตัดสิน staging ตั้งแต่แลก token — มี bytes
  ได้ fileId / หมดอายุ fileError "พ้นช่วงจัดเตรียม" / token ออกทุกกรณี
- Swagger UI: endpoint ใหม่ + คู่มือ retry (408/429/5xx ยิงซ้ำได้ stage ซ้ำปลอดภัย)
- MockStageForm บน /note/dev ทดสอบ 3 ขั้นในหน้าเดียว (ต้องถือ API key จริง)

Verify ครบตาม docs/PLAN-STAGED.md: tsc สะอาด + vitest 59 เคสใหม่ผ่าน + E2E
browser จริง (textLayer ไทยเรียงถูก / export ฝัง annotation / restart ได้
fileError ตั้งแต่ bootstrap / RAM 100MB: peak WS +580MB commit จริง +92MB) —
ผ่าน code review รอบ 7 แก้ครบทุก finding

Co-Authored-By: Claude Code <noreply@anthropic.com>

tests/helpers/db-mock.ts

@@ -0,0 +1,76 @@
+// shared mock ของ @/db สำหรับ route/lib tests ที่ต้องจำลอง drizzle chain
+// (select().from().where().limit() / insert().values() / update().set().where())
+// — ใช้ร่วมโดย vi.mock("@/db", async () => ({ db: createDbMock(state) }))
+// โดย state เก็บบน globalThis ของ test file (pattern เดียวกับ lib/staged-docs.ts)
+export type DbMockRow = {
+  id: string;
+  title: string;
+  pdfUrl: string;
+  externalId: string;
+  typeId: string | null;
+};
+
+export type DbMockState = {
+  /** ค่า default ของ select ทุกครั้ง */
+  rows: DbMockRow[];
+  /** override รายครั้งของ select (index = ลำดับการเรียน — undefined = ใช้ rows) */
+  rowsBySelect: (DbMockRow[] | undefined)[];
+  selectCalls: number;
+  insertAttempts: Array<Record<string, unknown>>;
+  updates: Array<{ cond: unknown; patch: Record<string, unknown> }>;
+  /** โค้ด error ของ postgres ที่ insert จะโยน (เช่น "23505") — null = สำเร็จ */
+  insertErrCode: string | null;
+};
+
+export function createDbMockState(): DbMockState {
+  return {
+    rows: [],
+    rowsBySelect: [],
+    selectCalls: 0,
+    insertAttempts: [],
+    updates: [],
+    insertErrCode: null,
+  };
+}
+
+export function createDbMock(state: DbMockState) {
+  return {
+    select: () => ({
+      from: () => ({
+        where: () => ({
+          limit: async (): Promise<DbMockRow[]> => {
+            const rows = state.rowsBySelect[state.selectCalls] ?? state.rows;
+            state.selectCalls += 1;
+            return rows.map((r) => ({ ...r }));
+          },
+        }),
+      }),
+    }),
+    insert: () => ({
+      values: async (v: Record<string, unknown>): Promise<void> => {
+        state.insertAttempts.push(v);
+        if (state.insertErrCode !== null) {
+          throw Object.assign(new Error("db error (mock)"), {
+            code: state.insertErrCode,
+          });
+        }
+      },
+    }),
+    update: () => ({
+      set: (patch: Record<string, unknown>) => ({
+        where: async (cond: unknown): Promise<void> => {
+          state.updates.push({ cond, patch });
+        },
+      }),
+    }),
+  };
+}
+
+/** คืน state ที่ vi.mock factory สร้างไว้บน globalThis (factory รันก่อน import ของ test) */
+export function dbMockStateFromGlobal(): DbMockState {
+  const holder = globalThis as typeof globalThis & { __dbMockState?: DbMockState };
+  if (holder.__dbMockState === undefined) {
+    throw new Error("db mock ยังไม่ถูกสร้าง — vi.mock ต้องรันก่อน");
+  }
+  return holder.__dbMockState;
+}