eCourt-note/lib
Your Name a02e983ba8 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>
2026-11-05 12:53:56 +07:00
..
addin-ticket.ts Refactor ticket verification and installation scripts 2026-10-28 14:42:03 +07:00
annotate-events.ts refactor(routes): move routes under /note, APIs under /api/note 2026-10-06 14:55:07 +07:00
document-versioning.ts feat: add GET /api/documents/latest returning latest version file with stamped ticket 2026-10-31 11:09:42 +07:00
docver-store.ts feat: add GET /api/documents/latest returning latest version file with stamped ticket 2026-10-31 11:09:42 +07:00
docver-token.ts Merge branch 'forgejo-dev' into working 2026-11-02 10:07:08 +07:00
docx-pool.ts Multi-thread support for applyTemplate 2026-11-03 14:48:37 +07:00
ecourt-fid.ts feat(n11): add base64 document staging from e-Court 2026-11-05 12:53:56 +07:00
external-api-auth.ts refactor(routes): move routes under /note, APIs under /api/note 2026-10-06 14:55:07 +07:00
external-api.ts feat(n11): add base64 document staging from e-Court 2026-11-05 12:53:56 +07:00
external-import.ts feat(n11): add base64 document staging from e-Court 2026-11-05 12:53:56 +07:00
lib-tmpl.ts Multi-thread support for applyTemplate 2026-11-03 14:48:37 +07:00
lib-utils.ts clear environment variable, update download-docx(sample) to check latest version before query database. 2026-11-02 10:00:12 +07:00
note-auth.ts feat(note): mock e-Court login form on dev page 2026-11-02 12:19:38 +07:00
note-session.ts feat(sso): switch note session from cookies to token 2026-10-30 18:05:36 +07:00
note-token.ts feat(sso): switch note session from cookies to token 2026-10-30 18:05:36 +07:00
openapi.ts feat(n11): add base64 document staging from e-Court 2026-11-05 12:53:56 +07:00
pdf-actual-text.ts ซ่อม text ไทย PDF (ActualText) + revalidatePath ทุก action + คีย์ลัด DEL + ตรายาง label บรรทัดเดียว 2026-09-11 13:28:35 +07:00
remote-file.ts refactor(routes): move routes under /note, APIs under /api/note 2026-10-06 14:55:07 +07:00
server-pdf.ts feat(n11): add base64 document staging from e-Court 2026-11-05 12:53:56 +07:00
staged-docs.ts feat(n11): add base64 document staging from e-Court 2026-11-05 12:53:56 +07:00