.env.example

@@ -5,25 +5,3 @@ DATABASE_URL=postgresql://postgres:postgres@127.0.0.1:54322/ecourt-note
 # N10 (optional): API key ของ /api/external/* (backend e-Court เรียก server-to-server)
 # ไม่ตั้ง/ว่าง = ปฏิเสธทุก request (fail closed) — ตั้งค่ายาวและสุ่ม เช่น 32+ ตัวอักษร
 # EXTERNAL_API_KEY=
-
-# MinIO ของ API เอกสาร versioning (docs/PLAN-DOCVER.md §6) — ค่านี้ตรง docker-compose.yml
-# (MINIO_ENDPOINT/MINIO_ACCESS_KEY/MINIO_SECRET_KEY ไม่ตั้ง = ทุก endpoint ของกลุ่มนี้ตอบ 500)
-# หมายเหตุ: พอร์ตโฮสต์เป็น 19000 เพราะ 9000/9001 ชนกับโปรเจกต์อื่นในเครื่อง dev
-# (ใน production ตั้งเป็นพอร์ตจริงที่ deploy) และ presigned URL อ้าง endpoint นี้ตรง ๆ —
-# production ต้องเป็นโฮสต์ที่เบราว์เซอร์ของผู้ใช้เข้าถึงได้ ไม่ใช่แค่ที่ Next server เข้าถึงได้
-MINIO_ENDPOINT=127.0.0.1
-MINIO_PORT=19000
-MINIO_USE_SSL=false
-MINIO_ACCESS_KEY=minioadmin
-MINIO_SECRET_KEY=minioadmin
-# MINIO_BUCKET=docver
-# DOCVER_LINK_TTL_SECONDS=900
-
-# docver token (2026-10-22): API key ของ POST /api/documents/token (header x-api-key)
-# ไม่ตั้ง/ว่าง = ปฏิเสธทุก request (fail closed) — ตั้งค่ายาวและสุ่ม เช่น 32+ ตัวอักษร
-# (ห้าม log ค่า key ดิบ — เทียบแบบ timing-safe ทุกครั้ง)
-DOCVER_API_KEY=
-# secret เซ็น/ตรวจ JWT HS256 ของทุก endpoint /api/documents/* (Authorization: Bearer)
-# ไม่ตั้ง/ว่าง = ออก token ไม่ได้ (500) และทุก endpoint ตอบ 401 (fail closed) — ห้าม log ค่า secret
-DOCVER_TOKEN_SECRET=
-# DOCVER_TOKEN_TTL_SECONDS=3600

CLAUDE.md

@@ -21,7 +21,7 @@
 1. **Non-Destructive:** ไฟล์ต้นฉบับ (PDF/รูปภาพ) ไม่ถูกแก้ไขเด็ดขาด — annotation เก็บใน DB เป็นพิกัดเท่านั้น (export PDF ของ F8/N3 สร้างไฟล์ใหม่จากสำเนาในหน่วยความจำ — อ่าน `public/` อย่างเดียว ห้ามเขียนทับ; อัปโหลด N4 เขียนไฟล์**ใหม่**ที่ `public/note/uploads/` เท่านั้น ห้ามแตะไฟล์เดิม)
 2. **พิกัดทุกอย่างใน DB เป็น % ของขนาดหน้า** — `rects`, `paths`, `position`, `strokeWidth` (% ของ width), `yOffset` (% ของ height) — แปลง px⇄% ผ่าน `utils/coordinates.ts` เท่านั้น และก่อนบันทึก HIGHLIGHT ต้องรวบ rects ด้วย `mergeRectsByLine` เหลือ 1 rect ต่อบรรทัด
 3. **ลำดับ layer ตาม PLAN.md §1:** canvas (`pointer-events: none` เสมอ) → highlight-layer (`none` เสมอ, `mix-blend-mode: multiply`) → textLayer → InkLayer (SVG) → comment pins — สลับ pointer-events ตาม tool ปัจจุบัน
-4. **เขียนผ่าน Server Actions เท่านั้น** (`app/actions/annotations.ts`) และ**หลังเขียน DB สำเร็จทุกครั้ง ต้อง publish event ผ่าน `lib/annotate-events.ts` + `revalidatePath` หน้า viewer และ summary ของ fileId นั้น** (helper `revalidateFilePages` — สั่ง browser ทิ้ง Router Cache ฝั่ง client, `force-dynamic` ปิดแค่ฝั่ง server ไม่พอ: ไม่งั้นกด back แล้วคลิกเข้าไฟล์ใหม่ยังได้ initial data เก่าจนต้อง hard refresh) / **อ่าน + sync ผ่าน SSE hook** (`hooks/useAnnotationRealtime.ts` เปิด `EventSource` ไป `/api/note/annotations/stream?fileId=`) — event เป็น DTO (camelCase + ISO string) จาก server ตรง ๆ — **ยกเว้น `registerExternalFile` (N8)** ที่เขียน row `files` ระหว่าง render ของหน้า `/note` และ `/note/annotate` (entry point ทั้งสองของสัญญาลิงก์ `?fileUrl=`) แล้ว `redirect` ออกทันที (หน้า `force-dynamic` + รายการไฟล์ไม่ได้ sync ผ่าน SSE — ไม่ต้อง publish event/`revalidatePath`) · เช่นกัน **กลุ่ม docver `app/api/documents/**`** (จัด version เอกสาร — `docs/PLAN-DOCVER.md`) เขียนตาราง `documents`/`document_versions` ผ่าน route handler ไม่ใช่ Server Action (ผู้เรียกเป็นระบบภายนอก stand-alone ไม่มี session ของแอป note — identity userId/userName, templateId และ docId (จาก claim fid) แกะจาก Bearer token ที่ขอจาก `POST /api/documents/token` ผ่าน `lib/docver-token.ts` ไม่รับจาก request payload อีกต่อไป) — ไม่มีหน้า note ใดอ่านตารางนั้น จึงไม่ต้อง publish event/`revalidatePath`
+4. **เขียนผ่าน Server Actions เท่านั้น** (`app/actions/annotations.ts`) และ**หลังเขียน DB สำเร็จทุกครั้ง ต้อง publish event ผ่าน `lib/annotate-events.ts` + `revalidatePath` หน้า viewer และ summary ของ fileId นั้น** (helper `revalidateFilePages` — สั่ง browser ทิ้ง Router Cache ฝั่ง client, `force-dynamic` ปิดแค่ฝั่ง server ไม่พอ: ไม่งั้นกด back แล้วคลิกเข้าไฟล์ใหม่ยังได้ initial data เก่าจนต้อง hard refresh) / **อ่าน + sync ผ่าน SSE hook** (`hooks/useAnnotationRealtime.ts` เปิด `EventSource` ไป `/api/note/annotations/stream?fileId=`) — event เป็น DTO (camelCase + ISO string) จาก server ตรง ๆ — **ยกเว้น `registerExternalFile` (N8)** ที่เขียน row `files` ระหว่าง render ของหน้า `/note` และ `/note/annotate` (entry point ทั้งสองของสัญญาลิงก์ `?fileUrl=`) แล้ว `redirect` ออกทันที (หน้า `force-dynamic` + รายการไฟล์ไม่ได้ sync ผ่าน SSE — ไม่ต้อง publish event/`revalidatePath`)
 5. **Timestamp ข้าม server→client→SSE เป็น ISO string เสมอ** (DTO types) — ห้ามส่ง Date object ตรง ๆ
 6. **pdfjs-dist ต้อง `dynamic import()` ภายใน useEffect เท่านั้น** — ห้าม import top-level ใน module scope ที่ server evaluate และต้องตั้ง `GlobalWorkerOptions.workerSrc = withBasePath("/pdf.worker.min.mjs")` (postinstall `scripts/patch-pdf-worker.mjs` คัดลอกไฟล์ไป `public/note/` **แล้ว patch จุดเดียว: ถอด `if (scaledDim)` รอบ `textChunk.prevTransform = getCurrentTextTransform()` ให้อัปเดตทุก glyph** — pdf.js เดิมข้าม glyph กว้าง 0 อย่างสระ/วรรณยุกต์ไทย ทำให้ charSpacing ของ glyph เหล่านั้นสะสมเป็น gap จน `addFakeSpaces` แทรก " " กลางคำ "ฉะนั้ น" — bug ของ pdf.js ที่ upstream ยังไม่แก้; การ patch ทำบนโค้ด minified ด้วย pattern จำเพาะ ถ้าอัปเกรด pdfjs-dist แล้ว pattern ไม่ตรง postinstall จะ **fail ดัง ๆ โดยตั้งใจ** กัน patch หลุดเงียบ — test กัน regression: `tests/scripts/patch-pdf-worker.test.ts` + fixture `tests/fixtures/thai_letterspacing.pdf` — Docker build ต้องใช้ script นี้ด้วย ไม่ใช่ copyFileSync เปล่า ดู `docker/web.Dockerfile`) — ห้ามใช้ `new URL(..., import.meta.url)`
 7. **InkLayer ใช้ SVG แบบไม่มี viewBox** — render ด้วย px จริง แปลง % → px จากขนาดที่ ResizeObserver วัด (viewBox จะทำให้ความหนาเส้นบิดเบี้ยว)
@@ -34,14 +34,12 @@
 ## โครงสร้างไฟล์ (ตามแผน)
 
 ```
-docker-compose.yml     ← dev dependencies: `db` (judes-note-db — ชื่อ container/วอลุ่มเดียวกับคำสั่ง docker run เดิมใน README migrate ได้เลย, POSTGRES_DB ecourt-note) + `minio` (judes-note-minio — object storage ของกลุ่ม docver; โฮสต์แมพ 19000 API/19001 console เพราะ 9000/9001 ชน container โปรเจกต์อื่นในเครื่อง dev, image จาก quay.io ทางการ; bucket `docver` ไม่ต้องสร้างเอง app สร้างตอน first use ผ่าน ensureBucket)
-docs/PLAN-DOCVER.md   ← แผนกลุ่ม API docver: จัด version เอกสาร .docx+.pdf ต่อ docId (ห้ามซ้ำ) เก็บ object ใน MinIO + ผู้อัปโหลดต่อ version — contract 4 endpoint (เพิ่ม POST /token ขอ access_token — Bearer บังคับทุก endpoint), ดีไซน์ตาราง, env MINIO_* + DOCVER_API_KEY/DOCVER_TOKEN_SECRET/DOCVER_TOKEN_TTL_SECONDS ทั้งหมด
 scripts/patch-pdf-worker.mjs ← postinstall: คัดลอก pdf.worker.min.mjs จาก node_modules ไป public/note/ + patch fake-space ไทย (invariant #6 — เจอ pattern ≠ 1 จุดหลังอัปเกรด pdfjs-dist = exit 1 ดัง ๆ)
 scripts/copy-swagger-ui.mjs ← postinstall ตัวที่สอง: คัดลอก swagger-ui-dist (bundle+css) ไป public/note/swagger-ui/ สำหรับหน้า Swagger UI ที่ GET /api/swagger (intranet ไม่ใช้ CDN — หาไฟล์ไม่เจอหลังอัปเกรด = exit 1 ดัง ๆ เหมือน patch-pdf-worker; Docker build รัน script นี้ด้วย ดู docker/web.Dockerfile)
 scripts/fetch-office-js.mjs ← postinstall ตัวที่สาม: ดาวน์โหลด Office.js runtime **ฉบับ CDN ล่าสุด** (appsforoffice.microsoft.com — ชุดไฟล์เฉพาะ Word: loader + host files ราย platform + legacy 15.x + o15apptofilemappingtable/microsoftajax + office_strings.js ต่อ locale en-us/th-th บังคับ) ไป public/wordaddin/office-js/ ให้ taskpane โหลด same-origin — npm `@microsoft/office-js` เลิกอัปเดตที่ 1.1.110 (~2018) ไม่มี `Document.close`/enum `CloseBehavior` ที่ runtime ใหม่+`@types/office-js` มี; ไฟล์หลักหาย/ตรวจไม่เจอ `"Document.close"`+`CloseBehavior` ใน word-win32-16.01.js หลังโหลด = exit 1 ดัง ๆ (ไฟล์ปลายทาง gitignore — ดาวน์โหลดใหม่ทุกครั้ง; ติดตั้งต้องออกเน็ตถึง CDN ของ Microsoft ส่วน runtime ตัวระบบ intranet ล้วน)
 db/schema.ts          ← ตาราง + JSONB types + DTO + mapper toDTO
 db/index.ts           ← postgres.js + drizzle (DATABASE_URL → container judes-note-db, prepare:false)
-middleware.ts         ← บังคับ login ทุกหน้า — ไม่มี cookie oacCase ที่ parse ได้ = redirect /note/login (path ที่ตัด basePath แล้ว: หน้าขึ้นต้น /note/… ส่วน API ขึ้นต้น /api/note/… — ยกเว้น note/login, api/note/*, api/template/* (กลุ่ม docx template เปิดกว้างให้ทางศาล/ผู้ทดสอบภายนอกยิงได้เลย — ไม่แตะ DB), api/documents/* (กลุ่ม docver จัด version เอกสาร — stand-alone ไม่มี session ใช้ auth ของกลุ่มเอง: ขอ access_token ผ่าน x-api-key แล้วแนบ Bearer ทุก endpoint, docs/PLAN-DOCVER.md), api/swagger/* (หน้า Swagger UI), wordaddin/* (taskpane ของ Word add-in — auth mock ของตัวเอง), note/uploads/*, note/samples, note/swagger-ui/*, note/pdf.worker.min.mjs, _next, fonts, favicon และ **root "/" เอง** (matcher ใช้ `.+` — root เป็น redirect สู่ /wordaddin ซึ่ง public ตามคำขอผู้ใช้ 2026-10-14, ลิงก์ e-Court N8 ที่ root ยังถูกคุมผ่าน /note ที่รับส่งต่อ))
+middleware.ts         ← บังคับ login ทุกหน้า — ไม่มี cookie oacCase ที่ parse ได้ = redirect /note/login (path ที่ตัด basePath แล้ว: หน้าขึ้นต้น /note/… ส่วน API ขึ้นต้น /api/note/… — ยกเว้น note/login, api/note/*, api/template/* (กลุ่ม docx template เปิดกว้างให้ทางศาล/ผู้ทดสอบภายนอกยิงได้เลย — ไม่แตะ DB), api/swagger/* (หน้า Swagger UI), wordaddin/* (taskpane ของ Word add-in — auth mock ของตัวเอง), note/uploads/*, note/samples, note/swagger-ui/*, note/pdf.worker.min.mjs, _next, fonts, favicon และ **root "/" เอง** (matcher ใช้ `.+` — root เป็น redirect สู่ /wordaddin ซึ่ง public ตามคำขอผู้ใช้ 2026-10-14, ลิงก์ e-Court N8 ที่ root ยังถูกคุมผ่าน /note ที่รับส่งต่อ))
 lib/annotate-events.ts ← pub/sub in-process (actions publish → SSE route subscribe)
 lib/server-pdf.ts     ← path guard อ่าน PDF จาก public/note/ (export ใช้)
 lib/session.ts        ← getSessionUser — identity จาก cookie oacCase (mock login e-Court)
@@ -49,18 +47,11 @@ lib/external-import.ts ← N8 registerExternalFile — ลงทะเบีย
 lib/remote-file.ts    ← N8 ดึงไฟล์รีโมตจาก allowlist (validate ซ้ำหลัง redirect + จำกัด 100MB + timeout 60s — /api/note/pdf กับ export ใช้ร่วม)
 lib/external-api-auth.ts ← N10 auth ของ /api/note/external/* — requireExternalApiKey เทียบ header `x-api-key` กับ env `EXTERNAL_API_KEY` ด้วย SHA-256 + crypto.timingSafeEqual (env ไม่ตั้ง/ว่าง = 401 fail closed ทุก request; ข้อความ 401 อันเดียวกันทั้งไม่ใส่/key ผิด กัน enumerate; ห้าม log ค่า key/header ดิบ) + externalApiError สร้าง Response ผิดพลาด JSON {"error": ไทย} ใช้ร่วมทุก route ของ N10 — **module นี้ห้าม import อะไรที่ลาก @/db มาด้วย** (db/index.ts throw ตอน import เมื่อไม่มี DATABASE_URL — unit test tests/lib/external-api-auth.test.ts ต้องรันได้โดยไม่แตะ DB)
 lib/external-api.ts   ← N10 ส่วนกลางของ route — parseQueryBody (validate JSON body ของ /api/note/external/documents: รับเฉพาะ fileId/typeId/filter, ต้องมี fileId หรือ typeId อย่างน้อยหนึ่งอย่าง — ส่งทั้งคู่ได้ = AND เหลือเฉพาะเอกสารเดียวที่ตรงทั้งสองเงื่อนไข, คำขอผู้ใช้ 2026-09-25 (รอบเดียวกันเคยเป็น OR แล้วเปลี่ยนหลังทดสอบจริง), filter รับเฉพาะ type ∈ bookmarks|annotations ไม่ส่ง = ทั้งสอง + userId (string|array กรองตามเจ้าของรายการ annotations+bookmarks) + annotationTypes (ค่า enum annotation_type เฉพาะ annotations ค่าอื่น = 400 — เดิมชื่อ types เปลี่ยน 2026-09-25) — คืน discriminated mode "file" (fileId + typeId อาจมาด้วย) / "type" (typeId เดี่ยว)) + loadDocumentBundles(fileRows, parts) (bulk: inArray ทุกไฟล์ในชุด query เดียว = 3 query ต่อ request ไม่ว่ากลุ่มกี่ไฟล์ แทนยิง 3 query ต่อไฟล์พร้อมกันทั้งกลุ่ม, code review 2026-09-25 — กรอง userIds/annotationTypes ใน SQL; คืน bundle ยุบชั้น: field เอกสาร + annotations + bookmarks ระดับเดียวกัน ไม่มี object document ซ้อน; ต่อรายการมี `url` deep link F12 กลับหน้า `/annotate/[id]` — annotation `?ann=<id>` / bookmark `?page=<หน้า 1-based>` — URL เต็ม: origin จาก request ผู้เรียก (route อ่าน x-forwarded-proto/host แล้ว fallback host ตรง ส่งเข้าทาง parameter origin) + basePath ผ่าน withBasePath, คำขอผู้ใช้ 2026-09-25) + type ExternalDocumentDTO (externalFileId เป็น null สำหรับไฟล์ url:-fallback/อัปโหลด N4 ในกลุ่ม)
-lib/openapi.ts        ← OpenAPI 3.0 spec ของ API ทดสอบ (กลุ่ม template + N10 + docver — 2026-10-06) — แหล่งเดียวของ Swagger UI: GET /api/template inline ลง HTML ตรง ๆ ไม่มี endpoint spec แยก; URL ใน paths เป็น path เต็ม /api/… (servers เติมแค่ basePath ตาม invariant #12) — แก้ contract ของ API ต้องมาแก้ไฟล์นี้ให้ตรงด้วย
+lib/openapi.ts        ← OpenAPI 3.0 spec ของ API ทดสอบ (กลุ่ม template + N10 — 2026-10-06) — แหล่งเดียวของ Swagger UI: GET /api/template inline ลง HTML ตรง ๆ ไม่มี endpoint spec แยก; URL ใน paths เป็น path เต็ม /api/… (servers เติมแค่ basePath ตาม invariant #12) — แก้ contract ของ API ต้องมาแก้ไฟล์นี้ให้ตรงด้วย
-lib/document-versioning.ts ← docver pure validation (ห้าม import อะไรที่ลาก @/db หรือ minio มาด้วย — unit test tests/lib/document-versioning.test.ts ต้องรันได้เหมือน lib/external-api-auth.ts): parseVersionUploadForm (allowlist field — identity ไม่รับจาก form แล้ว แกะจาก token ผ่าน lib/docver-token.ts + fields JSON ≤100 keys + message ≤2048), isDocxBytes/isPdfBytes (magic bytes), parseDownloadFormat/parseVersionIdParam, contentDispositionValue (ASCII fallback + filename*=UTF-8'') + docverError สร้าง Response JSON {"error": ไทย} ใช้ร่วมทุก route ของกลุ่ม (parseDocId ถอดแล้ว 2026-10-26 — docId ไม่มาจาก path param)
-lib/docver-token.ts   ← docver token + auth ของกลุ่ม /api/documents/* (2026-10-22 — pure module ห้าม import อะไรที่ลาก @/db หรือ minio มาด้วย เหมือน lib/document-versioning.ts; unit test tests/lib/docver-token.test.ts ต้องรันได้โดยไม่ต้องตั้ง env): issueDocverToken/verifyDocverToken (JWT HS256 มือเขียน node:crypto ล้วน — บังคับ alg=HS256 กัน alg-confusion, timingSafeEqual หลัง hash ทั้งสองฝั่ง, exp บังคับ) + requireDocverApiKey (header x-api-key เทียบ env DOCVER_API_KEY — fail closed 401 ไม่ตั้ง/ว่าง, 401 เดียวกันทั้งไม่ใส่/ผิด กัน enumerate, ห้าม log ค่า key/header ดิบ) + requireDocverBearer (Authorization: Bearer → claims {userid, username, fid, template} — secret จาก env DOCVER_TOKEN_SECRET ไม่ตั้ง = 401, ทุกกรณี 401 ข้อความเดียวกัน) + parseTokenRequestBody (allowlist userid/username/fid/template — **fid = fileId ของ e-Court (string, บังคับ 2026-10-26)** เป็น docId ของทุก operation ตรง ๆ · verify ไม่รับ token ที่ไม่มี fid)
-lib/docver-store.ts   ← docver server-side MinIO + DB (env MINIO_* อ่านตอนเรียกไม่ใช่ module load; client + cached ensureBucket เก็บบน globalThis แบบ db/index.ts): object key `docver/<versionId>/document.docx|pdf` (uuid ล้วน ไม่มี input ผู้ใช้), putVersionObjects (docx ก่อน — pdf ล้ม = ลบ docx คืนแล้วโยนต่อ), removeVersionObjects (best-effort), presignVersionUrl (TTL env DOCVER_LINK_TTL_SECONDS), insertVersionRecord (**tx เดียว**: upsert documents ON CONFLICT DO NOTHING → SELECT id FOR UPDATE → max(versionNumber)+1 → insert — จ่ายเลข version ปลอดภัยเรียกคู่ขนาน, UNIQUE(document_id, version_number) เป็น safety net)
 wordaddin/            ← **client-only zone ของ Word add-in** (ห้าม import จาก lib/ หรือถูก import โดย server component — พอร์ตดิบจาก D:\word-addin-poc\addin\src, spec: docs/addin-ui-flow.md, คู่มือ dev: docs/WORDADDIN-DEV.md)
 wordaddin/config.ts   ← env NEXT_PUBLIC_ADDIN_API_BASE_URL ("" = ยังไม่ต่อ backend จริง) + NEXT_PUBLIC_ADDIN_MOCK_USERNAME (mock auth)
 wordaddin/models/versionRecord.ts ← types VersionRecord/FieldsSnapshot + readSnapshotField (พอร์ตดิบ)
-<<<<<<< HEAD
+wordaddin/services/   ← documentService/fileService/metadataService/autoSaveService/versionFlow/apiClient/errors พอร์ตดิบทั้งไฟล์ · **authService = MOCK** (login ผ่านทันที คง surface เดิมครบไว้สลับของจริง — ต้นฉบับ Keycloak PKCE อยู่ที่ D:\word-addin-poc\addin + **`signInFromDocument` e-Court pass-through 2026-10-16: ไฟล์ที่ stamp custom properties `token`/`owner` มา (`readTrackedProperties` อ่านรวม) = `detect()` ของ TaskpaneApp ผ่านเข้าเลยไม่ต้องกด login — username จาก owner → uid ใน JWT → mockUsername, token ไฟล์เก็บ memory ให้ getAccessToken ใช้ต่อ**) · **versioningService = MOCK** (memory + **metadata persist ลง localStorage ต่อ documentId** เพื่อทดสอบวงปิดเอกสาร→เปิดใหม่ได้ — blob ไฟล์จริงเฉพาะ session; คงชื่อ/ลายเซ็น uploadVersion/getVersions/getDownloadLink/newClientVersionId เป๊ะ, download-link คืน about:blank)
-wordaddin/services/   ← documentService/fileService/metadataService/autoSaveService/versionFlow/apiClient/errors พอร์ตดิบทั้งไฟล์ · **authService = MOCK** (login ผ่านทันที คง surface เดิมครบไว้สลับของจริง — ต้นฉบับ Keycloak PKCE อยู่ที่ D:\word-addin-poc\addin + **`signInFromDocument` e-Court pass-through 2026-10-16: ไฟล์ที่ stamp custom properties `token`/`owner` มา (`readTrackedProperties` อ่านรวม) = `detect()` ของ TaskpaneApp ผ่านเข้าเลยไม่ต้องกด login — username จาก owner → uid ใน JWT → mockUsername, token ไฟล์เก็บ memory ให้ getAccessToken ใช้ต่อ**) · **versioningService = MOCK** (memory + **metadata persist ลง localStorage ต่อ documentId** เพื่อทดสอบวงปิดเอกสาร→เปิดใหม่ได้ — blob ไฟล์จริงเฉพาะ session; คงชื่อ/ลายเซ็น uploadVersion/getVersions/getDownloadLink/newClientVersionId เป๊ะ, download-link คืน about:blank — **backend จริงของ surface นี้มีแล้ว**: กลุ่ม `app/api/documents/**` (docver, docs/PLAN-DOCVER.md — สลับ mock ด้วยการตั้ง `NEXT_PUBLIC_ADDIN_API_BASE_URL`)
-=======
-wordaddin/services/   ← documentService/fileService/metadataService/autoSaveService/versionFlow/apiClient/errors พอร์ตดิบทั้งไฟล์ + **templateService** (แท็บที่ 2 "เครื่องมือ Template" 2026-10-19 — list/select/applyTestValues + แทรกย่อหน้า-ตัวแบ่งบรรทัด-ตัวแบ่งหน้า ที่ cursor (page break มี fallback OOXML กัน E_FAIL), Office.js ล้วน — ⚠️ `contentControls` ธรรมดาเห็นเฉพาะ rich text CC: feature-detect WordApi 1.5 ใช้ `getContentControls()` เห็นทุกชนิด, ห้าม top-level Office access) · **authService = MOCK** (login ผ่านทันที คง surface เดิมครบไว้สลับของจริง — ต้นฉบับ Keycloak PKCE อยู่ที่ D:\word-addin-poc\addin + **`signInFromDocument` e-Court pass-through 2026-10-16: ไฟล์ที่ stamp custom properties `token`/`owner` มา (`readTrackedProperties` อ่านรวม) = `detect()` ของ TaskpaneApp ผ่านเข้าเลยไม่ต้องกด login — username จาก owner → uid ใน JWT → mockUsername, token ไฟล์เก็บ memory ให้ getAccessToken ใช้ต่อ**) · **versioningService = MOCK** (memory + **metadata persist ลง localStorage ต่อ documentId** เพื่อทดสอบวงปิดเอกสาร→เปิดใหม่ได้ — blob ไฟล์จริงเฉพาะ session; คงชื่อ/ลายเซ็น uploadVersion/getVersions/getDownloadLink/newClientVersionId เป๊ะ, download-link คืน about:blank)
->>>>>>> 6daee1585199721ba931b2bf4fe55277cb7c304a
 utils/coordinates.ts  ← pixel⇄% + getPointerPercent + clamp + mergeRectsByLine
 utils/geometry.ts     ← bbox/translate/scale/hitTestPath ของ annotation (pure, หน่วย %)
 utils/annotation-display.ts ← label/ข้อความย่อต่อชนิด + TYPE_SHORT/TYPE_ORDER ชื่อย่อ/ลำดับชนิด (บรรทัดสรุปหน้าของหน้าสรุป + แผงตัวกรอง explorer — ย้ายจาก 2 ที่ซ้ำกันมารวมที่นี่ 2026-09-24) + ค่า default TEXTBOX/STAMP + describeAnnotationChange สรุปสิ่งที่เปลี่ยนของ version history F19 (sidebar/สรุป/groups/CSV ใช้ร่วม)
@@ -83,7 +74,6 @@ app/api/note/annotations/export/route.ts     ← export PDF ฝัง annotation
 app/api/note/external/documents/route.ts  ← N10 API ภายนอกเส้นเดียว (POST + JSON body {fileId และ/หรือ typeId, filter:{type, userId, annotationTypes}} — auth ผ่าน requireExternalApiKey ก่อนแตะ DB, ถาม fileId = ค้น files.external_id = "ecourt:<fileId>" ไม่เจอ 404 แม้ส่ง typeId มาด้วย / ถาม typeId = ทุกไฟล์ในกลุ่ม กลุ่มว่าง = 200 documents:[] / ส่งทั้งคู่ = AND กรอง externalId+typeId ใน query เดียว เหลือเอกสารเดียว ไม่ตรงคู่ = 404 แยกสาเหตุในข้อความ (2026-09-25 เดิมเคยเป็น OR แล้วเป็น 400); response รูปเดียว {documents:[bundle…]} ผ่าน loadDocumentBundles ทั้งสอง mode; ครอบ try/catch ทุก DB call — ล้ม = log ฝั่ง server + 500 JSON ตาม contract ไม่ปล่อยเป็น 500 ของ framework; read-only ไม่ publish SSE ไม่ revalidatePath — snapshot ณ ตอนเรียก)
 app/api/swagger/route.ts ← **GET /api/swagger = หน้า Swagger UI** (2026-10-06 — document ของ API ทุกกลุ่ม: spec inline จาก lib/openapi.ts + asset จาก public/note/swagger-ui/ ของ postinstall scripts/copy-swagger-ui.mjs, persistAuthorization เก็บ x-api-key ไว้ใช้ข้าม reload — เปิดกว้างไม่ต้อง login)
 app/api/template/{test,extract,render}/route.ts ← กลุ่ม API docx template ของ wordaddin (WIP — GET test ตรวจ service / POST extract ดึงค่า Content Control / POST render = template(.docx)+data(JSON ไฟล์หรือ field dataJson) คืน .docx ใหม่; logic รวมอยู่ app/api/template/lib-tmpl.ts เป็นแชร์ไลบรารี pizzip+xpath; ไฟล์ทดสอบ/โน้ตอยู่ app/api/template/test/ — ไม่แตะ DB, URL /docedit/api/template/…)
-app/api/documents/token/route.ts + versions/route.ts + versions/[versionId]/download-link/route.ts ← **กลุ่ม API docver จัด version เอกสาร** (docs/PLAN-DOCVER.md — URL /docedit/api/documents/…, auth ของกลุ่มเอง 2026-10-22: POST token ขอ access_token ด้วย header `x-api-key` + env `DOCVER_API_KEY` (lib/docver-token.ts — fail closed 401 ไม่ตั้ง/ว่าง เหมือน N10) แล้ว **endpoint ที่เหลือทุกตัวบังคับ `Authorization: Bearer`** JWT HS256 เซ็นด้วย env `DOCVER_TOKEN_SECRET` (TTL `DOCVER_TOKEN_TTL_SECONDS` default 3600) — identity userid/username + templateId แกะจาก claims ไม่รับจาก request อีกต่อไป; ส่ง userId/userName/templateId ใน form = 400 ไม่รู้จัก field · **2026-10-26 ถอด segment `[docId]` ออกจาก URL ทุก endpoint — docId = claim `fid` (string) จาก token ตรง ๆ (บังคับตั้งแต่ขอ token)**): POST versions = multipart `file`(.docx บังคับ ≤100MB เช็ค size ก่อน buffer → 413)+`pdf`(optional ไฟล์เปล่า = ไม่มี)+fields/message/clientVersionId/fileName → สร้างเอกสารอัตโนมัติถ้า docId ใหม่, MinIO ก่อน DB (DB ล้มหลัง put = เก็บกวาด object แบบ N4) → `{hasPdf, versionId, versionNumber}` (เลขจาก server เป็นค่าจริง) / GET versions = DocumentVersionDTO[] ใหม่→เก่า (ไม่เคยมี docId = 404) / GET download-link?format=docx|pdf = presigned URL อายุสั้น (เช็ค docId+versionId คู่กันกันโยน id ข้ามเอกสาร; ขอ pdf ที่ version ไม่มี = 404) — carve-out invariant #4: ไม่ publish SSE ไม่ revalidatePath
 app/note/uploads/[name]/route.ts     ← เสิร์ฟไฟล์อัปโหลดจาก public/note/uploads/ (N4 — Next production เห็นไฟล์ static เฉพาะที่มีตอน startup ไฟล์ที่เขียน runtime ต้องเสิร์ฟผ่าน route)
 app/note/page.tsx                    ← รายการไฟล์จัด section ตามกลุ่ม type_id + "ไม่มีกลุ่ม" ท้ายสุด (N9 — server component)
 app/note/groups/[typeId]/page.tsx    ← N9 หน้าเอกสารในกลุ่ม (server component force-dynamic — files where type_id orderBy createdAt, ไม่มี = 404; ~~หมายเหตุ "แสดงเฉพาะเอกสารที่เคยเปิดในระบบนี้"~~ ถอดออกตามคำขอผู้ใช้ 2026-09-24; **redesign 2026-09-24 ตามคำขอผู้ใช้: ไม่มี navbar** — explorer 2 คอลัมน์ ตัวกรองซ้าย + list เดียวรวม bookmark+annotation ทั้งกลุ่มไม่แยกไฟล์: query ทั้งหมดฝั่ง server แล้วส่ง `GroupFileSummary[]` + `GroupListItem[]` (เรียง ไฟล์ตาม createdAt → หน้า → bookmark ก่อน annotation → createdAt) ให้ `GroupExplorer` กรองใน memory, แถวรายการ deep link `?ann=`/`?page=` เหมือนหน้าสรุป F12 + ไฟล์ที่มาต้น meta line)
@@ -93,7 +83,7 @@ app/note/annotate/[id]/summary/page.tsx ← หน้าสรุป Annotation+
 app/wordaddin/layout.tsx + page.tsx   ← taskpane ของ Word add-in (URL `/docedit/wordaddin` — nested layout แรกของ repo override title แท็บ browser; page เป็น server component บาง ๆ render WordAddinGate ทั้งหมดฝั่ง client)
 app/wordaddin/manifest.xml/route.ts ← GET serve manifest ของ add-in พร้อม rewrite origin ตามโฮสต์ที่ขอ (template `public/wordaddin/manifest.template.xml` ค่า dev — dev/UAT/production โหลด manifest.xml ขอ environment ตัวเองแล้วใช้ได้เลย ไม่ต้อง rewrite มือ; origin จาก `utils/request-origin.ts` แชร์กับ deep link N10 — x-forwarded-proto/host ก่อน fallback host ตรง + บังคับ https โฮสต์ที่ไม่ใช่ localhost เพราะ Office รับ https เท่านั้น)
 components/wordaddin/WordAddinGate.tsx ← client gate: ฉีด script office.js self-host (ผ่าน withBasePath "/wordaddin/office-js/office.js") → Office.onReady → mount TaskpaneApp · `?addindemo=untracked|tracking` (dev-only) ข้าม office.js + mock sign in + ตั้ง phase ตรง เพื่อดู UI ใน browser ธรรมดา — flow ที่แตะ Word จริงจะจบที่ error ตาม expected (FR-17: ใน browser ปกติ banner auto-save error โผล่หลัง ~30 วิ — ถูกต้อง)
-components/wordaddin/TaskpaneApp.tsx ← state machine checking/signed-out/untracked/tracking + handler ทุกตัว พอร์ตจาก App.tsx ต้นฉบับ (state/handlers คงเดิม เปลี่ยนแค่ JSX → Genesis) · SaveControls/MessageBar/Spinner/ConfirmVersionDialog(portal แบบ AnnotationSidebar)/VersionHistoryPanel · **2 แท็บ (Versioning / เครื่องมือ Template — toggle `aria-pressed` เฉพาะ phase untracked|tracking, 2026-10-19): แท็บ template = TemplateToolsPanel (สแกน CC/กรอกค่าทดสอบ/แทรกย่อหน้า-ตัวแบ่ง — spec ที่ docs/addin-ui-flow.md §10)**
+components/wordaddin/TaskpaneApp.tsx ← state machine checking/signed-out/untracked/tracking + handler ทุกตัว พอร์ตจาก App.tsx ต้นฉบับ (state/handlers คงเดิม เปลี่ยนแค่ JSX → Genesis) · SaveControls/MessageBar/Spinner/ConfirmVersionDialog(portal แบบ AnnotationSidebar)/VersionHistoryPanel
 components/summary/SummaryExplorer.tsx ← client root ของหน้าสรุป (redesign 2026-09-24) — state ตัวกรอง `FacetFilterState` จากแผงกลาง explorer + กรองใน memory + facet count/static users derive เอง + มิติ "หน้า" เป็นตัวเลือกแบบ single-select เฉพาะหน้าที่มีรายการ ≥1 เรียงน้อย→มาก (`optionsScroll` ให้ scroll ภายในกลุ่ม max-h-64 กันหน้าเยอะดันกลุ่มอื่นออกจอ) + layout 2 คอลัมน์ (มือถือ < lg ตัวกรองหุบเป็น `<details>`, desktop aside sticky 15rem — pattern เดียวกับ GroupExplorer; คอลัมน์ content ครอบด้วย `<div>` ไม่ใช่ `<section>` เพราะกฎ print break-inside ของ `main.summary-page section` มุ่งการ์ดรายหน้าข้างใน)
 components/summary/SummaryList.tsx ← คอลัมน์ content ของหน้าสรุป — การ์ดรายหน้า "1 หน้า 1 การ์ด" หัวการ์ด sticky ระดับ viewport (เลขหน้า + บรรทัดสรุปหน้า `pageSummaryLine` **คำนวณจากรายการที่เห็นจริงหลังกรอง** + ปุ่ม "เปิดหน้านี้"; กลับเป็น position static ตอนพิมพ์ผ่านกฎ `.page-head` ใน globals.css) + แถว passive จุดคลิกเดียวคือปุ่ม `<Link>` "View" เหมือน GroupList (deep link `?ann=`/`?page=` — bookmark ไปหน้า, annotation ไปรายการ; meta line ไม่มี segment ไฟล์เพราะไฟล์เดียวทั้งหน้า) + header "พบ N รายการ" (aria-live) + ปุ่ม "ล้างตัวกรอง" (เฉพาะมีตัวกรอง active) + empty state กรองจนไม่เหลือ + **ตอนพิมพ์แสดงฉบับเต็มเสมอ** — ตัวกรองที่ตั้งค้างต้องไม่ตัดรายการออกเงียบ ๆ บนกระดาษ: ตอน activeCount > 0 render ชุดบนจอ (print:hidden) + ชุดเต็ม (hidden print:block, ไม่มี id/aria-labelledby ซ้ำ) แยกกัน; anchor `#page-N` ของ section คงจาก design เดิมให้ลิงก์เก่ายังใช้ได้
 components/pdf/PDFViewer.tsx        ← client root (tool state, zoom, selection, lazy render หน้า)

README.md

@@ -19,7 +19,7 @@
 | เครื่องมือ | เวอร์ชันที่ใช้พัฒนา/ทดสอบ | หมายเหตุ |
 |---|---|---|
 | Node.js | v24.3.0 | ≥ 20 น่าจะใช้ได้ |
-| Docker | 29.1.3 | ใช้รัน PostgreSQL + MinIO ผ่าน `docker-compose.yml` |
+| Docker | 29.1.3 | ใช้รัน PostgreSQL container ตัวเดียว |
 
 ## ขั้นตอน Setup จากศูนย์
 
@@ -31,16 +31,17 @@ npm install
 
 > postinstall จะคัดลอก `pdf.worker.min.mjs` จาก `node_modules/pdfjs-dist/build/` มาไว้ที่ `public/` ให้อัตโนมัติ
 
-### 2. รัน PostgreSQL + MinIO ด้วย docker compose
+### 2. รัน PostgreSQL container
 
 ```bash
-docker compose up -d
+docker run -d --name judes-note-db \
+  -e POSTGRES_USER=postgres -e POSTGRES_PASSWORD=postgres -e POSTGRES_DB=postgres \
+  -p 54322:5432 \
+  -v judes-note-db-data:/var/lib/postgresql/data \
+  postgres:17-alpine
 ```
 
-- `db` = PostgreSQL (`judes-note-db` พอร์ต 54322, database `ecourt-note` สร้างตอน first init) — ใช้ชื่อ container/วอลุ่มเดียวกับคำสั่ง `docker run` เดิม: ถ้ามี container เก่าจาก `docker run` อยู่ ให้ `docker rm -f judes-note-db` ก่อน (วอลุ่ม `judes-note-db-data` เดิม ข้อมูลไม่หาย — ถ้าวอลุ่มเดิม init ด้วย database `postgres` ให้สร้าง `ecourt-note` เอง: `docker exec judes-note-db psql -U postgres -c 'CREATE DATABASE "ecourt-note"'`) · จะรันแค่ MinIO ก็ได้ด้วย `docker compose up -d minio`
+ครั้งต่อไปแค่ `docker start judes-note-db` — ข้อมูลอยู่ใน volume `judes-note-db-data` ไม่หาย
-- `minio` = object storage ของ API เอกสาร versioning (`judes-note-minio` — API ที่ **พอร์ตโฮสต์ 19000**, console ดูผ่าน browser ที่ http://localhost:19001; ข้างใน container ยังเป็น 9000/9001 — host เลี่ยงมา 19000/19001 เพราะ 9000/9001 มักชนกับ service อื่นในเครื่อง dev; image ดึงจาก `quay.io/minio/minio` ซึ่งเป็น registry ทางการของ MinIO) — bucket ไม่ต้องสร้างเอง app สร้างตอน first use
-
-ครั้งต่อไปแค่ `docker compose start` — ข้อมูลอยู่ใน volume `judes-note-db-data`/`judes-note-minio-data` ไม่หาย
 
 ### 3. สร้างไฟล์ `.env`
 
@@ -49,12 +50,6 @@ DATABASE_URL=postgresql://postgres:postgres@127.0.0.1:54322/ecourt-note
 # N10 (optional): API key ของ /api/note/external/* สำหรับ backend e-Court เรียกแบบ server-to-server
 # ไม่ตั้งหรือเว้นว่าง = API ปฏิเสธทุก request (fail closed) — ตั้งค่ายาวและสุ่ม เช่น 32+ ตัวอักษร
 # EXTERNAL_API_KEY=
-# MinIO ของ API เอกสาร versioning (ค่าตรง docker-compose.yml — ไม่ต้องแก้ถ้ารันตามขั้นตอน 2)
-MINIO_ENDPOINT=127.0.0.1
-MINIO_PORT=19000
-MINIO_USE_SSL=false
-MINIO_ACCESS_KEY=minioadmin
-MINIO_SECRET_KEY=minioadmin
 ```
 
 (เทียบกับ `.env.example`)
@@ -130,28 +125,6 @@ curl -X POST -H "x-api-key: $EXTERNAL_API_KEY" -H "content-type: application/jso
   "http://localhost:3000/docedit/api/note/external/documents"
 ```
 
-## API จัด version เอกสาร (docver — stand-alone)
-
-กลุ่ม API ให้ **Word add-in / ระบบภายนอก** เก็บเอกสารเป็น version: เอกสารเดียวต่อ `docId` (unique) แต่ละ version เก็บไฟล์ **.docx + .pdf ใน MinIO** พร้อม `userId`/`userName`/`createdAt` ของผู้อัปโหลด — **ไม่มี auth ไม่มี session** (stand-alone): ผู้เรียกบอก identity เองผ่าน field `userId`/`userName` ของ multipart · contract ตรง mock ของ wordaddin (`versioningService`) เป๊ะเพื่อวันสลับของจริง · สเปก/เหตุผล: `docs/PLAN-DOCVER.md`
-
-```bash
-# POST อัปโหลด version (เอกสารถูกสร้างแบบ implicit เมื่อเป็น version แรก)
-curl -F "file=@คำสั่งเรียก.docx" -F "pdf=@คำสั่งเรียก.pdf" \
-  -F "userId=u0001" -F "userName=ผู้พิพากษา ก." \
-  "http://localhost:3000/docedit/api/documents/CASE-2569-0001/versions"
-# → {"hasPdf":true,"versionId":"<uuid>","versionNumber":1}   (versionNumber เป็นค่าจาก server)
-
-# GET history (ใหม่ → เก่า) — docId ที่ยังไม่เคยมี version = 404
-curl "http://localhost:3000/docedit/api/documents/CASE-2569-0001/versions"
-
-# GET presigned URL อายุสั้น (default docx, ?format=pdf — version ไม่มี pdf = 404)
-curl "http://localhost:3000/docedit/api/documents/CASE-2569-0001/versions/<versionId>/download-link?format=pdf"
-```
-
-- ไฟล์แนบ `file` (.docx) บังคับ · `pdf` optional (add-in แนบ blob เปล่าได้ = ถือว่าไม่มี ดู `hasPdf`) · ทั้งคู่ ≤ 100MB + ตรวจ magic bytes · field นอก allowlist = 400 กัน typo เงียบ ๆ
-- error ทุกสถานะเป็น JSON `{ "error": "<ข้อความไทย>" }` — 400 (รูปผิด/ไม่ใช่ multipart/เนื้อไฟล์เพี้ยน) · 413 (เกิน 100MB) · 404 (ไม่มีเอกสาร/version/pdf) · 500 (MinIO env ไม่ตั้ง/ล้ม, DB ล้ม — log เต็มฝั่ง server)
-- **presigned URL อ้าง `MINIO_ENDPOINT:MINIO_PORT` ตรง ๆ** — production ต้องเป็นโฮสต์ที่เบราว์เซอร์ของผู้ใช้เข้าถึงได้ ไม่ใช่แค่ที่ Next server เข้าถึงได้
-
 ## Troubleshooting
 
 | อาการ | สาเหตุ/ทางแก้ |
@@ -159,8 +132,7 @@ curl "http://localhost:3000/docedit/api/documents/CASE-2569-0001/versions/<versi
 | Realtime ไม่ซิงก์ | sync ใช้ pub/sub **in-memory ของ process เดียว** — ทุกแท็บต้องเข้าผ่าน dev server เดียวกัน (ถ้าวันหนึ่งรันหลาย instance ต้องเพิ่ม Redis pub/sub หรือ Postgres LISTEN/NOTIFY ก่อน) |
 | หน้าเว็บ 500 หลังรัน `next build` ระหว่างที่ dev server กำลังรัน | build เขียนทับ cache ของ dev — ปิด dev server ก่อน build หรือ restart dev server หลัง build |
 | `tsc --noEmit` error ชี้ route ที่ถูกลบไปแล้ว (เช่น `app/api/external/document*` หลังรวมเป็น `query` รอบสองของ N10) | type stub ค้างใน `.next/types/` ของ dev/build รอบก่อน — ลบ `.next` หรือรัน `next build`/restart dev server หนึ่งครั้งให้ regenerate แล้วรันใหม่ |
-| ต่อ DB ไม่ได้ | ตรวจว่า container รันอยู่ (`docker compose start db` — เดิม `docker start judes-note-db`) และพอร์ต 54322 ไม่ถูกใช้โดย container อื่น |
+| ต่อ DB ไม่ได้ | ตรวจว่า container รันอยู่ (`docker start judes-note-db`) และพอร์ต 54322 ไม่ถูกใช้โดย container อื่น |
-| API เอกสาร versioning ตอบ 500 ทุก call | ตรวจ env `MINIO_ENDPOINT`/`MINIO_ACCESS_KEY`/`MINIO_SECRET_KEY` และ container minio (`docker compose start minio`) — รายละเอียดอยู่ใน log ฝั่ง server |
 | Highlight ใช้ไม่ได้กับไฟล์คดีตัวอย่าง | ไฟล์ `01012-*.pdf` ทั้งสองเป็น**ภาพสแกนล้วน** (ไม่มี text layer) — ใช้ `dashboard-report-2026-09-03.pdf` ซึ่งเป็น text-based PDF แทน จึงจะคลุมดำได้ (DRAW/COMMENT/BOOKMARK ใช้ได้ปกติกับทุกไฟล์) |
 
 ## หมายเหตุทางเทคนิค
@@ -176,14 +148,11 @@ curl "http://localhost:3000/docedit/api/documents/CASE-2569-0001/versions/<versi
 db/schema.ts              ตาราง + JSONB strict union + DTO + toDTO
 db/index.ts               postgres.js + drizzle (prepare: false)
 lib/annotate-events.ts    pub/sub in-process (actions → SSE route)
-lib/document-versioning.ts  validation ล้วนของกลุ่ม /api/documents (docver)
-lib/docver-store.ts       MinIO client + tx จ่ายเลข version + query ของ docver
 utils/coordinates.ts      px ⇄ % + clamp + mergeRectsByLine
 utils/user.ts             parse/build cookie oacCase (mock login e-Court)
 hooks/useAnnotationRealtime.ts   EventSource รับ SSE event + dedupe ด้วย id
 app/actions/annotations.ts       Server Actions CRUD + publish event (ทางเขียนทางเดียว)
 app/api/note/annotations/stream/route.ts  SSE endpoint (GET ?fileId=)
-app/api/documents/[docId]/versions/       API จัด version เอกสาร (POST/GET + download-link)
 app/note/page.tsx              รายการไฟล์ + ฟอร์มอัปโหลด (N4)
 app/note/annotate/[id]/page.tsx  โหลด file + initial data → PDFViewer
 components/pdf/           PDFViewer (root + virtualization), InkLayer, HighlightToolbar

app/api/documents/token/route.ts

@@ -1,51 +0,0 @@
-// PLAN-DOCVER.md §auth — POST /api/documents/token ออก access_token ของกลุ่ม docver
-// ยืนยันด้วย header "x-api-key" เทียบ env DOCVER_API_KEY (fail closed เมื่อ env ไม่
-// ตั้ง/ว่าง) — token เป็น JWT HS256 เซ็นด้วย env DOCVER_TOKEN_SECRET อายุตาม env
-// DOCVER_TOKEN_TTL_SECONDS (default 3600) แล้วนำไปแนบ Authorization: Bearer กับ
-// endpoint อื่นของกลุ่ม (lib/docver-token.ts) · segment คงที่ "token" ไม่ชน [docId]
-// (Next ให้ static ชนะ) และ middleware ยกเว้น api/documents/* อยู่แล้ว
-import { docverError } from "@/lib/document-versioning";
-import {
-  issueDocverToken,
-  parseTokenRequestBody,
-  requireDocverApiKey,
-} from "@/lib/docver-token";
-
-export const runtime = "nodejs";
-export const dynamic = "force-dynamic";
-
-export async function POST(request: Request) {
-  const apiKeyFail = requireDocverApiKey(request);
-  if (apiKeyFail !== null) return apiKeyFail;
-
-  let raw: unknown;
-  try {
-    raw = await request.json();
-  } catch {
-    return docverError("body ต้องเป็น JSON", 400);
-  }
-  const parsed = parseTokenRequestBody(raw);
-  if (!parsed.ok) return docverError(parsed.error, 400);
-
-  // ความผิด config ฝั่ง server ไม่ใช่ความผิดของผู้เรียก — ไม่ตั้ง = 500 (ห้าม log ค่า secret)
-  const secret = process.env.DOCVER_TOKEN_SECRET?.trim();
-  // const secret =
-  //   "487023dd1c1c4d6a07475e96b1cc300fec1e68ac9c2dd7d5ac9b1bf75da1053e";
-
-  if (secret === undefined || secret === "") {
-    return docverError("DOCVER_TOKEN_SECRET ยังไม่ถูกตั้งค่า", 500);
-  }
-  const ttlRaw = Number(process.env.DOCVER_TOKEN_TTL_SECONDS);
-  const ttlSeconds =
-    Number.isFinite(ttlRaw) && ttlRaw > 0 ? Math.floor(ttlRaw) : 3600;
-
-  const accessToken = issueDocverToken(parsed.claims, secret, ttlSeconds);
-  return new Response(
-    JSON.stringify({
-      access_token: accessToken,
-      token_type: "Bearer",
-      expires_in: ttlSeconds,
-    }),
-    { headers: { "content-type": "application/json; charset=utf-8" } },
-  );
-}

app/api/documents/versions/[versionId]/download-link/route.ts

@@ -1,52 +0,0 @@
-// PLAN-DOCVER.md §1 — GET /api/documents/versions/{versionId}/download-link?format=docx|pdf
-// คืน presigned URL อายุสั้น (env DOCVER_LINK_TTL_SECONDS) ให้ UI เปิดในเบราว์เซอร์จริง
-// ของผู้ใช้ — เช็ค docId (จาก fid ใน token) กับ versionId คู่กันกันโยน id ข้ามเอกสาร
-// auth: Authorization: Bearer (access_token จาก POST /api/documents/token — ทุก endpoint ของกลุ่ม)
-import {
-  docverError,
-  parseDownloadFormat,
-  parseVersionIdParam,
-} from "@/lib/document-versioning";
-import { requireDocverBearer } from "@/lib/docver-token";
-import { findVersionForDoc, presignVersionUrl } from "@/lib/docver-store";
-
-export const runtime = "nodejs";
-export const dynamic = "force-dynamic";
-
-export async function GET(
-  request: Request,
-  { params }: { params: { versionId: string } },
-) {
-  const auth = requireDocverBearer(request);
-  if (!auth.ok) return auth.response;
-
-  // docId มาจาก fid ใน token — claim ถูกบังคับเป็น string ไม่ว่างตั้งแต่ขอ token + verify
-  const docId = auth.claims.fid;
-  const versionId = parseVersionIdParam(params.versionId);
-  if (!versionId.ok) return docverError(versionId.error, 400);
-  let format: string | null = null;
-  try {
-    format = new URL(request.url).searchParams.get("format");
-  } catch {
-    return docverError("URL ของ request ไม่ถูกต้อง", 400);
-  }
-  const parsedFormat = parseDownloadFormat(format);
-  if (!parsedFormat.ok) return docverError(parsedFormat.error, 400);
-
-  try {
-    const row = await findVersionForDoc(docId, versionId.versionId);
-    if (!row) {
-      return docverError("ไม่พบ version นี้ของเอกสาร", 404);
-    }
-    if (parsedFormat.format === "pdf" && row.pdfObjectKey === null) {
-      return docverError("version นี้ไม่มีสำเนา PDF", 404);
-    }
-    const link = await presignVersionUrl(row.id, parsedFormat.format);
-    return new Response(JSON.stringify(link), {
-      headers: { "content-type": "application/json; charset=utf-8" },
-    });
-  } catch (err) {
-    console.error("docver: สร้าง download link ล้ม", err);
-    return docverError("เกิดข้อผิดพลาดของระบบ โปรดลองใหม่อีกครั้ง", 500);
-  }
-}

app/api/documents/versions/route.ts

@@ -1,170 +0,0 @@
-// PLAN-DOCVER.md §1 — POST อัปโหลด version ใหม่ + GET history ของ /api/documents/versions
-// กลุ่ม API stand-alone ไม่มี session — auth ด้วย access_token ของกลุ่มนี้: ขอที่
-// POST /api/documents/token (ยืนยัน x-api-key กับ env DOCVER_API_KEY) แล้วแนบ
-// Authorization: Bearer ทุก request — identity (userid/username), templateId และ
-// docId (= fid — fileId ของ e-Court, string) แกะจาก claims ของ token ทั้งหมด
-// ไม่รับจาก URL/form อีก (lib/docver-token.ts)
-import { createHash, randomUUID } from "node:crypto";
-
-import { toDocumentVersionDTO } from "@/db/schema";
-import {
-  docverError,
-  DOCVER_MAX_UPLOAD_BYTES,
-  DOCX_CONTENT_TYPE,
-  isDocxBytes,
-  isPdfBytes,
-  parseVersionUploadForm,
-  sanitizeFilePartName,
-} from "@/lib/document-versioning";
-import { requireDocverBearer } from "@/lib/docver-token";
-import {
-  findDocumentByDocId,
-  insertVersionRecord,
-  listVersionsByDocId,
-  putVersionObjects,
-  removeVersionObjects,
-  versionObjectKeys,
-} from "@/lib/docver-store";
-
-export const runtime = "nodejs";
-export const dynamic = "force-dynamic";
-
-/** POST — อัปโหลด version ใหม่ (เอกสารสร้างแบบ implicit ถ้าเป็น version แรก)
- *  ลำดับ: Bearer token → validate text field ก่อนแตะไฟล์ → cap ขนาดก่อน buffer → magic bytes →
- *  putObject MinIO → insert DB (tx) — DB ล้ม = เก็บกวาด object (pattern N4)
- *  response = UploadVersionResult เป๊ะ โดย versionNumber เป็นค่า authoritative
- *  จาก server (client เดา latest+1 แล้วแก้เองเมื่ออัปโหลดชนกัน) */
-export async function POST(request: Request) {
-  const auth = requireDocverBearer(request);
-  if (!auth.ok) return auth.response;
-
-  // docId มาจาก fid ใน token — claim ถูกบังคับเป็น string ไม่ว่างตั้งแต่ขอ token + verify
-  const docId = auth.claims.fid;
-
-  let form: FormData;
-  try {
-    form = await request.formData();
-  } catch {
-    return docverError("body ต้องเป็น multipart/form-data", 400);
-  }
-
-  const parsed = parseVersionUploadForm(form);
-  if (!parsed.ok) return docverError(parsed.error, 400);
-
-  const file = form.get("file");
-  if (!(file instanceof File)) {
-    return docverError('ต้องแนบไฟล์ .docx ใน field "file"', 400);
-  }
-  if (file.size === 0) {
-    return docverError('ไฟล์ใน field "file" ว่าง (0 ไบต์)', 400);
-  }
-  // route handler ไม่ได้รับเคราะห์ bodySizeLimit ของ Server Actions — ต้องเช็คเองก่อน buffer
-  if (file.size > DOCVER_MAX_UPLOAD_BYTES) {
-    return docverError('ไฟล์ใน field "file" ใหญ่เกิน 100MB', 413);
-  }
-  if (file.type !== DOCX_CONTENT_TYPE && !file.name.toLowerCase().endsWith(".docx")) {
-    return docverError('field "file" ต้องเป็นไฟล์ .docx', 400);
-  }
-
-  // add-in อาจแนบ pdf เป็น blob เปล่าตอน capture ไม่สำเร็จ — ถือว่าไม่มี pdf (best-effort)
-  const rawPdf = form.get("pdf");
-  let pdf: File | null = null;
-  if (rawPdf instanceof File && rawPdf.size > 0) {
-    if (rawPdf.size > DOCVER_MAX_UPLOAD_BYTES) {
-      return docverError('ไฟล์ใน field "pdf" ใหญ่เกิน 100MB', 413);
-    }
-    pdf = rawPdf;
-  }
-
-  let docxBytes: Buffer;
-  let pdfBytes: Buffer | null = null;
-  try {
-    docxBytes = Buffer.from(await file.arrayBuffer());
-    pdfBytes = pdf ? Buffer.from(await pdf.arrayBuffer()) : null;
-  } catch (err) {
-    console.error("docver: อ่านไฟล์แนบเข้าหน่วยความจำไม่สำเร็จ", err);
-    return docverError("เกิดข้อผิดพลาดของระบบ โปรดลองใหม่อีกครั้ง", 500);
-  }
-  if (!isDocxBytes(docxBytes)) {
-    return docverError("เนื้อไฟล์ .docx ไม่ถูกต้อง (ไม่ใช่ OOXML/ZIP)", 400);
-  }
-  if (pdfBytes && !isPdfBytes(pdfBytes)) {
-    return docverError("เนื้อไฟล์ .pdf ไม่ถูกต้อง", 400);
-  }
-
-  const contentHash = createHash("sha256").update(docxBytes).digest("hex");
-  const versionId = randomUUID();
-  // ชื่อแสดงผลตอนดาวน์โหลด: field "fileName" ของผู้เรียก (add-in ส่งมาเอง) →
-  // ไม่ส่งค่อยใช้ชื่อของ File (ผ่าน decodeUploadFilename — undici ถอดชื่อไทยเป็น latin1)
-  const docxDisplayName =
-    parsed.form.fileName ?? sanitizeFilePartName(file.name);
-
-  try {
-    await putVersionObjects({
-      versionId,
-      docx: { bytes: docxBytes, fileName: docxDisplayName },
-      pdf: pdf ? { bytes: pdfBytes!, fileName: sanitizeFilePartName(pdf.name) } : undefined,
-    });
-  } catch (err) {
-    console.error("docver: เขียน object ลง MinIO ไม่สำเร็จ", err);
-    return docverError("เกิดข้อผิดพลาดของระบบ โปรดลองใหม่อีกครั้ง", 500);
-  }
-
-  const keys = versionObjectKeys(versionId);
-  let row;
-  try {
-    row = await insertVersionRecord({
-      versionId,
-      docId,
-      clientVersionId: parsed.form.clientVersionId,
-      contentHash,
-      message: parsed.form.message,
-      fields: parsed.form.fields,
-      templateId: auth.claims.template,
-      fileName: docxDisplayName,
-      docxObjectKey: keys.docx,
-      pdfObjectKey: pdfBytes ? keys.pdf : null,
-      docxSize: docxBytes.length,
-      pdfSize: pdfBytes?.length ?? null,
-      userId: auth.claims.userid,
-      userName: auth.claims.username,
-    });
-  } catch (err) {
-    // DB ล้มหลังเขียน object — เก็บกวาดก่อนตอบ กัน object กำพร้าไม่มี row ชี้
-    console.error("docver: insert version ล้ม — เก็บกวาด object ที่เขียนไปแล้ว", err);
-    await removeVersionObjects(versionId, pdfBytes !== null);
-    return docverError("เกิดข้อผิดพลาดของระบบ โปรดลองใหม่อีกครั้ง", 500);
-  }
-
-  return new Response(
-    JSON.stringify({
-      hasPdf: pdfBytes !== null,
-      versionId: row.id,
-      versionNumber: row.versionNumber,
-    }),
-    { headers: { "content-type": "application/json; charset=utf-8" } },
-  );
-}
-
-/** GET — history ของเอกสาร (ใหม่ → เก่า) · docId ที่ยังไม่เคยมี version = 404
- *  (สัญญาณ REST ตรง ๆ แบบ N10 — UI ฝั่ง add-in แสดง error + ปุ่มลองใหม่ ไม่พัง) */
-export async function GET(request: Request) {
-  const auth = requireDocverBearer(request);
-  if (!auth.ok) return auth.response;
-
-  const docId = auth.claims.fid;
-
-  try {
-    const doc = await findDocumentByDocId(docId);
-    if (!doc) {
-      return docverError("ไม่พบเอกสารนี้ในระบบ (ยังไม่เคยอัปโหลด version)", 404);
-    }
-    const rows = await listVersionsByDocId(doc.id);
-    return new Response(JSON.stringify(rows.map(toDocumentVersionDTO)), {
-      headers: { "content-type": "application/json; charset=utf-8" },
-    });
-  } catch (err) {
-    console.error("docver: โหลด version history ล้ม", err);
-    return docverError("เกิดข้อผิดพลาดของระบบ โปรดลองใหม่อีกครั้ง", 500);
-  }
-}

app/api/template/extract/route.ts

@@ -1,6 +1,5 @@
 import { NextResponse } from "next/server";
-import { extractContentControls, extractBookmark, templateContentControls, setCustomDocProps, getDocProps,templateDynamicContents } from "@/lib/lib-tmpl";
+import { extractContentControls } from "../lib-tmpl";
-import { verifyDataEd25519, verifyHmacSha256 } from "@/lib/lib-utils";
 
 export const runtime = "nodejs";
 
@@ -15,9 +14,6 @@ export async function POST(request: Request) {
   try {
     const formData = await request.formData();
     const file = formData.get("file");
-    const TEST_SECRET = String(formData.get("secret"))??"";
-    const TEST_PUBLIC_KEY_HEX = String(formData.get("public_key"))??"";
-
 
     if (!(file instanceof File)) {
       return NextResponse.json(
@@ -56,35 +52,12 @@ export async function POST(request: Request) {
     const buffer = Buffer.from(await file.arrayBuffer());
 
     // ใช้ lib-tmpl.ts เดิม
-    // const data = extractContentControls(buffer);
+    const data = extractContentControls(buffer);
 
-    const cc = extractContentControls(buffer);
+    return NextResponse.json({
-    const bookmark = extractBookmark(buffer)
-    const properties = getDocProps(buffer)
-    let verify: Record<string, unknown> ={}
-    const ticket_data = String(properties?.custom?.ticket_data)
-    const HmacSha256 = String(properties?.custom?.HmacSha256)
-    const Ed25519 = String(properties?.custom?.Ed25519)
-
-    if(ticket_data){
-      const ticketDataObj= JSON.parse(ticket_data)
-      const unix_timestamp = Number(ticketDataObj.exp)*1000
-      if(unix_timestamp){
-        verify['exp'] = new Date(unix_timestamp).toLocaleString("th-TH", { timeZone: "Asia/Bangkok" })
-      }
-      if(TEST_SECRET && HmacSha256){
-        verify['verifyHmacSha256'] = verifyHmacSha256(ticket_data,TEST_SECRET,HmacSha256)
-      }
-      if(TEST_PUBLIC_KEY_HEX&& Ed25519){
-        verify["Ed25519"]=verifyDataEd25519(ticket_data,Ed25519,TEST_PUBLIC_KEY_HEX)
-      }
-    }
-    let returnData : Record<string, unknown> = {
       success: true,
-      cc,bookmark,properties,verify
+      data,
-    }
+    });
-
-    return NextResponse.json(returnData);
   } catch (error) {
     console.error(error);
 

app/api/template/render/route.ts

@@ -1,6 +1,8 @@
 import { NextResponse } from "next/server";
-import { DocumentTemplate, templateContentControls, setCustomDocProps, getDocProps, templateDynamicContents } from "@/lib/lib-tmpl";
+import {
-import { generateHmacSha256, verifyHmacSha256, signDataEd25519, verifyDataEd25519, sortObjectKeys } from '@/lib/lib-utils';
+  templateContentControls,
+  type TemplateData,
+} from "../lib-tmpl";
 
 export const runtime = "nodejs";
 
@@ -18,13 +20,7 @@ export async function POST(request: Request) {
     const template = formData.get("template");
     const dataFile = formData.get("data");
     const dataJson = formData.get("dataJson");
-    const TEST_SECRET = (typeof formData.get("secret") === "string") ?
-      String(formData.get("secret")) : "super_secret";
-    const TEST_PRIVATE_KEY_HEX = (typeof formData.get("private_key") === "string") ?
-      String(formData.get("private_key")) : "8f2077b57b39399b6a7828f35da03a63ade8e3a36a6bf437b091a8bdb3d18ee1";
 
-    console.log(`secret:${TEST_SECRET}`)
-    console.log(`private:${TEST_PRIVATE_KEY_HEX}`)
     // -----------------------------
     // ตรวจสอบ Template
     // -----------------------------
@@ -66,14 +62,14 @@ export async function POST(request: Request) {
     // อ่าน JSON
     // -----------------------------
 
-    let templateData: DocumentTemplate;
+    let data: TemplateData;
 
     // JSON ผิด syntax เป็นความผิดของฝั่งผู้เรียก — คืน 400 ไม่ใช่ 500
     // (catch กลางท้ายฟังก์ชันสงวนไว้ให้ error ของระบบเท่านั้น)
     try {
       if (typeof dataJson === "string" && dataJson.length > 0) {
         // กรณีส่ง JSON ผ่าน form field
-        templateData = JSON.parse(dataJson) as DocumentTemplate;
+        data = JSON.parse(dataJson) as TemplateData;
       } else if (dataFile instanceof File) {
         if (dataFile.size > MAX_UPLOAD_BYTES) {
           return NextResponse.json(
@@ -88,7 +84,7 @@ export async function POST(request: Request) {
         // กรณี upload data.json
         const text = await dataFile.text();
 
-        templateData = JSON.parse(text) as DocumentTemplate;
+        data = JSON.parse(text) as TemplateData;
       } else {
         return NextResponse.json(
           {
@@ -103,8 +99,9 @@ export async function POST(request: Request) {
       return NextResponse.json(
         {
           success: false,
-          error: `Invalid JSON data (${error instanceof Error ? error.message : "parse error"
+          error: `Invalid JSON data (${
-            }).`,
+            error instanceof Error ? error.message : "parse error"
+          }).`,
         },
         { status: 400 },
       );
@@ -112,9 +109,9 @@ export async function POST(request: Request) {
 
     // JSON ต้องเป็น object
     if (
-      templateData === null ||
+      data === null ||
-      typeof templateData !== "object" ||
+      typeof data !== "object" ||
-      Array.isArray(templateData)
+      Array.isArray(data)
     ) {
       return NextResponse.json(
         {
@@ -129,52 +126,18 @@ export async function POST(request: Request) {
     // Template File → Buffer
     // -----------------------------
 
-    let templateBuffer: Buffer = Buffer.from(
+    const templateBuffer = Buffer.from(
       await template.arrayBuffer(),
     );
 
-    //Calculate hash
+    // -----------------------------
-    const originalTicket_data = templateData?.info?.ticket_data //expect valid json string
+    // ใช้ lib-tmpl.ts เดิม
-    // console.log("templateData",templateData?.info?.ticket_data)
+    // -----------------------------
-    if (originalTicket_data && typeof originalTicket_data === 'string') {
-      try {
 
-        const ttlSeconds: number = 300
+    const output = templateContentControls(
-        const originalTicketObj = JSON.parse(originalTicket_data)//sort and add expire to ticket data
+      templateBuffer,
-        if (originalTicketObj && typeof originalTicketObj === 'object') {
+      data,
-          console.log("Found valid ticket data: hash it")
+    );
-          // คำนวณค่า expire (ปัจจุบัน + จำนวนวินาทีที่ต้องการให้หมดอายุ)
-          // หาร 1000 เพราะต้องการหน่วยวินาที (sec) ไม่ใช่มิลลิวินาที (ms)
-          const expireTimestamp = Math.floor(Date.now() / 1000) + ttlSeconds;
-          const fullObj = { ...originalTicketObj, exp: expireTimestamp };
-          const sortedObj = sortObjectKeys(fullObj);
-
-          // แปลงกลับเป็น JSON string เพื่อนำไปใช้ส่งและทำ Hash
-          const ticket_data = JSON.stringify(sortedObj);
-          // console.log("check secret:",TEST_SECRET,TEST_PRIVATE_KEY_HEX,ticket_data)
-          const HmacSha256 = generateHmacSha256(ticket_data, TEST_SECRET)
-
-          const Ed25519  = signDataEd25519(ticket_data, TEST_PRIVATE_KEY_HEX)
-          templateBuffer = setCustomDocProps(templateBuffer, { ticket_data, HmacSha256, Ed25519 })
-        }
-      } catch (error) {
-        console.error("Set custom property fail",error);
-        
-      }
-    }
-
-    // Apply Dynamic Content
-    if (templateData?.dc && typeof templateData?.dc === "object") {
-      console.log("Apply Dynamic Content")
-      templateBuffer = Buffer.from(await templateDynamicContents(templateBuffer, templateData.dc))
-    }
-    // Apply Content Control
-    if (templateData?.cc && typeof templateData?.cc === "object") {
-      console.log("Apply Content Control")
-      templateBuffer = templateContentControls(templateBuffer, templateData.cc);
-    }
-
-    const output = templateBuffer;
 
     // -----------------------------
     // ส่ง DOCX กลับ

components/wordaddin/SaveControls.tsx

@@ -5,7 +5,7 @@ import { Spinner } from "./Spinner";
 
 /**
  * FR-17/FR-18 — ปุ่ม [บันทึก] / [บันทึกและปิดเอกสาร] + สถานะการบันทึก (ใช้ทุก phase ตาม spec v10)
- * banner autoSaveError ย้ายไปอยู่เหนือ toggle แท็บของ TaskpaneApp (2026-10-20) — ให้เห็นทั้งสองแท็บ
+ * banner autoSaveError อยู่ที่นี่เพื่อให้เห็นทุก phase ไม่เฉพาะตอน tracking
  * พอร์ตจาก SaveControls ใน App.tsx ต้นฉบับ (D:\word-addin-poc\addin) — logic เดิม เปลี่ยนแค่ชั้นภาพ
  */
 export function SaveControls({
@@ -13,6 +13,7 @@ export function SaveControls({
   busy,
   status,
   error,
+  autoSaveError,
   closeSupported,
   onSave,
   onSaveAndClose,
@@ -22,6 +23,7 @@ export function SaveControls({
   busy: boolean;
   status: "saving" | "saved" | null;
   error: string | null;
+  autoSaveError: string | null;
   closeSupported: boolean;
   onSave: () => void;
   onSaveAndClose: () => void;
@@ -58,6 +60,7 @@ export function SaveControls({
         </p>
       ) : null}
       {error ? <MessageBar intent="error">{error}</MessageBar> : null}
+      {autoSaveError ? <MessageBar intent="warning">{autoSaveError}</MessageBar> : null}
     </div>
   );
 }

components/wordaddin/TaskpaneApp.tsx

@@ -19,7 +19,6 @@ import ConfirmVersionDialog from "./ConfirmVersionDialog";
 import { MessageBar } from "./MessageBar";
 import SaveControls from "./SaveControls";
 import { Spinner } from "./Spinner";
-import TemplateToolsPanel from "./TemplateToolsPanel";
 import VersionHistoryPanel from "./VersionHistoryPanel";
 
 /**
@@ -40,18 +39,6 @@ import VersionHistoryPanel from "./VersionHistoryPanel";
 
 type Phase = "checking" | "signed-out" | "untracked" | "tracking";
 
-/** แท็บของ taskpane — versioning คือทุกอย่างเดิม, template คือเครื่องมือจัดการ Content Controls
- *  (Office.js ล้วน ไม่ยิง backend จึงใช้ได้ทั้ง untracked และ tracking) */
-type Tab = "versioning" | "template";
-
-/** ปุ่ม toggle แท็บ — กลุ่มปุ่ม + aria-pressed ตามแบบแผน FacetFilterPanel (ไม่ใช่ role="tablist"
- *  เพราะไม่ทำ arrow-key navigation ของ tablist จริง — ทำครึ่ง ๆ ผิด spec กว่าไม่ทำ)
- *  active เป็น tint น้ำเงินอ่อน ไม่ใช่พื้นทึบ เพื่อไม่แย่งน้ำหนักกับ CTA primary ตัวจริง (Save & Version) */
-const tabButtonClass = (active: boolean) =>
-  `focus-ring flex-1 rounded-md px-2 py-1.5 text-sm transition disabled:pointer-events-none disabled:opacity-50 ${
-    active ? "bg-primary/[0.08] font-medium text-primary" : "text-ink-soft hover:text-primary"
-  }`;
-
 const BTN_PRIMARY =
   "focus-ring inline-flex items-center gap-1.5 rounded-md bg-primary px-4 py-2.5 text-sm font-medium text-white transition hover:-translate-y-px hover:bg-primary-hover hover:shadow-btn-glow disabled:pointer-events-none disabled:opacity-50";
 
@@ -93,11 +80,6 @@ function demoVersions(now: number): VersionRecord[] {
 
 const TaskpaneApp: React.FC<{ demo?: "untracked" | "tracking" }> = ({ demo }) => {
   const [phase, setPhase] = useState<Phase>(demo === "untracked" ? "untracked" : demo ? "tracking" : "checking");
-  const [activeTab, setActiveTab] = useState<Tab>("versioning");
-  /** operation ของแท็บ template กำลังเขียนเอกสารอยู่ (panel รายงานผ่าน onBusyChange) —
-   *  ปิด toggle กันสลับแท็บกลาง operation แล้ว flow versioning มา stamp/capture ซ้อน */
-  const [templateBusy, setTemplateBusy] = useState(false);
-  const handleTemplateBusyChange = useCallback((busy: boolean) => setTemplateBusy(busy), []);
   const [bootError, setBootError] = useState<string | null>(null);
   const [username, setUsername] = useState<string | null>(demo ? (authService.getUsername() ?? null) : null);
 
@@ -139,7 +121,6 @@ const TaskpaneApp: React.FC<{ demo?: "untracked" | "tracking" }> = ({ demo }) =>
   const handleAuthRequired = useCallback((error: unknown): boolean => {
     if (error instanceof AuthRequiredError) {
       setPhase("signed-out");
-      setActiveTab("versioning");
       setDocumentId(null);
       setDocumentTemplateId(null);
       setVersions([]);
@@ -260,7 +241,6 @@ const TaskpaneApp: React.FC<{ demo?: "untracked" | "tracking" }> = ({ demo }) =>
     setVersions([]);
     setLoginError(null);
     setPhase("signed-out");
-    setActiveTab("versioning");
   };
 
   /** FR-18 [บันทึก] — local save เดี่ยวผ่าน lock ของ autoSaveService (ไม่ stamp metadata อะไร) */
@@ -423,42 +403,6 @@ const TaskpaneApp: React.FC<{ demo?: "untracked" | "tracking" }> = ({ demo }) =>
         ) : null}
       </div>
 
-      {/* FR-17 — banner auto-save error ยกไว้เหนือ toggle (เดิมซ่อนอยู่ใน SaveControls ของแท็บ
-          versioning): auto-save รันทุกแท็บ การเขียนค่าทดสอบของแท็บ template ก็ทำให้ dirty ได้
-          จึงต้องเห็น error แม้อยู่อีกแท็บ */}
-      {(phase === "untracked" || phase === "tracking") && autoSaveError ? (
-        <MessageBar intent="warning">{autoSaveError}</MessageBar>
-      ) : null}
-
-      {/* toggle แท็บ — แสดงเฉพาะ phase ที่เข้าถึงเอกสารแล้ว (checking/signed-out ยังไม่มีอะไรให้จัดการ)
-          ปิดทั้งสองปุ่มระหว่าง flow ที่เขียนเอกสาร: saving/starting ของ versioning (กัน progress หาย
-          กลาง flow — handler อยู่ที่ component นี้ flow ยังรันจนจบ แค่หน้าตา), saveBusy ของบันทึก
-          local/ปิดเอกสาร และ templateBusy ที่ panel รายงานผ่าน onBusyChange — กันเครื่องมือ template
-          แข่งแก้เอกสารกลาง stamp/capture ของ versionFlow หรือกลับกัน (panel unmount แล้ว promise
-          ของ service ก็ยังเขียนเอกสารต่อ ต้องปิดทางสลับตั้งแต่ต้น) */}
-      {(phase === "untracked" || phase === "tracking") && (
-        <div className="mt-2 flex gap-1 rounded-lg border border-line p-1" role="group" aria-label="ส่วนการทำงาน">
-          <button
-            type="button"
-            aria-pressed={activeTab === "versioning"}
-            className={tabButtonClass(activeTab === "versioning")}
-            disabled={saving || starting || saveBusy || templateBusy}
-            onClick={() => setActiveTab("versioning")}
-          >
-            Versioning
-          </button>
-          <button
-            type="button"
-            aria-pressed={activeTab === "template"}
-            className={tabButtonClass(activeTab === "template")}
-            disabled={saving || starting || saveBusy || templateBusy}
-            onClick={() => setActiveTab("template")}
-          >
-            เครื่องมือ Template
-          </button>
-        </div>
-      )}
-
       {phase === "checking" ? (
         <div className="flex flex-col items-center gap-4 pt-10">
           <Spinner label="กำลังตรวจสอบเอกสาร…" />
@@ -499,7 +443,7 @@ const TaskpaneApp: React.FC<{ demo?: "untracked" | "tracking" }> = ({ demo }) =>
         </div>
       ) : null}
 
-      {phase === "untracked" && activeTab === "versioning" ? (
+      {phase === "untracked" ? (
         <div className="flex flex-col gap-2 pt-4">
           <p className="text-base text-ink">เอกสารนี้ยังไม่ได้ติดตาม version</p>
           <p className="text-sm text-ink-soft">
@@ -526,6 +470,7 @@ const TaskpaneApp: React.FC<{ demo?: "untracked" | "tracking" }> = ({ demo }) =>
             busy={saveBusy}
             status={saveStatus}
             error={saveError}
+            autoSaveError={autoSaveError}
             closeSupported={closeSupported}
             onSave={() => void handleSaveOnly()}
             onSaveAndClose={() => void handleSaveAndClose()}
@@ -535,7 +480,7 @@ const TaskpaneApp: React.FC<{ demo?: "untracked" | "tracking" }> = ({ demo }) =>
         </div>
       ) : null}
 
-      {phase === "tracking" && activeTab === "versioning" ? (
+      {phase === "tracking" ? (
         /* ห้ามใส่ items-start — ลูกทุกตัวจะหดตามเนื้อหา (MessageBar/history list ไม่เต็มความกว้าง pane) */
         <div className="flex flex-col gap-2 pt-4">
           {/* กลุ่มข้อความสถานะ */}
@@ -567,6 +512,7 @@ const TaskpaneApp: React.FC<{ demo?: "untracked" | "tracking" }> = ({ demo }) =>
               busy={saveBusy}
               status={saveStatus}
               error={saveError}
+              autoSaveError={autoSaveError}
               closeSupported={closeSupported}
               onSave={() => void handleSaveOnly()}
               onSaveAndClose={() => void handleSaveAndClose()}
@@ -589,56 +535,43 @@ const TaskpaneApp: React.FC<{ demo?: "untracked" | "tracking" }> = ({ demo }) =>
         </div>
       ) : null}
 
-      {/* แท็บเครื่องมือ Template — state ทั้งหมดอยู่ใน panel เอง (snapshot ชั่วคราวของเอกสาร
+      {/* กดยืนยันแล้วปิด dialog ทันที — progress/ผลลัพธ์แสดงที่ pane (dialog ค้าง = บังผลลัพธ์
-          สลับแท็บแล้ว unmount = ทิ้งค่าทิ้งโดยตั้งใจ) */}
+          + เสี่ยงกดยืนยันซ้ำสร้าง version ซ้ำ; busy ใน dialog เหลือเป็น defense ชั่วขณะก่อน re-render) */}
-      {(phase === "untracked" || phase === "tracking") && activeTab === "template" ? (
+      <ConfirmVersionDialog
-        <TemplateToolsPanel onBusyChange={handleTemplateBusyChange} />
+        open={confirmOpen}
-      ) : null}
+        busy={saving}
-
+        onConfirm={(message) => {
-      {/* dialog ทั้งสองเป็นของ flow versioning — render เฉพาะแท็บ versioning (ตอน dialog เปิด
+          setConfirmOpen(false);
-          overlay fixed inset-0 + Tab trap อยู่แล้ว ปุ่ม toggle แตะไม่ได้ จึงไม่มี path ที่ dialog
+          void handleSaveAndVersion(message);
-          เปิดค้างขณะสลับแท็บ) */}
+        }}
-      {(phase === "untracked" || phase === "tracking") && activeTab === "versioning" ? (
+        {...(closeSupported
-        <>
+          ? {
-          {/* กดยืนยันแล้วปิด dialog ทันที — progress/ผลลัพธ์แสดงที่ pane (dialog ค้าง = บังผลลัพธ์
+              onConfirmClose: (message: string) => {
-              + เสี่ยงกดยืนยันซ้ำสร้าง version ซ้ำ; busy ใน dialog เหลือเป็น defense ชั่วขณะก่อน re-render) */}
+                setConfirmOpen(false);
-          <ConfirmVersionDialog
+                void handleSaveAndVersion(message, true);
-            open={confirmOpen}
+              },
-            busy={saving}
-            onConfirm={(message) => {
-              setConfirmOpen(false);
-              void handleSaveAndVersion(message);
-            }}
-            {...(closeSupported
-              ? {
-                  onConfirmClose: (message: string) => {
-                    setConfirmOpen(false);
-                    void handleSaveAndVersion(message, true);
-                  },
-                }
-              : {})}
-            onDismiss={() => setConfirmOpen(false)}
-          />
-
-          {/* FR-13 — Start Versioning ใช้ dialog เดียวกัน: ยืนยัน + พิมพ์ commit message ของ v1 ก่อนเริ่ม track */}
-          <ConfirmVersionDialog
-            open={startConfirmOpen}
-            busy={starting}
-            title="เริ่มติดตามเอกสารนี้?"
-            description={
-              documentTemplateId
-                ? "ระบบจะ stamp metadata ลงไฟล์ บันทึกไฟล์ปัจจุบันเป็น version 1 และผูกเอกสารกับ template ต้นทาง (ไฟล์ร่าง)"
-                : "ระบบจะ stamp metadata ลงไฟล์และบันทึกไฟล์ปัจจุบันเป็น version 1 ของเอกสารนี้"
             }
-            confirmLabel="เริ่มติดตาม (version 1)"
+          : {})}
-            onConfirm={(message) => {
+        onDismiss={() => setConfirmOpen(false)}
-              setStartConfirmOpen(false);
+      />
-              void handleStartVersioning(message);
+
-            }}
+      {/* FR-13 — Start Versioning ใช้ dialog เดียวกัน: ยืนยัน + พิมพ์ commit message ของ v1 ก่อนเริ่ม track */}
-            onDismiss={() => setStartConfirmOpen(false)}
+      <ConfirmVersionDialog
-          />
+        open={startConfirmOpen}
-        </>
+        busy={starting}
-      ) : null}
+        title="เริ่มติดตามเอกสารนี้?"
+        description={
+          documentTemplateId
+            ? "ระบบจะ stamp metadata ลงไฟล์ บันทึกไฟล์ปัจจุบันเป็น version 1 และผูกเอกสารกับ template ต้นทาง (ไฟล์ร่าง)"
+            : "ระบบจะ stamp metadata ลงไฟล์และบันทึกไฟล์ปัจจุบันเป็น version 1 ของเอกสารนี้"
+        }
+        confirmLabel="เริ่มติดตาม (version 1)"
+        onConfirm={(message) => {
+          setStartConfirmOpen(false);
+          void handleStartVersioning(message);
+        }}
+        onDismiss={() => setStartConfirmOpen(false)}
+      />
     </div>
   );
 };

components/wordaddin/TemplateToolsPanel.tsx

@@ -1,411 +0,0 @@
-"use client";
-
-import { useEffect, useMemo, useState } from "react";
-import { CornerDownLeft, Crosshair, FilePlus, LoaderCircle, PenLine, ScanSearch, WrapText } from "lucide-react";
-
-import {
-  applyTestValues,
-  insertBreakAtSelection,
-  insertParagraphAtSelection,
-  listContentControls,
-  selectContentControl,
-  supportsAllContentControlTypes,
-  type ScannedField,
-} from "@/wordaddin/services/templateService";
-import { getErrorMessage } from "@/wordaddin/services/errors";
-
-import { MessageBar } from "./MessageBar";
-
-/**
- * แท็บ "เครื่องมือ Template" (แท็บที่สองของ taskpane) — เครื่องมือช่วยทำ template
- * สำหรับคนออกแบบเอกสาร ใช้ได้ทั้ง phase untracked และ tracking เพราะไม่แตะ backend/tracking:
- *  1. สแกน Content Controls ทั้งเอกสาร + เตือน tag ว่าง/ซ้ำ + กระโดดไปเลือกช่อง
- *  2. กรอกค่าทดสอบทุกช่องแล้วเขียนกลับเข้าเอกสารจริง (ดูผลจัดหน้า/ตัดบรรทัดทันที
- *     โดยไม่ต้อง render ผ่าน /api/template/render)
- *  3. แทรกย่อหน้า/ตัวแบ่งบรรทัด/ตัวแบ่งหน้าที่ cursor ตอนจัดโครงสร้าง
- *
- * state ทั้งหมดถือภายใน — เป็น snapshot ชั่วคราวของเอกสาร: สลับแท็บแล้ว unmount = ทิ้ง
- * ค่าทิ้งโดยตั้งใจ (เก็บไว้ก็ stale เสียเองเมื่อผู้ใช้แก้เอกสารระหว่างนั้น)
- */
-
-const BTN_PRIMARY =
-  "focus-ring inline-flex items-center gap-1.5 rounded-md bg-primary px-4 py-2.5 text-sm font-medium text-white transition hover:-translate-y-px hover:bg-primary-hover hover:shadow-btn-glow disabled:pointer-events-none disabled:opacity-50";
-const BTN_SECONDARY =
-  "focus-ring inline-flex items-center gap-1.5 rounded-md border border-line bg-white px-3 py-1.5 text-sm text-ink transition hover:border-primary hover:text-primary disabled:pointer-events-none disabled:opacity-50";
-/** px-2 py-1.5 + text-xs ≈ สูง 30px — พ้นเกณฑ์ touch target 24px (WCAG 2.5.8) เหมือน VersionHistoryPanel */
-const BTN_ACTION =
-  "focus-ring inline-flex items-center gap-1 rounded-md px-2 py-1.5 text-xs text-ink-soft transition hover:bg-primary/[0.06] hover:text-primary disabled:pointer-events-none disabled:opacity-50";
-
-/** ปุ่มแทรกองค์ประกอบ (ย่อหน้า/ตัวแบ่ง) — icon บน label ล่าง 3 ปุ่มต่อแถว */
-const BTN_INSERT =
-  "focus-ring flex flex-col items-center gap-1 rounded-md border border-line bg-white px-1 py-2 text-xs text-ink transition hover:border-primary hover:text-primary disabled:pointer-events-none disabled:opacity-50";
-
-function TemplateToolsPanel({ onBusyChange }: { onBusyChange?: (busy: boolean) => void }) {
-  /** null = ยังไม่เคยสแกน (empty state ต่างจาก [] = สแกนแล้วไม่มีช่อง) */
-  const [fields, setFields] = useState<ScannedField[] | null>(null);
-  const [scanning, setScanning] = useState(false);
-  const [applying, setApplying] = useState(false);
-  const [insertingParagraph, setInsertingParagraph] = useState(false);
-  const [insertingBreak, setInsertingBreak] = useState<"line" | "page" | null>(null);
-  /** ค่าฟอร์มต่อ tag — key คือ tag ที่ trim แล้วไม่ว่างและไม่ซ้ำ */
-  const [values, setValues] = useState<Record<string, string>>({});
-  const [error, setError] = useState<string | null>(null);
-  const [warning, setWarning] = useState<string | null>(null);
-  const [success, setSuccess] = useState<string | null>(null);
-  /** คำเตือนความสามารถของ host (WordApi <1.5 เห็นเฉพาะ rich text CC) — แยก state จาก warning
-   *  ผลลัพธ์ของ operation เพราะเป็นข้อจำกัดของ host ตลอด session ห้ามโดน banner อื่นล้าง/ทับ */
-  const [capabilityWarning, setCapabilityWarning] = useState<string | null>(null);
-
-  const busy = scanning || applying || insertingParagraph || insertingBreak !== null;
-
-  /** รายงาน busy ให้ TaskpaneApp ปิด toggle แท็บระหว่าง operation ที่เขียนเอกสาร — กันสลับไปแท็บ
-   *  Versioning กด Save & Version แล้ว stamp/capture ซ้อน operation ที่ยังรันอยู่ (panel unmount
-   *  แล้ว promise ของ service ก็ยังเขียนเอกสารต่อ) · cleanup ส่ง false ตอน unmount กันปุ่มค้าง disabled */
-  useEffect(() => {
-    onBusyChange?.(busy);
-    return () => onBusyChange?.(false);
-  }, [busy, onBusyChange]);
-
-  /** tag ที่ไม่ว่างไม่ซ้ำ (เอาตัวแรกของ tag ซ้ำ) — เป็น key ของฟอร์มค่าทดสอบ */
-  const uniqueTags = useMemo(() => {
-    if (!fields) return [];
-    const seen = new Set<string>();
-    const tags: string[] = [];
-    for (const field of fields) {
-      const tag = field.tag.trim();
-      if (tag === "" || seen.has(tag)) continue;
-      seen.add(tag);
-      tags.push(tag);
-    }
-    return tags;
-  }, [fields]);
-
-  const emptyTagCount = useMemo(
-    () => (fields ? fields.filter((field) => field.tag.trim() === "").length : 0),
-    [fields],
-  );
-
-  /** tag ที่มีมากกว่า 1 ช่อง (เทียบหลัง trim) — render pipeline อ่านค่าเฉพาะช่องแรกของ tag จึงต้องเตือน */
-  const duplicateTags = useMemo(() => {
-    if (!fields) return [];
-    const counts = new Map<string, number>();
-    for (const field of fields) {
-      const tag = field.tag.trim();
-      if (tag === "") continue;
-      counts.set(tag, (counts.get(tag) ?? 0) + 1);
-    }
-    return Array.from(counts.entries())
-      .filter(([, count]) => count > 1)
-      .map(([tag]) => tag);
-  }, [fields]);
-
-  /** มีอย่างน้อยหนึ่งช่องที่กรอกค่า — กันกดเขียนตอนฟอร์มว่างทั้งหมด (service จะไม่แตะอะไรเลย
-   *  แล้ว UI ไปตีความ appliedCount 0 ว่า "ช่องถูกลบไป" ซึ่งเข้าใจผิด) */
-  const hasFilledValue = useMemo(
-    () => uniqueTags.some((tag) => (values[tag] ?? "").trim() !== ""),
-    [uniqueTags, values],
-  );
-
-  /**
-   * สแกนเอกสาร + เติมค่าฟอร์ม
-   * - merge=false (กดปุ่มสแกนเอง): seed ฟอร์มใหม่ทั้งหมดจากค่าปัจจุบันของช่องแรกของแต่ละ tag
-   *    พร้อมรีเซ็ต success/warning เดิม (ผลลัพธ์รอบก่อนไม่เกี่ยวกับ list รอบใหม่แล้ว)
-   * - merge=true (หลังเขียนค่า): คงค่าที่ผู้ใช้พิมพ์ค้างไว้ เติมเฉพาะ tag ใหม่ที่ยังไม่มีในฟอร์ม
-   *    และตัด tag ที่หายไปจากเอกสารทิ้ง — ทั้งสองอยู่บนผลสแกนรอบใหม่เสมอ
-   *    **ไม่แตะ success/warning** เพราะ handler ที่เรียกจัด banner ผลลัพธ์ของตัวเองอยู่
-   *    (คำเตือนความสามารถของ host แยก state ต่างหาก จึงไม่ทับกัน)
-   */
-  const runScan = async (merge: boolean) => {
-    setScanning(true);
-    setError(null);
-    if (!merge) {
-      setSuccess(null);
-      setWarning(null);
-    }
-    try {
-      const scanned = await listContentControls();
-      setFields(scanned);
-      // Word ต่ำกว่า WordApi 1.5 (เช่น Office 2019) มองเห็นเฉพาะ rich text CC — template ของศาล
-      // ส่วนใหญ่เป็น plain text CC; เป็นข้อจำกัดของ host ตลอด session จึงเช็คให้ทุกรอบสแกน
-      setCapabilityWarning(
-        supportsAllContentControlTypes()
-          ? null
-          : "Word รุ่นนี้มองเห็นเฉพาะช่องแบบ rich text — ช่องแบบ plain text ต้องใช้ Word ที่รองรับ WordApi 1.5 (เช่น Microsoft 365) จึงแสดงและเขียนค่าได้",
-      );
-      setValues((previous) => {
-        // สร้างใหม่จาก tag ของผลสแกนรอบนี้เท่านั้น — merge เอาแค่ค่าเดิมของ tag ที่ยังอยู่
-        // (tag ที่ถูกลบจากเอกสารตัดทิ้ง ไม่ให้ค้างไปโดน missingTags รอบเขียนถัด ๆ ไป)
-        const next: Record<string, string> = {};
-        const seen = new Set<string>();
-        for (const field of scanned) {
-          const tag = field.tag.trim();
-          if (tag === "" || seen.has(tag)) continue;
-          seen.add(tag);
-          next[tag] = merge && tag in previous ? previous[tag] : field.text;
-        }
-        return next;
-      });
-    } catch (scanError) {
-      setError(getErrorMessage(scanError, "สแกนช่องในเอกสารไม่สำเร็จ"));
-    } finally {
-      setScanning(false);
-    }
-  };
-
-  const handleView = async (id: number) => {
-    setError(null);
-    try {
-      await selectContentControl(id);
-    } catch (viewError) {
-      setError(getErrorMessage(viewError, "เลือกช่องไม่สำเร็จ"));
-    }
-  };
-
-  /** แทรกย่อหน้าว่างที่ cursor — เห็นผลในเอกสารทันทีจึงไม่ต้องแจ้ง success รบกวน */
-  const handleInsertParagraph = async () => {
-    setInsertingParagraph(true);
-    setError(null);
-    try {
-      await insertParagraphAtSelection();
-    } catch (insertError) {
-      setError(getErrorMessage(insertError, "แทรกย่อหน้าไม่สำเร็จ"));
-    } finally {
-      setInsertingParagraph(false);
-    }
-  };
-
-  const handleInsertBreak = async (breakKind: "line" | "page") => {
-    setInsertingBreak(breakKind);
-    setError(null);
-    try {
-      await insertBreakAtSelection(breakKind);
-    } catch (insertError) {
-      setError(
-        getErrorMessage(insertError, breakKind === "page" ? "แทรกตัวแบ่งหน้าไม่สำเร็จ" : "แทรกตัวแบ่งบรรทัดไม่สำเร็จ"),
-      );
-    } finally {
-      setInsertingBreak(null);
-    }
-  };
-
-  const handleApply = async () => {
-    setApplying(true);
-    setError(null);
-    setSuccess(null);
-    setWarning(null);
-    try {
-      const result = await applyTestValues(values);
-      if (result.appliedCount === 0 && result.failures.length === 0) {
-        setWarning("ไม่พบช่องที่ตรงกับค่าที่กรอก (อาจถูกลบไปหลังสแกน) — กดสแกนใหม่");
-      } else {
-        if (result.appliedCount > 0) {
-          setSuccess(`เขียนค่าทดสอบลงแล้ว ${result.appliedCount} ช่อง`);
-        }
-        const problems: string[] = [];
-        if (result.missingTags.length > 0) {
-          problems.push(`ไม่พบช่อง tag: ${result.missingTags.join(", ")}`);
-        }
-        if (result.failures.length > 0) {
-          const first = result.failures[0];
-          problems.push(
-            `เขียนไม่สำเร็จ ${result.failures.length} tag (${result.failures
-              .map((failure) => failure.tag)
-              .join(", ")}) — ${first.reason}`,
-          );
-        }
-        if (problems.length > 0) {
-          setWarning(
-            `${problems.join(" · ")} — ถ้าเอกสารนี้ถูกล็อค (Review → Restrict Editing) ให้ปลดก่อนจึงเขียนค่าได้`,
-          );
-        }
-      }
-      // สแกนใหม่ให้ค่าย่อใน list ตรงเอกสารจริง — คงค่าฟอร์มไว้ให้แก้ต่อ
-      await runScan(true);
-    } catch (applyError) {
-      setError(getErrorMessage(applyError, "เขียนค่าลงเอกสารไม่สำเร็จ"));
-    } finally {
-      setApplying(false);
-    }
-  };
-
-  return (
-    /* ห้ามใส่ items-start — ลูกทุกตัวจะหดตามเนื้อหา (เหมือน branch tracking ของ TaskpaneApp) */
-    <div className="flex flex-col gap-2 pt-4">
-      {error ? <MessageBar intent="error">{error}</MessageBar> : null}
-      {warning ? <MessageBar intent="warning">{warning}</MessageBar> : null}
-      {success ? <MessageBar intent="success">{success}</MessageBar> : null}
-      {capabilityWarning ? <MessageBar intent="warning">{capabilityWarning}</MessageBar> : null}
-
-      {/* §1 ตรวจสอบ Content Controls */}
-      <div className="mt-2 flex items-baseline justify-between gap-2">
-        <h3 className="font-display text-sm font-semibold text-ink">ตรวจสอบ Content Controls</h3>
-        {fields ? <span className="text-xs text-ink-soft">{fields.length} ช่อง</span> : null}
-      </div>
-      <button
-        type="button"
-        className={`${BTN_SECONDARY} w-full justify-center`}
-        disabled={busy}
-        aria-busy={scanning}
-        onClick={() => void runScan(false)}
-      >
-        {scanning ? (
-          <LoaderCircle className="size-4 animate-spin" aria-hidden />
-        ) : (
-          <ScanSearch className="size-4" aria-hidden />
-        )}
-        สแกนช่องในเอกสาร
-      </button>
-
-      {fields && (emptyTagCount > 0 || duplicateTags.length > 0) ? (
-        <MessageBar intent="warning">
-          {emptyTagCount > 0 ? `มี ${emptyTagCount} ช่องที่ยังไม่ได้ตั้ง tag` : ""}
-          {emptyTagCount > 0 && duplicateTags.length > 0 ? " · " : ""}
-          {duplicateTags.length > 0
-            ? `tag ซ้ำ: ${duplicateTags.join(", ")} — ตอน render ระบบอ่านเฉพาะช่องแรกของ tag`
-            : ""}
-        </MessageBar>
-      ) : null}
-
-      {!fields && !scanning ? (
-        <p className="text-sm text-ink-soft">กดสแกนเพื่อดูรายการช่องในเอกสาร</p>
-      ) : null}
-      {fields && fields.length === 0 && !scanning ? (
-        <p className="text-sm text-ink-soft">ไม่พบ content control ในเอกสาร</p>
-      ) : null}
-
-      {fields && fields.length > 0 ? (
-        <ol className="relative">
-          {fields.length > 1 ? <span className="absolute bottom-2 left-[3.5px] top-2 w-px bg-line" aria-hidden /> : null}
-          {fields.map((field, index) => (
-            <li className="relative pb-3 pl-4 last:pb-0" key={field.id}>
-              <span
-                className={`absolute left-0 top-[5px] size-2 rounded-full ${
-                  field.tag.trim() === "" ? "border border-warning bg-canvas" : "bg-ink"
-                }`}
-                aria-hidden
-              />
-              <div className="flex flex-wrap items-center gap-x-2 gap-y-1">
-                <span className="text-xs text-ink-faint">{index + 1}.</span>
-                <span
-                  className="break-all text-sm font-medium text-ink"
-                  title={`tag: ${field.tag || "—"} · title: ${field.title || "—"} · type: ${field.type}`}
-                >
-                  {field.tag.trim() === "" ? "(ไม่มี tag)" : field.tag.trim()}
-                </span>
-                <span className="rounded-full bg-ink/[0.06] px-1.5 py-px text-[11px] text-ink-soft">
-                  {field.kind === "inline" ? "ในบรรทัด" : "บล็อก"}
-                </span>
-                <span className="ml-auto">
-                  <button
-                    type="button"
-                    className={BTN_ACTION}
-                    disabled={busy}
-                    onClick={() => void handleView(field.id)}
-                  >
-                    <Crosshair className="size-3.5" aria-hidden />
-                    ดูช่อง
-                  </button>
-                </span>
-              </div>
-              <p className="mt-0.5 truncate text-xs text-ink-soft" title={field.text}>
-                {field.text.trim() === "" ? "(ว่าง)" : field.text}
-              </p>
-            </li>
-          ))}
-        </ol>
-      ) : null}
-
-      {/* §2 กรอกค่าทดสอบ */}
-      {uniqueTags.length > 0 ? (
-        <>
-          <h3 className="mt-4 font-display text-sm font-semibold text-ink">กรอกค่าทดสอบ</h3>
-          <p className="text-sm text-ink-soft">
-            แก้ค่าแล้วกดเขียนลงเอกสารเพื่อดูผลจัดหน้าจริง — ช่องที่เว้นว่างจะไม่ถูกแตะ
-          </p>
-          <div className="flex flex-col gap-2" aria-busy={applying}>
-            {uniqueTags.map((tag, index) => (
-              <div key={tag} className="flex flex-col gap-1">
-                <label className="text-sm font-medium text-ink break-all" htmlFor={`wordaddin-template-value-${index}`}>
-                  {tag}
-                </label>
-                <input
-                  id={`wordaddin-template-value-${index}`}
-                  className="genesis-input block w-full"
-                  value={values[tag] ?? ""}
-                  onChange={(event) => setValues((previous) => ({ ...previous, [tag]: event.target.value }))}
-                  disabled={busy}
-                />
-              </div>
-            ))}
-          </div>
-          <button
-            type="button"
-            className={`${BTN_PRIMARY} w-full justify-center`}
-            disabled={busy || !hasFilledValue}
-            onClick={() => void handleApply()}
-          >
-            <PenLine className="size-4" aria-hidden />
-            {applying ? "กำลังเขียนค่า…" : "เขียนค่าลงเอกสาร"}
-          </button>
-        </>
-      ) : fields ? (
-        <p className="mt-4 text-sm text-ink-soft">ไม่มีช่องที่ตั้ง tag ไว้ — สแกนก่อนจึงจะกรอกค่าทดสอบได้</p>
-      ) : (
-        <p className="mt-4 text-sm text-ink-soft">สแกนก่อนเพื่อกรอกค่าทดสอบ</p>
-      )}
-
-      {/* §3 ปุ่มแทรกองค์ประกอบหน้า — เสริมตอนจัดโครงสร้าง template (ตรวจด้วย formatting marks ตามปกติ:
-          Ctrl+Shift+8 — สลับผ่าน add-in ไม่ได้เพราะ Office.js ไม่มี API) */}
-      <h3 className="mt-4 font-display text-sm font-semibold text-ink">แทรกย่อหน้า / ตัวแบ่ง</h3>
-      <div className="grid grid-cols-3 gap-1">
-        <button
-          type="button"
-          className={BTN_INSERT}
-          disabled={busy}
-          aria-busy={insertingParagraph}
-          title="แทรกย่อหน้าว่างที่ตำแหน่ง cursor (เหมือนกด Enter)"
-          onClick={() => void handleInsertParagraph()}
-        >
-          {insertingParagraph ? (
-            <LoaderCircle className="size-4 animate-spin" aria-hidden />
-          ) : (
-            <CornerDownLeft className="size-4" aria-hidden />
-          )}
-          ย่อหน้า
-        </button>
-        <button
-          type="button"
-          className={BTN_INSERT}
-          disabled={busy}
-          aria-busy={insertingBreak === "line"}
-          title="ขึ้นบรรทัดใหม่ในย่อหน้าเดิม (Shift+Enter)"
-          onClick={() => void handleInsertBreak("line")}
-        >
-          {insertingBreak === "line" ? (
-            <LoaderCircle className="size-4 animate-spin" aria-hidden />
-          ) : (
-            <WrapText className="size-4" aria-hidden />
-          )}
-          แบ่งบรรทัด
-        </button>
-        <button
-          type="button"
-          className={BTN_INSERT}
-          disabled={busy}
-          aria-busy={insertingBreak === "page"}
-          title="ขึ้นหน้าใหม่ (Ctrl+Enter)"
-          onClick={() => void handleInsertBreak("page")}
-        >
-          {insertingBreak === "page" ? (
-            <LoaderCircle className="size-4 animate-spin" aria-hidden />
-          ) : (
-            <FilePlus className="size-4" aria-hidden />
-          )}
-          แบ่งหน้า
-        </button>
-      </div>
-    </div>
-  );
-}
-
-export default TemplateToolsPanel;

db/schema.ts

@@ -253,76 +253,12 @@ export const annotationVersions = pgTable(
   (t) => [index("annotation_versions_file_idx").on(t.fileId)],
 );
 
-// ─── e-Court Documents Versioning (docs/PLAN-DOCVER.md) ──────────────────────
-
-/** เอกสารหนึ่งชิ้นต่อ docId ที่ผู้เรียกกำหนด — สร้าง implicitly ตอน upload version แรก
- *  (ไม่มี endpoint/หน้าจอบริหารแยก) · **ไม่เกี่ยวกับตาราง files ของแอป note** —
- *  ไม่มี FK ไม่มี field ร่วม ไม่มีหน้า note ใดอ่าน (ของกลุ่ม /api/documents ล้วน ๆ) */
-export const documents = pgTable(
-  "documents",
-  {
-    id: uuid("id").primaryKey().defaultRandom(),
-    /** รหัสเอกสารจากผู้เรียก (add-in ใช้ GUID DocumentTrackingId / e-Court ใช้รหัสของตัวเอง)
-     *  — unique ทั้งระบบ: เอกสารเดียวมี row เดียว (ห้ามซ้ำ) */
-    docId: text("doc_id").notNull(),
-    createdAt: timestamp("created_at", { withTimezone: true })
-      .defaultNow()
-      .notNull(),
-  },
-  (t) => [uniqueIndex("documents_doc_id_key").on(t.docId)],
-);
-
-/** version ของเอกสาร — ไฟล์จริงอยู่ใน MinIO ตาม object key (docx + pdf ต่อ version)
- *  · pdf เป็น optional ตาม contract ของ add-in (best-effort — NULL = version นี้ไม่มี pdf)
- *  · object key เป็น uuid ล้วน `docver/<versionId>/document.{docx,pdf}` ไม่มี input ผู้ใช้ */
-export const documentVersions = pgTable(
-  "document_versions",
-  {
-    id: uuid("id").primaryKey().defaultRandom(),
-    documentId: uuid("document_id")
-      .notNull()
-      .references(() => documents.id, { onDelete: "cascade" }),
-    versionNumber: integer("version_number").notNull(),
-    /** GUID ที่ client generate ก่อน upload — เก็บไว้เทียบ/สืบสวน ไม่ใช้เป็น identity
-     *  (ไม่มี idempotency — retry ของผู้เรียกเกิด version ใหม่ ตามแผน §4) */
-    clientVersionId: text("client_version_id"),
-    /** SHA-256 hex ของไบต์ docx — คำนวณฝั่ง server เสมอ (NOT NULL เพราะ buffer ก่อน insert ทุกครั้ง) */
-    contentHash: text("content_hash").notNull(),
-    /** commit message (FR-13) — trim แล้วว่าง = NULL */
-    message: text("message"),
-    /** snapshot ตอน upload: map ดิบ `{ [sdtTag]: text }` จาก content controls
-     *  (รูปแบบ {value,missing} ของเอกสารผูก template ยังไม่มีผู้ส่ง — วันหน้ามีค่อยขยาย $type) */
-    fields: jsonb("fields").$type<Record<string, string>>(),
-    templateId: text("template_id"),
-    /** ชื่อไฟล์ดั้งเดิมที่ browser ส่ง (ผ่าน decodeUploadFilename + strip path แล้ว) —
-     *  ใช้ตั้ง Content-Disposition ของ object ไม่ใช่ชื่อ object */
-    fileName: text("file_name"),
-    docxObjectKey: text("docx_object_key").notNull(),
-    pdfObjectKey: text("pdf_object_key"),
-    docxSize: integer("docx_size").notNull(),
-    pdfSize: integer("pdf_size"),
-    /** ผู้อัปโหลด — endpoint รับมาแบบ plain field เพราะระบบ stand-alone ไม่มี session */
-    userId: text("user_id").notNull(),
-    userName: text("user_name").notNull(),
-    createdAt: timestamp("created_at", { withTimezone: true })
-      .defaultNow()
-      .notNull(),
-  },
-  (t) => [
-    // safety net ของการจ่ายเลข max+1 ภายใต้ FOR UPDATE (PLAN-DOCVER.md §3)
-    uniqueIndex("document_versions_document_number_key").on(t.documentId, t.versionNumber),
-    index("document_versions_document_created_idx").on(t.documentId, t.createdAt),
-  ],
-);
-
 // ─── DTO (timestamp เป็น ISO string เสมอ — ห้ามส่ง Date ข้าม server→client) ──
 
 export type AnnotationRow = typeof annotations.$inferSelect;
 export type BookmarkRow = typeof bookmarks.$inferSelect;
 export type ReplyRow = typeof annotationReplies.$inferSelect;
 export type AnnotationVersionRow = typeof annotationVersions.$inferSelect;
-export type DocumentRow = typeof documents.$inferSelect;
-export type DocumentVersionRow = typeof documentVersions.$inferSelect;
 
 export type AnnotationDTO = {
   id: string;
@@ -435,33 +371,3 @@ export function toVersionDTO(row: AnnotationVersionRow): AnnotationVersionDTO {
     createdAt: row.createdAt.toISOString(),
   };
 }
-
-/** item ของ GET /api/documents/{docId}/versions — surface ตรง VersionRecord ของ
- *  wordaddin/models/versionRecord.ts (คัดลอกมา define เอง — ห้าม import จาก wordaddin/
- *  ซึ่งเป็น client-only zone) + createdByUserName เป็นส่วนเสริม (field เพิ่มไม่ทำ
- *  UI ฝั่ง client พัง) · hasPdf derive จาก pdfObjectKey !== null ตัวเดียว (PLAN-DOCVER.md §1) */
-export type DocumentVersionDTO = {
-  versionId: string;
-  versionNumber: number;
-  createdAt: string;
-  createdByUserId: string;
-  createdByUserName: string;
-  contentHash: string;
-  fields: Record<string, string> | null;
-  message: string | null;
-  hasPdf: boolean;
-};
-
-export function toDocumentVersionDTO(row: DocumentVersionRow): DocumentVersionDTO {
-  return {
-    versionId: row.id,
-    versionNumber: row.versionNumber,
-    createdAt: row.createdAt.toISOString(),
-    createdByUserId: row.userId,
-    createdByUserName: row.userName,
-    contentHash: row.contentHash,
-    fields: row.fields,
-    message: row.message,
-    hasPdf: row.pdfObjectKey !== null,
-  };
-}

docker-compose.yml

@@ -1,58 +0,0 @@
-# Dev dependencies ของ judes-note — รันด้วย `docker compose up -d` (ทั้งคู่)
-# หรือ `docker compose up -d minio` (ถ้าจะรัน DB แบบเดิมด้วย docker run)
-#
-# service `db` ใช้ชื่อ container/วอลุ่มเดียวกับคำสั่ง docker run เดิมใน README
-# (วอลุ่ม pin ชื่อไม่มี prefix ของ compose ผ่าน `name:` ด้านล่าง) — ถ้ามี container
-# judes-note-db เก่ารันอยู่ (สร้างด้วย docker run) ให้ `docker rm -f judes-note-db`
-# ก่อน แล้ว compose จะต่อวอลุ่ม judes-note-db-data เดิมได้เลย ข้อมูลไม่หาย
-services:
-  db:
-    image: postgres:17-alpine
-    container_name: judes-note-db
-    environment:
-      POSTGRES_USER: postgres
-      POSTGRES_PASSWORD: postgres
-      # ชื่อ database ตรง DATABASE_URL ใน .env (สร้างตอน first init ของวอลุ่มเท่านั้น
-      # — วอลุ่มเดิมจาก docker run ที่ init ด้วย postgres ต้องสร้างเอง:
-      # docker exec judes-note-db psql -U postgres -c 'CREATE DATABASE "ecourt-note"')
-      POSTGRES_DB: ecourt-note
-    ports:
-      - "54322:5432"
-    volumes:
-      - judes-note-db-data:/var/lib/postgresql/data
-    healthcheck:
-      test: ["CMD-SHELL", "pg_isready -U postgres -d postgres"]
-      interval: 5s
-      timeout: 3s
-      retries: 10
-
-  # Object storage ของกลุ่ม API เอกสาร versioning (docs/PLAN-DOCVER.md §6) —
-  # bucket docver ไม่ต้องสร้างเอง: app สร้างตอน first use ผ่าน ensureBucket
-  # (ใช้ registry ทางการของ MinIO ที่ quay.io + pin RELEASE — Docker Hub
-  # ของ minio/minio เจอ rate limit/เข้าไม่ได้บ่อย)
-  minio:
-    image: quay.io/minio/minio:RELEASE.2025-09-07T16-13-09Z
-    container_name: judes-note-minio
-    command: server /data --console-address ":9001"
-    environment:
-      MINIO_ROOT_USER: minioadmin
-      MINIO_ROOT_PASSWORD: minioadmin
-    ports:
-      # โฮสต์ใช้ 19000/19001 เพราะ 9000/9001 ชนกับ container ของโปรเจกต์อื่นในเครื่องนี้
-      # (ข้างใน container ยังเป็น 9000/9001 ตาม default ของ MinIO)
-      - "19000:9000" # S3 API (MINIO_ENDPOINT/MINIO_PORT)
-      - "19001:9001" # console ดู bucket/object ผ่าน browser
-    volumes:
-      - judes-note-minio-data:/data
-    healthcheck:
-      test: ["CMD", "curl", "-f", "http://localhost:9000/minio/health/live"]
-      interval: 5s
-      timeout: 3s
-      retries: 10
-
-volumes:
-  # pin ชื่อจริงไม่มี prefix <project>_ ของ compose ให้ตรงชื่อวอลุ่มจาก docker run เดิม
-  judes-note-db-data:
-    name: judes-note-db-data
-  judes-note-minio-data:
-    name: judes-note-minio-data

docker/web.Dockerfile

@@ -23,20 +23,8 @@ ENV NEXT_TELEMETRY_DISABLED=1
 # db/index.ts throw ถ้าไม่มี DATABASE_URL ตอน next build เก็บ page data —
 # ใส่ค่า dummy (postgres.js เชื่อมแบบ lazy ไม่มี query ตอน build) ตัวจริงฉีดตอน docker run
 ENV DATABASE_URL=postgresql://placeholder:placeholder@127.0.0.1:5432/placeholder
-ENV MINIO_ENDPOINT=127.0.0.1
-ENV MINIO_PORT=19000
-ENV MINIO_USE_SSL=false
-ENV MINIO_ACCESS_KEY=minioadmin
-ENV MINIO_SECRET_KEY=minioadmin
-ENV DOCVER_API_KEY=2d9b76d49a4f5311f6a0dacf759ecec53f34b6d102f24c696890a4052c99cf54
-ENV DOCVER_TOKEN_SECRET=487023dd1c1c4d6a07475e96b1cc300fec1e68ac9c2dd7d5ac9b1bf75da1053e
-ENV DOCVER_TOKEN_TTL_SECONDS=604800
-ENV MINIO_BUCKET=docver
-ENV DOCVER_LINK_TTL_SECONDS=900
-
 RUN npm run build
 
-
 # ─── Stage 3: runtime ตัวเบา (แค่ standalone + public/) ───
 FROM node:24-alpine AS runner
 WORKDIR /app

docs/PLAN-DOCVER.md

@@ -1,222 +0,0 @@
-# PLAN-DOCVER — Document Versioning API (stand-alone)
-
-> วันที่ตกลงแผน: 2026-10-20 · เพิ่ม auth ด้วย access_token: 2026-10-22 · สถานะ: implement
-> รอบแรก (API ก่อน — ยังไม่ต่อ wordaddin)
-
-## 0. บริบท/เป้าหมาย
-
-ทำ backend จริงของฟีเจอร์ **"e-Court Documents Versioning"** (ตอนนี้ wordaddin ใช้ mock ใน
-`wordaddin/services/versioningService.ts`):
-
-- ตารางเอกสารคีย์ด้วย `docId` **ห้ามซ้ำ** (unique index) — **`docId` = claim `fid`
-  (string) จาก Bearer token ตรง ๆ** (2026-10-26 ถอด path param `{docId}` ออกจาก URL ทุก
-  endpoint — fileId ของ e-Court ใน token เป็นที่มาเดียวของรหัสเอกสาร)
-- แต่ละ version อ้าง **object ใน MinIO** — เก็บทั้ง `.docx` และ `.pdf` (pdf เป็น
-  optional/best-effort ตาม contract ของ add-in — `pdf.size === 0` = ไม่มี, มี `hasPdf` บอกใน
-  response)
-- เก็บ `userId`, `userName`, `createdAt` ต่อ version เพื่อรู้ว่าใครอัปโหลด
-- **identity (`userId`/`userName`/`templateId`) และ `docId` แกะจาก Bearer token** (2026-10-22
-  — เดิมส่ง plain field ใน multipart): ขอ token ที่ `POST /api/documents/token` ด้วย header
-  `x-api-key` แล้วแนบ `Authorization: Bearer <token>` กับทุก request — ระบบ stand-alone
-  ไม่มี session ร่วมกับใคร (ผู้เรียกคือ add-in ใน Word หรือระบบภายนอก) token จึงเป็น
-  พาหะ identity เดียว
-- **auth ทุก endpoint ของกลุ่มนี้** = Bearer JWT HS256 เซ็นด้วย `DOCVER_TOKEN_SECRET`
-  (ออก token ผ่าน `x-api-key` เทียบ env `DOCVER_API_KEY` — pattern `lib/external-api-auth.ts`
-  ของ N10) · ไม่มี CORS
-
-ข้อตกลงกับผู้ใช้ (2026-10-20): ทำ API ก่อน **ไม่แต้ wordaddin รอบนี้** — contract ตรง surface
-ที่ mock คงไว้เป๊ะ วันหน้าสลับของจริงแค่ตั้ง `NEXT_PUBLIC_ADDIN_API_BASE_URL` แล้วก้อบ body
-ของต้นฉบับกลับมา (ดู `docs/WORDADDIN-DEV.md`) · MinIO dev รันผ่าน `docker-compose.yml`
-(ผู้เรียกอัปโหลดทั้ง docx+pdf — ฝั่ง add-in ใช้ Office.js แปลง Word→PDF เอง)
-
-Contract อ้างอิง: `docs/addin-ui-flow.md` §7 + `wordaddin/services/versioningService.ts` +
-`wordaddin/models/versionRecord.ts` — **โค้ด server ห้าม import จาก `wordaddin/`**
-(client-only zone) type define เองใน `db/schema.ts`/`lib`
-
-## 1. Endpoint (URL เต็ม = `/docedit/api/documents/…` — prefix ใหม่ ได้รับยกเว้นจาก
-middleware เหมือน `api/template`)
-
-### `POST /api/documents/token` — ขอ access_token (2026-10-22)
-
-auth: header `x-api-key` เทียบ env `DOCVER_API_KEY` (ไม่ตั้ง/ว่าง = 401 fail closed ·
-ไม่ใส่/ผิด = 401 ข้อความเดียวกันเป๊ะ กัน enumerate) — ตรวจก่อนอ่าน body เสมอ
-
-JSON body (allowlist — key อื่น = 400 กัน typo):
-
-| field | type | หมายเหตุ |
-|---|---|---|
-| `userid` | string | บังคับ — trim 1–100 (claim `userid` → column `user_id`) |
-| `username` | string | บังคับ — trim 1–200 (claim `username` → column `user_name`) |
-| `fid` | string | **บังคับ** — trim 1–200 · **fileId ของ e-Court** เป็น `docId` ของทุก operation ตรง ๆ · verify ไม่รับ token ที่ไม่มี fid |
-| `template` | string | optional ≤100 (claim `template` → column `template_id` ตอน upload) |
-
-- env `DOCVER_TOKEN_SECRET` ไม่ตั้ง/ว่าง = **500** "DOCVER_TOKEN_SECRET ยังไม่ได้ตั้งค่า"
-  (ความผิด config ฝั่ง server ไม่ใช่ความผิดของผู้เรียก — และห้าม log ค่า secret)
-- response 200: `{ "access_token": string, "token_type": "Bearer", "expires_in": number }`
-  — JWT HS256 stateless มี `iat`/`exp` (TTL env `DOCVER_TOKEN_TTL_SECONDS` default 3600)
-  · verify บังคับ alg=HS256 (กัน alg-confusion) และเทียบ signature แบบ timing-safe
-- **endpoint อื่นของกลุ่มนี้ทั้งหมดต้องแนบ `Authorization: Bearer <access_token>`** —
-  ไม่มี header / รูปผิด / signature ผิด / หมดอายุ / secret ไม่ตั้ง = 401 ข้อความไทย
-  เดียวกันทุกกรณี (ไม่เปิดให้ใช้ endpoint เป็น oracle รู้สาเหตุ)
-
-### `POST /api/documents/versions` — อัปโหลด version ใหม่
-
-auth: `Authorization: Bearer` (ดู /token ด้านบน) — identity/templateId ของ row ใหม่และ
-`docId` (= `fid` — string) มาจาก claims ของ token ทั้งหมด ไม่รับจาก URL/form อีกต่อไป
-
-multipart/form-data:
-
-| field | type | หมายเหตุ |
-|---|---|---|
-| `file` | File (.docx) | บังคับ — ≤ 100MB, magic bytes `PK\x03\x04` |
-| `pdf` | File (.pdf) | optional — `size === 0` = ถือว่าไม่มี (add-in แนบ blob เปล่าได้) |
-| `clientVersionId` | string | optional ≤100 — GUID ที่ client generate เอง |
-| `fields` | string (JSON) | optional — map `{ [sdtTag]: text }` (≤100 keys, value ≤10,000) |
-| `message` | string | optional — commit message ≤2048 (trim ว่าง = NULL) |
-| `fileName` | string | optional — ชื่อไฟล์ดั้งเดิม (ผ่าน `decodeUploadFilename` แล้ว) |
-
-- field ที่ไม่อยู่ในตาราง = **400 กัน typo เงียบ ๆ** (pattern `parseQueryBody` ของ N10) —
-  **breaking change 2026-10-22:** `userId`/`userName`/`templateId` ถอดออกจาก form แล้ว
-  (ส่งมา = 400) identity/template มาจาก Bearer token ของ request นั้นแทน
-- เอกสาร (`documents` row) สร้าง **แบบ implicit** ตอน upload version แรก — ไม่มี endpoint
-  "สร้างเอกสาร" แยก (เอกสารถูกระบุที่ fid ใน token ตั้งแต่ขอ token)
-- response 200: `{ "hasPdf": boolean, "versionId": string, "versionNumber": number }`
-  (= `UploadVersionResult` เป๊ะ) — `versionNumber` เป็นค่า **authoritative จาก server**
-  (client เดา `latest+1` แล้วแก้ XML part ตัวเองเมื่อไม่ตรง — กรณีอัปโหลดชนกัน)
-
-### `GET /api/documents/versions` — history (ของเอกสาร fid ใน token)
-
-response: `DocumentVersionDTO[]` เรียง **ใหม่ → เก่า** (ตาม `VersionRecord[]` ของ add-in +
-ส่วนเสริม `createdByUserName`):
-
-```ts
-{
-  versionId: string;          // = id ของ row (uuid)
-  versionNumber: number;
-  createdAt: string;          // ISO-8601
-  createdByUserId: string;    // = user_id
-  createdByUserName: string;  // = user_name (ส่วนเสริมนอก contract เดิม)
-  contentHash: string;        // SHA-256 hex ของ docx (คำนวณฝั่ง server)
-  fields: Record<string, string> | null;
-  message: string | null;
-  hasPdf: boolean;            // derive จาก pdf_object_key !== null ตัวเดียว
-}
-```
-
-- `docId` (จาก fid ใน token) ไม่รู้จัก (ยังไม่เคยมี version) = **404** (สัญญาณ REST ตรง ๆ แบบ
-  N10 — UI ของ add-in แสดง error + ปุ่มลองใหม่ ไม่พัง)
-
-### `GET /api/documents/versions/{versionId}/download-link?format=docx|pdf`
-
-- format ไม่ส่ง/"" = `docx` · ค่าอื่น = 400
-- query version row **เช็ค docId (จาก fid ใน token) กับ versionId พร้อมกัน** (กันโยน id
-  ข้ามเอกสาร) — ไม่เจอ = 404
-- `format=pdf` แต่ version นั้นไม่มี pdf = 404 "version นี้ไม่มีสำเนา PDF"
-- response 200: `{ "url": string, "expiresAt": string }` — url เป็น **MinIO presigned GET**
-  (อายุตาม env `DOCVER_LINK_TTL_SECONDS` default 900 วิ) ให้ UI เปิดในเบราว์เซอร์จริงของ
-  ผู้ใช้ (webview ของ Word ทิ้ง blob download เงียบ ๆ — เหตุผลเดียวกับแผน add-in เดิม)
-- URL อ้าง `MINIO_ENDPOINT:MINIO_PORT` โดยตรง — **โฮสต์นี้ต้องเข้าถึงได้จากเบราว์เซอร์
-  ของผู้ใช้** ไม่ใช่แค่จาก Next server (หมายเหตุนี้อยู่ใน `.env.example`/README ด้วย)
-
-### ตาราง error
-
-| เหตุ | สถานะ |
-|---|---|
-| รูป versionId/format ผิด · field ไม่รู้จัก (รวม userId/userName/templateId เก่า) · ไม่ใช่ multipart · magic bytes ผิด · body ขอ /token ผิดกติกา (รวมขาด fid) | 400 |
-| `x-api-key` ไม่ตั้ง/ไม่ใส่/ผิด (ที่ /token) · Bearer ขาด/เน่า/หมดอายุ/secret ไม่ตั้ง (ทุก endpoint อื่น) | 401 |
-| ไฟล์เกิน 100MB (เช็ค `file.size` ก่อน buffer เสมอ — route ไม่มี `bodySizeLimit` คุม) | 413 |
-| เอกสาร/version ไม่มี · ขอ pdf ที่ version ไม่มี | 404 |
-| MinIO env ไม่ตั้ง/ล้ม · DB ล้ม (หลังเก็บกวาด object กำพร้า) · `DOCVER_TOKEN_SECRET` ไม่ตั้ง (ที่ /token) | 500 (log เต็มฝั่ง server + ข้อความกลาง ๆ ไทย) |
-
-## 2. ตาราง (db/schema.ts)
-
-```
-documents          — id uuid PK · doc_id text UNIQUE NOT NULL · created_at timestamptz
-document_versions  — id uuid PK · document_id uuid FK→documents CASCADE
-                   · version_number int NOT NULL (+ UNIQUE(document_id, version_number))
-                   · client_version_id · content_hash NOT NULL · message · fields jsonb
-                   · template_id · file_name · docx_object_key NOT NULL · pdf_object_key
-                   · docx_size int NOT NULL · pdf_size int · user_id NOT NULL
-                   · user_name NOT NULL · created_at
-                   + index (document_id, created_at)
-```
-
-- **`documents` ≠ `files`** ของแอป note — ไม่มี FK ไม่มี field ร่วม ไม่มีหน้า note ไหนอ่าน
-  (ชื่อคล้ายกันแต่คนละโดเมน: ตารางนี้เป็นของกลุ่ม API นี้ล้วน ๆ)
-- `content_hash`/`docx_size` เป็น NOT NULL เพราะ server buffer ไฟล์และคำนวณทั้งคู่ก่อน
-  insert เสมอ · `hasPdf` **ไม่มี column** — derive จาก `pdf_object_key !== null`
-- object key ใน MinIO: `docver/<versionId>/document.docx` / `document.pdf` — **uuid ล้วน**
-  ไม่มี input ผู้ใช้ (เหตุผลเดียวกับ N4 ที่ห้ามชื่อผู้ใช้ตกแต่ง path) · `versionId` สร้าง
-  ด้วย `randomUUID()` ฝั่ง server แล้วส่งเป็น `id` ตอน insert (object เขียนไปก่อนแล้ว)
-
-## 3. จ่ายเลข version ปลอดภัยเรียกคู่ขนาน
-
-เลือก: **insert-on-conflict + `SELECT … FOR UPDATE` ใน transaction เดียว** (ใช้ `.for("update")`
-ที่ repo ใช้อยู่แล้วใน `app/actions/annotations.ts`):
-
-1. `INSERT INTO documents (doc_id) VALUES (…) ON CONFLICT DO NOTHING` — สร้างเอกสารถ้ายังไม่มี
-2. `SELECT id FROM documents WHERE doc_id = … FOR UPDATE` — serialize ผู้จ่ายเลขรายเอกสาร
-   (unique `doc_id` → ได้ row เดียวเสมอ ไม่มี deadlock ข้ามเอกสาร)
-3. `SELECT max(version_number) + 1` แล้ว insert row version
-
-ทางเลือกที่ตัดทิ้ง: retry-on-23505 (ต้องเก็บกวาด object ซ้ำทุกรอบ ไม่มี ordering) ·
-`pg_advisory_xact_lock` (ได้แต่ต้อง raw SQL และซ้ำซ้อนกับ row lock) — UNIQUE
-`(document_id, version_number)` เก็บไว้เป็น safety net
-
-## 4. ลำดับงานต่อ request (POST) + เก็บกวาด object กำพร้า
-
-validate (text field ก่อนแตะไฟล์) → cap ขนาด → buffer → magic bytes → sha256 → `versionId`
-→ **putObject MinIO** (docx ก่อน pdf; pdf ล้ม = ลบ docx ทิ้ง) → **insert DB (tx §3)** —
-ล้ม = `removeObject` ทั้งคู่แล้วโยนต่อ (pattern เดียวกับ `unlink` + rethrow ของ N4)
-
-- crash ระหว่าง putObject↔insert เหลือ object ไร้ row ชี้ (key เป็น uuid ไม่ชนใคร) —
-  **ไม่ทำ GC รอบนี้** บันทึกไว้เป็นงานอนาคต
-- ไม่มี idempotency บน `clientVersionId` — retry หลัง network timeout เกิด version ใหม่
-  (client แก้เลขจาก response เองได้) ยอมรับได้
-
-## 5. Carve-out จาก invariant #4 (CLAUDE.md)
-
-กลุ่ม API นี้ **เขียน DB ผ่าน route handler** (ไม่ใช่ Server Action) และไม่ publish SSE
-ไม่ `revalidatePath` — ตาราง `documents`/`document_versions` เป็นของกลุ่มนี้ล้วน ไม่มีหน้า
-note ใดอ่าน จึงไม่มี Router Cache/SSE ที่ต้อง invalidate (นับเป็นข้อยกเว้นเดียวกับลักษณะ
-read-only ของ N10 แต่ตัวนี้เขียนได้)
-
-## 6. Env (อ่านตอนเรียก ไม่ใช่ตอน module load — ขาด/ล้ม = 500 ไทยกลาง ๆ + log เต็มฝั่ง server)
-
-| env | default | หมายเหตุ |
-|---|---|---|
-| `MINIO_ENDPOINT` | — บังคับ | host อย่างเดียว ไม่มี scheme |
-| `MINIO_PORT` | `9000` | dev compose แมพโฮสต์เป็น 19000 (9000/9001 ชน service อื่นในเครื่อง) |
-| `MINIO_USE_SSL` | `false` | |
-| `MINIO_ACCESS_KEY` / `MINIO_SECRET_KEY` | — บังคับ | dev compose = `minioadmin` |
-| `MINIO_BUCKET` | `docver` | app สร้างเองตอน first use (`ensureBucket` — จับ race ข้าม process) |
-| `DOCVER_LINK_TTL_SECONDS` | `900` | อายุ presigned URL |
-| `DOCVER_API_KEY` | — บังคับ | API key ของ `POST /api/documents/token` (header `x-api-key`) — ไม่ตั้ง/ว่าง = 401 fail closed · เทียบ timing-safe · ห้าม log ค่าดิบ |
-| `DOCVER_TOKEN_SECRET` | — บังคับ | secret เซ็น/ตรวจ JWT HS256 — ไม่ตั้ง: /token = 500 · endpoint อื่น = 401 · ห้าม log ค่าดิบ |
-| `DOCVER_TOKEN_TTL_SECONDS` | `3600` | อายุ access_token (วินาที) |
-
-`putObject` แนบ `Content-Type` + `Content-Disposition` (ชื่อไฟล์ไทยผ่าน `filename*=UTF-8''`
-best-effort + ASCII fallback `document.docx`/`document.pdf`) — presigned GET ได้ชื่อไฟล์สวย
-ตอนดาวน์โหลด
-
-## 7. ไฟล์ของกลุ่มนี้
-
-- `db/schema.ts` — ตาราง + `DocumentVersionDTO`/`toDocumentVersionDTO`
-- `lib/document-versioning.ts` — pure validation (ห้าม import `@/db`/`minio` — unit test ได้
-  โดยไม่ต้องตั้ง env อะไรเลย ตาม pattern `lib/external-api-auth.ts`)
-- `lib/docver-token.ts` — JWT HS256 issue/verify + `requireDocverApiKey`/`requireDocverBearer`
-  + `parseTokenRequestBody` (pure เหมือนกัน — ไม่ import `@/db`/`minio`)
-- `lib/docver-store.ts` — MinIO client (เก็บบน `globalThis` ใน dev แบบ `db/index.ts`) +
-  `ensureBucket` + put/remove/presign + `insertVersionRecord` (tx) + query helpers
-- `app/api/documents/token/route.ts` — POST ขอ access_token (x-api-key)
-- `app/api/documents/versions/route.ts` — POST + GET (docId = fid จาก token)
-- `app/api/documents/versions/[versionId]/download-link/route.ts` — GET
-- `docker-compose.yml` — db (ชื่อ/วอลุ่มเดิมกับ `docker run` ใน README) + minio
-  (โฮสต์ 19000 API / 19001 console — ข้างใน container 9000/9001; image จาก quay.io)
-- `tests/lib/document-versioning.test.ts` + `tests/lib/docver-token.test.ts` — unit test ส่วน pure
-
-## 8. Out of scope รอบนี้
-
-- ไม่แต้ `wordaddin/` หรือ client ใด ๆ (สลับ mock ทีหลังผ่าน `NEXT_PUBLIC_ADDIN_API_BASE_URL`)
-- ไม่มีหน้า UI ดูรายการเอกสาร/version ของกลุ่มนี้ · ไม่มี GC object กำพร้า · ไม่มี idempotency
-  บน `clientVersionId` · ไม่มีการแปลง docx→pdf ฝั่ง server (Office.js ของ add-in ทำ)

docs/WORDADDIN-DEV.md

@@ -34,22 +34,13 @@ manifest ต้องชี้ https — 2 ทางเลือก:
 
 ## Sideload ใน Word Desktop (Windows)
 
-เครื่อง dev ที่มี repo (แนะนำ — ไม่ต้องดาวน์โหลด/คัดลอกอะไรเลย):
+1. รัน dev server (https) แล้วดาวน์โหลด manifest: `https://localhost:3000/docedit/wordaddin/manifest.xml`
-
+2. เอาไฟล์ manifest ไว้โฟลเดอร์ใดโฟลเดอร์หนึ่ง เช่น `%USERPROFILE%\Documents\wordaddin-manifest\`
-1. Word: **File > Options > Trust Center > Trust Center Settings > Trusted Add-in Catalogs** เพิ่มโฟลเดอร์ `public/wordaddin` ของ repo (เช่น `D:\dms\judes-note\public\wordaddin`) > restart Word
+3. Word: **File > Options > Trust Center > Trust Center Settings > Trusted Add-in Catalogs** เพิ่มโฟลเดอร์นั้น > restart Word
-2. **Insert > My Add-ins > SHARED FOLDER** > เปิด "e-Court Documents Versioning"
+4. **Insert > My Add-ins > SHARED FOLDER** > เปิด "e-Court Documents Versioning"
-3. ชื่อไฟล์ไม่สำคัญ — Word สแกน `*.xml` ทุกไฟล์ในโฟลเดอร์ โดย `manifest.template.xml` คือ dev manifest อยู่แล้ว (URL localhost:3000) และเนื้อไฟล์อัปเดตตาม branch ที่ checkout อยู่เสมอ — **ห้ามวาง xml manifest อื่นเพิ่มในโฟลเดอร์นี้** (GUID เดียวกันสองไฟล์ = Word สับสน)
-
-เครื่องที่ไม่มี repo (production/เครื่องผู้ใช้):
-
-1. ดาวน์โหลด manifest จาก environment นั้น: `https://<โฮสต์>/docedit/wordaddin/manifest.xml`
-2. เอาไฟล์ไว้โฟลเดอร์ใดโฟลเดอร์หนึ่ง เช่น `%USERPROFILE%\Documents\wordaddin-manifest\`
-3. ทำขั้น Trust Center ข้างบนด้วยโฟลเดอร์นั้น > restart Word > **Insert > My Add-ins > SHARED FOLDER** > เปิด "e-Court Documents Versioning"
 
 Deploy จริง (intranet): **ไม่ต้อง rewrite อะไรแล้ว** — manifest serve ผ่าน `app/wordaddin/manifest.xml/route.ts` ซึ่งเขียนทับ origin ให้ตรงโฮสต์ที่ขอไฟล์อัตโนมัติ ดาวน์โหลด `https://<โฮสต์>/docedit/wordaddin/manifest.xml` แล้วใช้ sideload ได้ทันทีทุก environment (dev/UAT/production) · proxy ฝั่งหน้าควรส่ง `X-Forwarded-Host`/`X-Forwarded-Proto` ตามมาตรฐาน — ถ้าไม่ส่ง route ก็ยังใช้ Host ของ request และบังคับ https ให้โฮสต์ที่ไม่ใช่ localhost อยู่ดี
 
-รุ่น Office ที่รองรับ: manifest กำหนด WordApi **1.3** เป็นค่าต่ำสุด (customXmlParts คือ API สูงสุดที่ใช้ประจำ) — Microsoft 365 / Office 2021+ ใช้ได้ครบทุกฟีเจอร์ · **Office 2019 โหลดได้ แต่ปุ่ม "…และปิดเอกสาร" ถูกซ่อนอัตโนมัติ** เพราะ `document.close()` ต้องการ WordApi 1.4/1.5 (Microsoft 365 เท่านั้น) — `canCloseDocument()` เช็ค `isSetSupported` ตอน runtime แล้วซ่อน พฤติกรรมเดียวกับ Word on the web · Office 2016 (WordApi 1.1) โหลดไม่ขึ้น (เดิมเคยตั้ง 1.5 ทำให้ Office 2019 โหลดไม่ขึ้นด้วย — แก้ 2026-10-16)
-
 ## ทดสอบใน browser ธรรมดา (ไม่ต้องเปิด Word)
 
 - **`/docedit/wordaddin`** — เส้นทางจริง: Office.js โหลดได้แม่นนอก host (host เป็น null) → เห็น `signed-out` → กด Sign in (mock ผ่านทันที) → detect พังที่ `Word.run` → `bootError` + ปุ่มลองใหม่ (ตรวจ state machine/handler ได้ครบ)

docs/addin-ui-flow.md

@@ -10,8 +10,6 @@
 
 Task pane ทั้งหมดเป็น state machine เดียว **ไม่มี routing** — component เดียว (`App`) สลับหน้าตาตาม `phase`:
 
-ตั้งแต่ 2026-10-19 taskpane มี **2 แท็บ** (toggle กลุ่มปุ่ม `aria-pressed` ใต้ header — แสดงเฉพาะ phase `untracked`/`tracking`): **Versioning** คือทุกอย่างในเอกสารนี้ตามเดิม ส่วน **เครื่องมือ Template** (ดูหัวข้อ 10) คือเครื่องมือจัดการ Content Controls ฝั่ง Office.js ล้วน ไม่ยิง backend จึงใช้ได้ทั้งสอง phase ปุ่ม toggle **ทั้งสองปิดระหว่าง flow ที่เขียนเอกสาร** — `saving || starting` (versioning), `saveBusy` (บันทึก local/ปิดเอกสาร), `templateBusy` (operation ของแท็บ template รายงานผ่าน `onBusyChange` — กันสลับกลาง operation แล้ว flow versioning มา stamp/capture ซ้อน หรือกลับกัน; code review 2026-10-20) · สถานะแท็บรีเซ็ตกลับ `versioning` ตอน sign out / AuthRequiredError กัน surprise หลัง login ใหม่ · banner auto-save error (FR-17) ยกไว้เหนือ toggle ให้เห็นทั้งสองแท็บ
-
 ```
 checking ──(ไม่มี token)──────────────→ signed-out
    │
@@ -30,7 +28,6 @@ State ที่ UI ถือนอกเหนือจาก phase:
 
 | State | ความหมาย |
 |---|---|
-| `activeTab` | แท็บที่เปิดอยู่ `versioning` (default) / `template` — ดูหัวข้อ 10 |
 | `username` | ชื่อผู้ใช้จาก token (แสดงใน header) |
 | `documentId` | tracking id ของเอกสาร (มีเฉพาะ `tracking`) |
 | `documentTemplateId` | template ต้นทางของ**ไฟล์ร่าง** (มีเฉพาะ `untracked` ที่เป็นไฟล์ร่าง — FR-16) |
@@ -107,7 +104,7 @@ Component ใช้ร่วมทั้ง `untracked` และ `tracking` —
   - `saveBusy && status === "saving"` → `Spinner "กำลังบันทึก…"`
   - `!saveBusy && status === "saved"` → text จางๆ `บันทึกแล้ว` — ค้างไว้จนกดบันทึกรอบใหม่ (ไม่ reset เมื่อแก้ไขเอกสาร ไม่มี timeout)
   - `saveError` → MessageBar **error**
-  - `autoSaveError` → MessageBar **warning** (default: "บันทึกอัตโนมัติไม่สำเร็จ — ลองกด \"บันทึก\" ด้วยตนเอง") — **ย้ายไป render เหนือ toggle แท็บใน TaskpaneApp (2026-10-20)** ให้เห็นทั้งแท็บ Versioning และ Template ไม่มาใน SaveControls แล้ว
+  - `autoSaveError` → MessageBar **warning** (default: "บันทึกอัตโนมัติไม่สำเร็จ — ลองกด \"บันทึก\" ด้วยตนเอง")
 - ทั้งสองปุ่ม `disabled` เมื่อ `disabled` (flow versioning กำลังรัน) **หรือ** `saveBusy`
 
 พฤติกรรมปุ่ม:
@@ -275,43 +272,3 @@ response: `{ url: string, expiresAt: string }` — UI เปิด `url` ใน
 3. ของเดิมใช้ Fluent UI v9 (`@fluentui/react-components` + `@fluentui/react-icons`) — mapping ไป library อื่น: Button / Dialog / MessageBar / Spinner / Badge / Textarea / Text
 4. UI ทั้งหมดภาษาไทย — ข้อความสำเนาได้จากไฟล์ต้นฉบับที่อ้างด้านบน
 5. Task pane แคบ (side panel) — layout เป็นคอลัมน์เดียว ปุ่ม/actions ต้องรองรับความกว้างจำกัด
-6. id ของ Content Control **ไม่เสถียรข้าม session/coauthor** (docstring ของ Office.js เอง) — เครื่องมือ Template ใช้ id เฉพาะภายในอายุผลสแกนรอบเดียว ห้ามเก็บไปใช้ภายหลัง
-7. **การมองเห็นช่องตามรุ่นของ Word**: collection `contentControls` ธรรมดาเห็น**เฉพาะ rich text CC** (docstring ของ `Body.contentControls`) — เครื่องมือ Template จึง feature-detect `WordApi 1.5` (`isSetSupported`) แล้วใช้ `Document.getContentControls()` ที่เห็นทุกชนิด (รวม plain text ซึ่งเป็นส่วนใหญ่ของ template ศาล — เคสจริง: T3 มี plain 26 + rich 1 สแกนเห็นเฉพาะ `detail1`) บน Word ต่ำกว่า 1.5 (เช่น Office 2019 = 1.3 ตาม manifest) มองเห็น/เขียนได้เฉพาะ rich text พร้อม warning แจ้งผู้ใช้ · **ห้ามยก MinVersion ของ manifest** เพื่อปลดข้อจำกัดนี้ (Office 2019 จะโหลด add-in ไม่ขึ้น — บทเรียน 2026-10-16)
-
----
-
-## 10. แท็บ "เครื่องมือ Template" (2026-10-19)
-
-เครื่องมือช่วยทำ template สำหรับคนออกแบบเอกสาร — `TemplateToolsPanel` (state ภายในทั้งหมด มีแค่ prop `onBusyChange` รายงาน busy ให้ TaskpaneApp ปิด toggle แท็บ) + service `wordaddin/services/templateService.ts` — **Office.js ล้วน ไม่ยิง backend** (ส่วนใหญ่ WordApi 1.1 · `getByIdOrNullObject` 1.3 · `Document.getContentControls()` 1.5 ผ่าน feature-detect — ดู §9 ข้อ 7) ใช้ได้ทั้ง phase `untracked`/`tracking` · ไม่ auto-scan ตอนเปิดแท็บ (กดปุ่มเท่านั้น) · สลับแท็บแล้ว panel unmount = **ทิ้ง state ทิ้งโดยตั้งใจ** (snapshot เก่าเก็บไว้ก็ stale เสียเอง) · ปุ่มทั้ง panel disable ด้วย `busy` กันกดซ้อน
-
-### §1 ตรวจสอบ Content Controls
-
-- ปุ่ม `สแกนช่องในเอกสาร` (icon ScanSearch → spinner + `aria-busy` ตอนรัน) → list timeline แบบ VersionHistoryPanel: ลำดับ · tag (`break-all` + `title` แสดง tag/title/type ดิบ · ช่องไม่มี tag แสดง "(ไม่มี tag)" และจุดโหนดเป็นวงกลมขอบเหลือง) · badge ชนิด "ในบรรทัด"/"บล็อก" (heuristics: enum type ลงท้าย "Inline") · ค่าย่อ truncate 1 บรรทัด + `title` เต็ม · ปุ่ม `ดูช่อง` (icon Crosshair) → `cc.select()` ให้ Word เลื่อนไปเลือกช่อง
-- สรุปหัวกลุ่ม: "N ช่อง"
-- warning ใต้ปุ่มเมื่อพบปัญหา: "มี N ช่องที่ยังไม่ได้ตั้ง tag" / "tag ซ้ำ: a, b — ตอน render ระบบอ่านเฉพาะช่องแรกของ tag"
-- empty 2 แบบ: ยังไม่สแกน ("กดสแกนเพื่อดูรายการช่องในเอกสาร") กับสแกนแล้วว่าง ("ไม่พบ content control ในเอกสาร")
-
-### §2 กรอกค่าทดสอบ
-
-- แสดงเฉพาะมีช่องที่ตั้ง tag ≥1 ช่อง (จากผลสแกน): ฟอร์ม label+input ต่อ tag (id `wordaddin-template-value-<index>`) ค่าเริ่ม = ค่าปัจจุบันของช่องแรกของ tag นั้น + ปุ่ม primary `เขียนค่าลงเอกสาร` (icon PenLine → "กำลังเขียนค่า…" ตอนรัน)
-- **ช่องที่เว้นว่าง = ไม่ถูกแตะ** (กันเผลอล้างค่าจริง) · เขียนทุก CC ที่ tag ตรง (tag ซ้ำหลายช่อง = เขียนทุกช่องแบบ mail merge) · อ่าน id+tag สดรอบเดียวแล้วเขียน**แยก Word.run ราย tag** — tag ที่ Word ปฏิเสธ fail เฉพาะตัว เหลืออื่นยังเขียนได้ (ผลลัพธ์: `appliedCount` = จำนวนช่องที่เขียนจริง + `missingTags` ไม่พบช่อง + `failures` พร้อม code/errorLocation จาก OfficeExtension.Error) · UI รวมเป็น warning พร้อมชี้นำ "ถ้าเอกสารถูกล็อค (Review → Restrict Editing) ให้ปลดก่อน" — เคสจริงที่เจอ: error `0x800A16C6` บนเอกสารที่ `make-protected.mjs` ล็อคไว้ (readOnly + enforcement)
-- ผลลัพธ์: success "เขียนค่าทดสอบลงแล้ว N ช่อง" (N = จำนวนช่องที่เขียนจริง — tag ซ้ำหลายช่องนับทุกช่อง) + warning missingTags ถ้ามี → **สแกนใหม่โดยคงค่าฟอร์ม** (เฉพาะ tag ที่ยังอยู่ในเอกสาร — tag ที่ถูกลบไปตัดทิ้ง) ให้แก้ต่อ · ปุ่ม disabled เมื่อยังไม่มีช่องที่กรอกค่าเลย · หลังเขียนสำเร็จ `notifyDocumentChanged()` ตั้ง debounce auto-save 3 วิ ส่วน banner FR-3 ตั้งเมื่อ periodic tick ถัดไปของ autoSaveService เห็น document dirty (พฤติกรรมเดิมของ service — ไม่ใช่ทันที)
-
-### §3 แทรกย่อหน้า / ตัวแบ่ง (2026-10-19)
-
-- 3 ปุ่มแนวตั้ง (icon บน label ล่าง, grid 3 คอลัมน์, `title` อธิบายเต็ม): **ย่อหน้า** (CornerDownLeft — `insertParagraph("", "After")` เหมือนกด Enter) · **แบ่งบรรทัด** (WrapText — `insertBreak("Line", "After")` เหมือน Shift+Enter จัดที่อยู่/รายการในย่อหน้าเดิม) · **แบ่งหน้า** (FilePlus — เหมือน Ctrl+Enter เอกสารหลายหน้า: `insertBreak("Page", "After")` ก่อน ถ้า host ปฏิเสธ E_FAIL 0x80004005 (บางบริบท เช่น cursor ในตาราง — เคสจริงบน T3 2026-10-19) สลับไป `insertOoxml` แบบ w:p สมบูรณ์ครอบ `<w:br w:type="page"/>` — fragment ต้องเป็น block-level เต็มตัว ใช้ run เดี่ยวก็ยัง E_FAIL)
-- กดแล้วทำที่ cursor ทันที (ไม่มี success message — เห็นผลในเอกสารเลย) · icon สลับเป็น spinner ตอนรันตัวนั้น · ทุกปุ่ม disable ด้วย `busy` ร่วมกับเครื่องมืออื่น · fallback error: "แทรกย่อหน้าไม่สำเร็จ" / "แทรกตัวแบ่งบรรทัดไม่สำเร็จ" / "แทรกตัวแบ่งหน้าไม่สำเร็จ"
-
-### หมายเหตุ: ไม่มีปุ่มสลับ formatting marks (และไม่มีชุดแทรกอักขระพิเศษ)
-
-- **Office.js ไม่มี API สลับแสดง/ซ่อน formatting marks** (¶ ท้ายย่อหน้า/จุดช่องว่าง) — เป็น application setting ของ Word ที่ WordApi ไม่เปิดให้ add-in แตะ ผู้ใช้กด **Ctrl+Shift+8** หรือปุ่ม **¶ บนแท็บ Home** ของ Word เอง (workflow จริงของผู้ใช้: แทรกย่อหน้าเพิ่ม → เปิด marks ตรวจ → ซ่อนกลับ — จึงมีปุ่มแทรกย่อหน้าให้ ส่วน marks ใช้ของ Word)
-- เคยมีชุด "แทรกอักขระพิเศษ" (เลขไทย ๐–๙ + สัญลักษณ์) ต่อท้าย panel แล้ว**ถอดออก 2026-10-19** ตามคำขอผู้ใช้ — ที่ต้องการจริงคือ formatting marks ซึ่งทำผ่าน add-in ไม่ได้ (อ่านบันทึกเต็มใน git history รอบนั้น)
-- เคยมีเครื่องมือ **"สร้างช่องจากข้อความที่เลือก"** (dialog ตั้ง tag + `insertContentControl` ครอบ selection + `validateTag` + `TagInputDialog` + unit test ของ validateTag) แล้ว**ถอดออกทั้งเส้น 2026-10-19** ตามคำขอผู้ใช้ — การสร้างช่องใหม่ทำใน Word ด้วย Developer tab แทน
-
-### ข้อความ error กลางของ panel (MessageBar intent error)
-
-- สแกนพัง: fallback "สแกนช่องในเอกสารไม่สำเร็จ" · ดูช่องพัง: "ไม่พบช่องนี้ในเอกสาร (อาจถูกลบไปแล้ว) — กดสแกนใหม่" / fallback "เลือกช่องไม่สำเร็จ" · เขียนค่าพัง: fallback "เขียนค่าลงเอกสารไม่สำเร็จ" · แทรกพัง: fallback "แทรกย่อหน้าไม่สำเร็จ" / "แทรกตัวแบ่งบรรทัดไม่สำเร็จ" / "แทรกตัวแบ่งหน้าไม่สำเร็จ" (แบ่งหน้าที่พังทั้งสองวิธีจะรวมสาเหตุของทั้ง insertBreak และ OOXML fallback ในข้อความเดียว)
-
-### พฤติกรรมใน browser ธรรมดา / `?addindemo`
-
-ทุกปุ่มที่แตะเอกสาร (`สแกน`/`ดูช่อง`/`เขียนค่า`/`ย่อหน้า`/`แบ่งบรรทัด`/`แบ่งหน้า`) จบที่ error MessageBar ("Word is not defined") — ตามปรัชญา demo ของ repo เหมือนปุ่ม Save & Version ส่วน toggle/สลับแท็บ/ฟอร์มค่าทดสอบ ทดสอบได้ครบใน browser

drizzle/0005_icy_bloodaxe.sql

@@ -1,29 +0,0 @@
-CREATE TABLE "document_versions" (
-	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
-	"document_id" uuid NOT NULL,
-	"version_number" integer NOT NULL,
-	"client_version_id" text,
-	"content_hash" text NOT NULL,
-	"message" text,
-	"fields" jsonb,
-	"template_id" text,
-	"file_name" text,
-	"docx_object_key" text NOT NULL,
-	"pdf_object_key" text,
-	"docx_size" integer NOT NULL,
-	"pdf_size" integer,
-	"user_id" text NOT NULL,
-	"user_name" text NOT NULL,
-	"created_at" timestamp with time zone DEFAULT now() NOT NULL
-);
---> statement-breakpoint
-CREATE TABLE "documents" (
-	"id" uuid PRIMARY KEY DEFAULT gen_random_uuid() NOT NULL,
-	"doc_id" text NOT NULL,
-	"created_at" timestamp with time zone DEFAULT now() NOT NULL
-);
---> statement-breakpoint
-ALTER TABLE "document_versions" ADD CONSTRAINT "document_versions_document_id_documents_id_fk" FOREIGN KEY ("document_id") REFERENCES "public"."documents"("id") ON DELETE cascade ON UPDATE no action;--> statement-breakpoint
-CREATE UNIQUE INDEX "document_versions_document_number_key" ON "document_versions" USING btree ("document_id","version_number");--> statement-breakpoint
-CREATE INDEX "document_versions_document_created_idx" ON "document_versions" USING btree ("document_id","created_at");--> statement-breakpoint
-CREATE UNIQUE INDEX "documents_doc_id_key" ON "documents" USING btree ("doc_id");

drizzle/meta/0005_snapshot.json

@@ -1,735 +0,0 @@
-{
-  "id": "d9645a8e-eaf0-4f76-8c5e-bf978f6e61f0",
-  "prevId": "84f979ad-4a95-41f5-8082-30a994f8644d",
-  "version": "7",
-  "dialect": "postgresql",
-  "tables": {
-    "public.annotation_replies": {
-      "name": "annotation_replies",
-      "schema": "",
-      "columns": {
-        "id": {
-          "name": "id",
-          "type": "uuid",
-          "primaryKey": true,
-          "notNull": true,
-          "default": "gen_random_uuid()"
-        },
-        "annotation_id": {
-          "name": "annotation_id",
-          "type": "uuid",
-          "primaryKey": false,
-          "notNull": true
-        },
-        "user_id": {
-          "name": "user_id",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true
-        },
-        "user_name": {
-          "name": "user_name",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true
-        },
-        "message": {
-          "name": "message",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true
-        },
-        "created_at": {
-          "name": "created_at",
-          "type": "timestamp with time zone",
-          "primaryKey": false,
-          "notNull": true,
-          "default": "now()"
-        }
-      },
-      "indexes": {
-        "annotation_replies_annotation_idx": {
-          "name": "annotation_replies_annotation_idx",
-          "columns": [
-            {
-              "expression": "annotation_id",
-              "isExpression": false,
-              "asc": true,
-              "nulls": "last"
-            }
-          ],
-          "isUnique": false,
-          "concurrently": false,
-          "method": "btree",
-          "with": {}
-        }
-      },
-      "foreignKeys": {
-        "annotation_replies_annotation_id_annotations_id_fk": {
-          "name": "annotation_replies_annotation_id_annotations_id_fk",
-          "tableFrom": "annotation_replies",
-          "tableTo": "annotations",
-          "columnsFrom": [
-            "annotation_id"
-          ],
-          "columnsTo": [
-            "id"
-          ],
-          "onDelete": "cascade",
-          "onUpdate": "no action"
-        }
-      },
-      "compositePrimaryKeys": {},
-      "uniqueConstraints": {},
-      "policies": {},
-      "checkConstraints": {},
-      "isRLSEnabled": false
-    },
-    "public.annotation_versions": {
-      "name": "annotation_versions",
-      "schema": "",
-      "columns": {
-        "id": {
-          "name": "id",
-          "type": "uuid",
-          "primaryKey": true,
-          "notNull": true,
-          "default": "gen_random_uuid()"
-        },
-        "annotation_id": {
-          "name": "annotation_id",
-          "type": "uuid",
-          "primaryKey": false,
-          "notNull": true
-        },
-        "file_id": {
-          "name": "file_id",
-          "type": "uuid",
-          "primaryKey": false,
-          "notNull": true
-        },
-        "page_index": {
-          "name": "page_index",
-          "type": "integer",
-          "primaryKey": false,
-          "notNull": true
-        },
-        "user_id": {
-          "name": "user_id",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true
-        },
-        "user_name": {
-          "name": "user_name",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true
-        },
-        "type": {
-          "name": "type",
-          "type": "annotation_type",
-          "typeSchema": "public",
-          "primaryKey": false,
-          "notNull": true
-        },
-        "data": {
-          "name": "data",
-          "type": "jsonb",
-          "primaryKey": false,
-          "notNull": true
-        },
-        "kind": {
-          "name": "kind",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true
-        },
-        "created_at": {
-          "name": "created_at",
-          "type": "timestamp with time zone",
-          "primaryKey": false,
-          "notNull": true,
-          "default": "now()"
-        }
-      },
-      "indexes": {
-        "annotation_versions_file_idx": {
-          "name": "annotation_versions_file_idx",
-          "columns": [
-            {
-              "expression": "file_id",
-              "isExpression": false,
-              "asc": true,
-              "nulls": "last"
-            }
-          ],
-          "isUnique": false,
-          "concurrently": false,
-          "method": "btree",
-          "with": {}
-        }
-      },
-      "foreignKeys": {
-        "annotation_versions_file_id_files_id_fk": {
-          "name": "annotation_versions_file_id_files_id_fk",
-          "tableFrom": "annotation_versions",
-          "tableTo": "files",
-          "columnsFrom": [
-            "file_id"
-          ],
-          "columnsTo": [
-            "id"
-          ],
-          "onDelete": "cascade",
-          "onUpdate": "no action"
-        }
-      },
-      "compositePrimaryKeys": {},
-      "uniqueConstraints": {},
-      "policies": {},
-      "checkConstraints": {},
-      "isRLSEnabled": false
-    },
-    "public.annotations": {
-      "name": "annotations",
-      "schema": "",
-      "columns": {
-        "id": {
-          "name": "id",
-          "type": "uuid",
-          "primaryKey": true,
-          "notNull": true,
-          "default": "gen_random_uuid()"
-        },
-        "file_id": {
-          "name": "file_id",
-          "type": "uuid",
-          "primaryKey": false,
-          "notNull": true
-        },
-        "page_index": {
-          "name": "page_index",
-          "type": "integer",
-          "primaryKey": false,
-          "notNull": true
-        },
-        "user_id": {
-          "name": "user_id",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true
-        },
-        "user_name": {
-          "name": "user_name",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true
-        },
-        "type": {
-          "name": "type",
-          "type": "annotation_type",
-          "typeSchema": "public",
-          "primaryKey": false,
-          "notNull": true
-        },
-        "data": {
-          "name": "data",
-          "type": "jsonb",
-          "primaryKey": false,
-          "notNull": true
-        },
-        "created_at": {
-          "name": "created_at",
-          "type": "timestamp with time zone",
-          "primaryKey": false,
-          "notNull": true,
-          "default": "now()"
-        },
-        "updated_at": {
-          "name": "updated_at",
-          "type": "timestamp with time zone",
-          "primaryKey": false,
-          "notNull": true,
-          "default": "now()"
-        },
-        "resolved": {
-          "name": "resolved",
-          "type": "boolean",
-          "primaryKey": false,
-          "notNull": true,
-          "default": false
-        },
-        "resolved_at": {
-          "name": "resolved_at",
-          "type": "timestamp with time zone",
-          "primaryKey": false,
-          "notNull": false
-        }
-      },
-      "indexes": {
-        "annotations_file_page_idx": {
-          "name": "annotations_file_page_idx",
-          "columns": [
-            {
-              "expression": "file_id",
-              "isExpression": false,
-              "asc": true,
-              "nulls": "last"
-            },
-            {
-              "expression": "page_index",
-              "isExpression": false,
-              "asc": true,
-              "nulls": "last"
-            }
-          ],
-          "isUnique": false,
-          "concurrently": false,
-          "method": "btree",
-          "with": {}
-        }
-      },
-      "foreignKeys": {
-        "annotations_file_id_files_id_fk": {
-          "name": "annotations_file_id_files_id_fk",
-          "tableFrom": "annotations",
-          "tableTo": "files",
-          "columnsFrom": [
-            "file_id"
-          ],
-          "columnsTo": [
-            "id"
-          ],
-          "onDelete": "cascade",
-          "onUpdate": "no action"
-        }
-      },
-      "compositePrimaryKeys": {},
-      "uniqueConstraints": {},
-      "policies": {},
-      "checkConstraints": {},
-      "isRLSEnabled": false
-    },
-    "public.bookmarks": {
-      "name": "bookmarks",
-      "schema": "",
-      "columns": {
-        "id": {
-          "name": "id",
-          "type": "uuid",
-          "primaryKey": true,
-          "notNull": true,
-          "default": "gen_random_uuid()"
-        },
-        "file_id": {
-          "name": "file_id",
-          "type": "uuid",
-          "primaryKey": false,
-          "notNull": true
-        },
-        "page_index": {
-          "name": "page_index",
-          "type": "integer",
-          "primaryKey": false,
-          "notNull": true
-        },
-        "user_id": {
-          "name": "user_id",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true
-        },
-        "user_name": {
-          "name": "user_name",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true,
-          "default": "''"
-        },
-        "title": {
-          "name": "title",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true
-        },
-        "parent_id": {
-          "name": "parent_id",
-          "type": "uuid",
-          "primaryKey": false,
-          "notNull": false
-        },
-        "note": {
-          "name": "note",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": false
-        },
-        "y_offset": {
-          "name": "y_offset",
-          "type": "double precision",
-          "primaryKey": false,
-          "notNull": true
-        },
-        "created_at": {
-          "name": "created_at",
-          "type": "timestamp with time zone",
-          "primaryKey": false,
-          "notNull": true,
-          "default": "now()"
-        }
-      },
-      "indexes": {},
-      "foreignKeys": {
-        "bookmarks_file_id_files_id_fk": {
-          "name": "bookmarks_file_id_files_id_fk",
-          "tableFrom": "bookmarks",
-          "tableTo": "files",
-          "columnsFrom": [
-            "file_id"
-          ],
-          "columnsTo": [
-            "id"
-          ],
-          "onDelete": "cascade",
-          "onUpdate": "no action"
-        }
-      },
-      "compositePrimaryKeys": {},
-      "uniqueConstraints": {},
-      "policies": {},
-      "checkConstraints": {},
-      "isRLSEnabled": false
-    },
-    "public.document_versions": {
-      "name": "document_versions",
-      "schema": "",
-      "columns": {
-        "id": {
-          "name": "id",
-          "type": "uuid",
-          "primaryKey": true,
-          "notNull": true,
-          "default": "gen_random_uuid()"
-        },
-        "document_id": {
-          "name": "document_id",
-          "type": "uuid",
-          "primaryKey": false,
-          "notNull": true
-        },
-        "version_number": {
-          "name": "version_number",
-          "type": "integer",
-          "primaryKey": false,
-          "notNull": true
-        },
-        "client_version_id": {
-          "name": "client_version_id",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": false
-        },
-        "content_hash": {
-          "name": "content_hash",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true
-        },
-        "message": {
-          "name": "message",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": false
-        },
-        "fields": {
-          "name": "fields",
-          "type": "jsonb",
-          "primaryKey": false,
-          "notNull": false
-        },
-        "template_id": {
-          "name": "template_id",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": false
-        },
-        "file_name": {
-          "name": "file_name",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": false
-        },
-        "docx_object_key": {
-          "name": "docx_object_key",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true
-        },
-        "pdf_object_key": {
-          "name": "pdf_object_key",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": false
-        },
-        "docx_size": {
-          "name": "docx_size",
-          "type": "integer",
-          "primaryKey": false,
-          "notNull": true
-        },
-        "pdf_size": {
-          "name": "pdf_size",
-          "type": "integer",
-          "primaryKey": false,
-          "notNull": false
-        },
-        "user_id": {
-          "name": "user_id",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true
-        },
-        "user_name": {
-          "name": "user_name",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true
-        },
-        "created_at": {
-          "name": "created_at",
-          "type": "timestamp with time zone",
-          "primaryKey": false,
-          "notNull": true,
-          "default": "now()"
-        }
-      },
-      "indexes": {
-        "document_versions_document_number_key": {
-          "name": "document_versions_document_number_key",
-          "columns": [
-            {
-              "expression": "document_id",
-              "isExpression": false,
-              "asc": true,
-              "nulls": "last"
-            },
-            {
-              "expression": "version_number",
-              "isExpression": false,
-              "asc": true,
-              "nulls": "last"
-            }
-          ],
-          "isUnique": true,
-          "concurrently": false,
-          "method": "btree",
-          "with": {}
-        },
-        "document_versions_document_created_idx": {
-          "name": "document_versions_document_created_idx",
-          "columns": [
-            {
-              "expression": "document_id",
-              "isExpression": false,
-              "asc": true,
-              "nulls": "last"
-            },
-            {
-              "expression": "created_at",
-              "isExpression": false,
-              "asc": true,
-              "nulls": "last"
-            }
-          ],
-          "isUnique": false,
-          "concurrently": false,
-          "method": "btree",
-          "with": {}
-        }
-      },
-      "foreignKeys": {
-        "document_versions_document_id_documents_id_fk": {
-          "name": "document_versions_document_id_documents_id_fk",
-          "tableFrom": "document_versions",
-          "tableTo": "documents",
-          "columnsFrom": [
-            "document_id"
-          ],
-          "columnsTo": [
-            "id"
-          ],
-          "onDelete": "cascade",
-          "onUpdate": "no action"
-        }
-      },
-      "compositePrimaryKeys": {},
-      "uniqueConstraints": {},
-      "policies": {},
-      "checkConstraints": {},
-      "isRLSEnabled": false
-    },
-    "public.documents": {
-      "name": "documents",
-      "schema": "",
-      "columns": {
-        "id": {
-          "name": "id",
-          "type": "uuid",
-          "primaryKey": true,
-          "notNull": true,
-          "default": "gen_random_uuid()"
-        },
-        "doc_id": {
-          "name": "doc_id",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true
-        },
-        "created_at": {
-          "name": "created_at",
-          "type": "timestamp with time zone",
-          "primaryKey": false,
-          "notNull": true,
-          "default": "now()"
-        }
-      },
-      "indexes": {
-        "documents_doc_id_key": {
-          "name": "documents_doc_id_key",
-          "columns": [
-            {
-              "expression": "doc_id",
-              "isExpression": false,
-              "asc": true,
-              "nulls": "last"
-            }
-          ],
-          "isUnique": true,
-          "concurrently": false,
-          "method": "btree",
-          "with": {}
-        }
-      },
-      "foreignKeys": {},
-      "compositePrimaryKeys": {},
-      "uniqueConstraints": {},
-      "policies": {},
-      "checkConstraints": {},
-      "isRLSEnabled": false
-    },
-    "public.files": {
-      "name": "files",
-      "schema": "",
-      "columns": {
-        "id": {
-          "name": "id",
-          "type": "uuid",
-          "primaryKey": true,
-          "notNull": true,
-          "default": "gen_random_uuid()"
-        },
-        "title": {
-          "name": "title",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true
-        },
-        "description": {
-          "name": "description",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": false
-        },
-        "pdf_url": {
-          "name": "pdf_url",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": true
-        },
-        "external_id": {
-          "name": "external_id",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": false
-        },
-        "type_id": {
-          "name": "type_id",
-          "type": "text",
-          "primaryKey": false,
-          "notNull": false
-        },
-        "created_at": {
-          "name": "created_at",
-          "type": "timestamp with time zone",
-          "primaryKey": false,
-          "notNull": true,
-          "default": "now()"
-        }
-      },
-      "indexes": {
-        "files_type_id_idx": {
-          "name": "files_type_id_idx",
-          "columns": [
-            {
-              "expression": "type_id",
-              "isExpression": false,
-              "asc": true,
-              "nulls": "last"
-            }
-          ],
-          "isUnique": false,
-          "concurrently": false,
-          "method": "btree",
-          "with": {}
-        },
-        "files_external_id_key": {
-          "name": "files_external_id_key",
-          "columns": [
-            {
-              "expression": "external_id",
-              "isExpression": false,
-              "asc": true,
-              "nulls": "last"
-            }
-          ],
-          "isUnique": true,
-          "concurrently": false,
-          "method": "btree",
-          "with": {}
-        }
-      },
-      "foreignKeys": {},
-      "compositePrimaryKeys": {},
-      "uniqueConstraints": {},
-      "policies": {},
-      "checkConstraints": {},
-      "isRLSEnabled": false
-    }
-  },
-  "enums": {
-    "public.annotation_type": {
-      "name": "annotation_type",
-      "schema": "public",
-      "values": [
-        "HIGHLIGHT",
-        "DRAW",
-        "COMMENT",
-        "SHAPE",
-        "REDACTION",
-        "TEXTBOX",
-        "STAMP"
-      ]
-    }
-  },
-  "schemas": {},
-  "sequences": {},
-  "roles": {},
-  "policies": {},
-  "views": {},
-  "_meta": {
-    "columns": {},
-    "schemas": {},
-    "tables": {}
-  }
-}

drizzle/meta/_journal.json

@@ -36,13 +36,6 @@
       "when": 1790072946313,
       "tag": "0004_right_ted_forrester",
       "breakpoints": true
-    },
-    {
-      "idx": 5,
-      "version": "7",
-      "when": 1792467537332,
-      "tag": "0005_icy_bloodaxe",
-      "breakpoints": true
     }
   ]
 }

lib/document-versioning.ts

@@ -1,227 +0,0 @@
-// PLAN-DOCVER.md §1 — validation ล้วนของกลุ่ม /api/documents (document versioning)
-// pattern เดียวกับ lib/external-api.ts ของ N10: strict กัน typo เงียบ ๆ (field ที่
-// ไม่รู้จัก = error), trim-ว่าง = ถือว่าไม่ส่ง, ข้อความ error เป็นไทยทุกอัน
-//
-// ห้าม import อะไรที่ลาก @/db หรือ minio มาด้วย — unit test (tests/lib/) ต้องรันได้
-// โดยไม่ต้องตั้ง DATABASE_URL/MINIO_* เลย (pattern เดียวกับ lib/external-api-auth.ts)
-import { decodeUploadFilename } from "@/utils/upload-name";
-
-/** cap เดียวกับ N4 / api/template — route ต้องเช็คขนาดก่อน buffer เสมอ
- *  (route handler ไม่ได้รับเคราะห์ bodySizeLimit ของ Server Actions) */
-export const DOCVER_MAX_UPLOAD_BYTES = 100 * 1024 * 1024;
-
-/** ตรง maxLength ของ commit message dialog ฝั่ง add-in (FR-13) */
-export const DOCVER_MESSAGE_MAX = 2048;
-
-export const DOCX_CONTENT_TYPE =
-  "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
-export const PDF_CONTENT_TYPE = "application/pdf";
-
-/** รหัสเอกสาร (docId) ไม่มี validator ที่นี่แล้ว — ตอนนี้มาจาก fid ใน Bearer token
- *  (String(fid) — integer ที่ verify แล้ว ผ่าน lib/docver-token.ts) ไม่ใช่ path param
- *  ของผู้เรียก · parseDocId เดิมถอดออกพร้อมการถอด segment [docId] ออกจาก URL */
-
-const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-
-/** field ที่รับใน multipart ของ POST …/versions — อะไรนอกนี้ = 400 กัน typo เงียบ ๆ
- *  (userId/userName/templateId ถอดออกแล้ว — identity/template มาจาก Bearer token
- *  ผ่าน lib/docver-token.ts ส่ง field เก่ามา = 400 ตาม convention) */
-const FORM_FIELDS = [
-  "file",
-  "pdf",
-  "clientVersionId",
-  "fields",
-  "message",
-  "fileName",
-] as const;
-
-export type DocverError = { ok: false; error: string };
-
-/** Response ผิดพลาดของกลุ่มนี้ — JSON {"error": "<ไทย"} รูปเดียวกับ N10
- *  (define ที่นี่เพื่อให้ route ทั้งสองใช้ร่วมโดยไม่ต้องพึ่ง module ของ N10) */
-export function docverError(message: string, status: number): Response {
-  return new Response(JSON.stringify({ error: message }), {
-    status,
-    headers: { "content-type": "application/json; charset=utf-8" },
-  });
-}
-
-/** magic bytes ของ .docx — OOXML เป็น ZIP จึงขึ้นต้น PK\x03\x04 (mirror รูปแบบ
- *  matchesSignature ของ app/actions/files.ts — utils/file-kind.ts เป็นของ note files) */
-export function isDocxBytes(bytes: Buffer): boolean {
-  return bytes.subarray(0, 4).toString("latin1") === "PK\x03\x04";
-}
-
-export function isPdfBytes(bytes: Buffer): boolean {
-  return bytes.subarray(0, 5).toString("latin1") === "%PDF-";
-}
-
-/** versionId จาก path param — เก็บเป็น uuid เสมอจึงบังคับรูป (normalize ลงตัวพิมพ์เล็ก) */
-export function parseVersionIdParam(raw: string):
-  | { ok: true; versionId: string }
-  | DocverError {
-  const versionId = raw.trim().toLowerCase();
-  if (!UUID_RE.test(versionId)) {
-    return { ok: false, error: "versionId ต้องเป็น UUID" };
-  }
-  return { ok: true, versionId };
-}
-
-/** ?format= ของ download-link — ไม่ส่ง/ว่าง = docx (ค่าเริ่มต้นตาม contract) */
-export function parseDownloadFormat(raw: string | null):
-  | { ok: true; format: "docx" | "pdf" }
-  | DocverError {
-  const format = raw?.trim() ?? "";
-  if (format === "") return { ok: true, format: "docx" };
-  if (format === "docx" || format === "pdf") return { ok: true, format };
-  return { ok: false, error: "format รับค่า docx หรือ pdf เท่านั้น" };
-}
-
-function trimOrNull(value: string): string | null {
-  const trimmed = value.trim();
-  return trimmed === "" ? null : trimmed;
-}
-
-/** อ่าน text field จาก FormData — ไม่ส่ง = null · ส่งมาเป็น File = 400 (ไม่ใช่ string) */
-function formString(form: FormData, field: string):
-  | { ok: true; value: string | null }
-  | DocverError {
-  const entry = form.get(field);
-  if (entry === null) return { ok: true, value: null };
-  if (typeof entry !== "string") {
-    return { ok: false, error: `field '${field}' ต้องเป็น string` };
-  }
-  return { ok: true, value: trimOrNull(entry) };
-}
-
-/** ชื่อไฟล์แสดงผล (Content-Disposition): ตัด path ที่ฝังมา + trim + cap 200 —
- *  ว่าง = null (ให้ presign ใช้ชื่อ default document.docx/pdf) */
-export function sanitizeDisplayFileName(raw: string | null): string | null {
-  if (raw === null) return null;
-  const base = raw.split(/[\\/]/).pop() ?? raw;
-  return trimOrNull(base)?.slice(0, 200) ?? null;
-}
-
-/** ชื่อไฟล์จาก File.name ของ multipart — undici ถอด Content-Disposition เป็น latin1
- *  ทำชื่อไทยเพี้ยน (N4) จึงต้องผ่าน decodeUploadFilename ก่อน sanitize เสมอ */
-export function sanitizeFilePartName(raw: string): string | null {
-  return sanitizeDisplayFileName(decodeUploadFilename(raw));
-}
-
-/** fields ของ multipart (JSON string) → map ดิบ { [sdtTag]: text } —
- *  `{}` หรือไม่ส่ง = null · ไม่ใช่ object ล้วน/key หรือ value ผิดกติกา = 400 */
-export function parseFieldsJson(raw: string):
-  | { ok: true; fields: Record<string, string> | null }
-  | DocverError {
-  let parsed: unknown;
-  try {
-    parsed = JSON.parse(raw);
-  } catch {
-    return { ok: false, error: 'field "fields" ต้องเป็น JSON object เช่น { "tag": "ค่า" }' };
-  }
-  if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-    return { ok: false, error: 'field "fields" ต้องเป็น JSON object เช่น { "tag": "ค่า" }' };
-  }
-  const record = parsed as Record<string, unknown>;
-  const keys = Object.keys(record);
-  if (keys.length > 100) {
-    return { ok: false, error: 'field "fields" มี key เกิน 100 รายการ' };
-  }
-  for (const key of keys) {
-    if (key.length > 200) {
-      return { ok: false, error: 'key แต่ละรายการใน "fields" ยาวเกิน 200 ตัวอักษร' };
-    }
-    const value = record[key];
-    if (typeof value !== "string") {
-      return { ok: false, error: 'ค่าของแต่ละรายการใน "fields" ต้องเป็น string' };
-    }
-    if (value.length > 10_000) {
-      return { ok: false, error: 'ค่าของแต่ละรายการใน "fields" ยาวเกิน 10,000 ตัวอักษร' };
-    }
-  }
-  return { ok: true, fields: keys.length === 0 ? null : (parsed as Record<string, string>) };
-}
-
-export type ParsedVersionUploadForm = {
-  clientVersionId: string | null;
-  message: string | null;
-  /** ชื่อไฟล์ดั้งเดิมจาก field "fileName" (แยกจากชื่อของ File เอง — add-in ส่งมาเอง
-   *  เพราะ desktop Word ได้ชื่อจาก path จริง) — strip path + cap แล้ว */
-  fileName: string | null;
-  fields: Record<string, string> | null;
-};
-
-/** ตรวจ text field ทั้งหมดของ POST …/versions (file/pdf เช็คที่ route เพราะต้องอ่าน
- *  size ก่อน buffer) — identity (userId/userName) กับ templateId ไม่รับใน form
- *  แล้ว: route แกะจาก Bearer token ผ่าน lib/docver-token.ts ก่อนเรียกตรงนี้ */
-export function parseVersionUploadForm(form: FormData):
-  | { ok: true; form: ParsedVersionUploadForm }
-  | DocverError {
-  // Array.from เพราะ tsconfig ไม่ได้ตั้ง target ≥ es2015 (for...of บน iterator ต้อง
-  //  downlevelIteration — array ธรรมดาไม่ต้อง)
-  for (const key of Array.from(form.keys())) {
-    if (!(FORM_FIELDS as readonly string[]).includes(key)) {
-      return {
-        ok: false,
-        error: `ไม่รู้จัก field '${key}' (รับเฉพาะ ${FORM_FIELDS.join(", ")})`,
-      };
-    }
-  }
-
-  const clientVersionId = formString(form, "clientVersionId");
-  if (!clientVersionId.ok) return clientVersionId;
-  if (clientVersionId.value && clientVersionId.value.length > 100) {
-    return { ok: false, error: "clientVersionId ยาวเกิน 100 ตัวอักษร" };
-  }
-
-  const message = formString(form, "message");
-  if (!message.ok) return message;
-  if (message.value && message.value.length > DOCVER_MESSAGE_MAX) {
-    return { ok: false, error: `message ยาวเกิน ${DOCVER_MESSAGE_MAX} ตัวอักษร` };
-  }
-
-  const rawFields = formString(form, "fields");
-  if (!rawFields.ok) return rawFields;
-  let fields: Record<string, string> | null = null;
-  if (rawFields.value !== null) {
-    const parsed = parseFieldsJson(rawFields.value);
-    if (!parsed.ok) return parsed;
-    fields = parsed.fields;
-  }
-
-  const rawFileName = formString(form, "fileName");
-  if (!rawFileName.ok) return rawFileName;
-
-  return {
-    ok: true,
-    form: {
-      clientVersionId: clientVersionId.value,
-      message: message.value,
-      fileName: sanitizeDisplayFileName(rawFileName.value),
-      fields,
-    },
-  };
-}
-
-/** ค่า Content-Disposition ของ object ใน MinIO — presigned GET เสิร์ฟ metadata ที่ฝัง
- *  ตอน putObject จึงได้ชื่อไฟล์สวยตอนดาวน์โหลด: ASCII fallback (ตัด non-ASCII/"
- *  "/ควบคุม — เหลือไม่มีตัวอักษรเลข = ชื่อ default) + filename*=UTF-8'' สำหรับชื่อไทย */
-const DEFAULT_FILE_NAMES = { docx: "document.docx", pdf: "document.pdf" } as const;
-
-export function contentDispositionValue(displayName: string | null, kind: "docx" | "pdf"): string {
-  const ext = `.${kind}`;
-  const ascii = (displayName ?? "")
-    .replace(/[^\x20-\x7E]/g, "")
-    .replace(/["\\]/g, "")
-    .replace(/\s+/g, " ")
-    .trim();
-  let asciiName: string = DEFAULT_FILE_NAMES[kind];
-  if (/[A-Za-z0-9]/.test(ascii)) {
-    asciiName = ascii.toLowerCase().endsWith(ext) ? ascii : ascii + ext;
-  }
-  const display = displayName?.trim();
-  if (display) {
-    return `attachment; filename="${asciiName}"; filename*=UTF-8''${encodeURIComponent(display)}`;
-  }
-  return `attachment; filename="${asciiName}"`;
-}

lib/docver-store.ts

@@ -1,275 +0,0 @@
-// PLAN-DOCVER.md §2/§4/§6 — MinIO + DB ของกลุ่ม /api/documents (server-only)
-// - env อ่านตอนเรียก (ไม่ใช่ตอน module load) — ขาด/ผิด = throw ให้ route catch เป็น 500
-// - object key เป็น uuid ล้วน `docver/<versionId>/document.{docx,pdf}` ไม่มี input ผู้ใช้
-//   (เหตุผลเดียวกับ N4 ที่ห้ามชื่อผู้ใช้ตกแต่ง path) — versionId สร้างฝั่ง server แล้ว
-//   ส่งเป็น id ตอน insert เพราะ object เขียนลง MinIO ไปก่อนแล้ว
-// - เขียน DB ผ่าน route handler (carve-out ของ invariant #4 — ตารางของกลุ่มนี้ไม่มีหน้า
-//   note ใดอ่าน จึงไม่มี SSE/revalidatePath ที่ต้องทำ)
-import { and, desc, eq, sql } from "drizzle-orm";
-import { Client } from "minio";
-
-import { db } from "@/db";
-import {
-  documents,
-  documentVersions,
-  type DocumentRow,
-  type DocumentVersionRow,
-} from "@/db/schema";
-import {
-  contentDispositionValue,
-  DOCX_CONTENT_TYPE,
-  PDF_CONTENT_TYPE,
-} from "@/lib/document-versioning";
-
-type MinioConfig = {
-  endPoint: string;
-  port: number;
-  useSSL: boolean;
-  accessKey: string;
-  secretKey: string;
-  bucket: string;
-  ttlSeconds: number;
-};
-
-/** อ่าน env ทุกครั้งที่มีการเรียกใช้ — ค่าบังคับขาด = throw (route แปลงเป็น 500 กลาง ๆ
- *  ไม่บอกผู้เรียกว่า env ตัวไหนขาด — log เต็มอยู่ฝั่ง server แล้ว) */
-function readConfig(): MinioConfig {
-  const endPoint = process.env.MINIO_ENDPOINT?.trim();
-  const accessKey = process.env.MINIO_ACCESS_KEY?.trim();
-  const secretKey = process.env.MINIO_SECRET_KEY?.trim();
-  if (!endPoint || !accessKey || !secretKey) {
-    throw new Error(
-      "ตั้งค่า MINIO_ENDPOINT / MINIO_ACCESS_KEY / MINIO_SECRET_KEY ก่อนใช้ API กลุ่มเอกสาร versioning (docs/PLAN-DOCVER.md §6)",
-    );
-  }
-  const port = Number.parseInt(process.env.MINIO_PORT?.trim() ?? "", 10);
-  const ttl = Number.parseInt(process.env.DOCVER_LINK_TTL_SECONDS?.trim() ?? "", 10);
-  return {
-    endPoint,
-    port: Number.isFinite(port) && port > 0 ? port : 9000,
-    useSSL: /^(1|true|yes)$/i.test(process.env.MINIO_USE_SSL?.trim() ?? ""),
-    accessKey,
-    secretKey,
-    bucket: process.env.MINIO_BUCKET?.trim() || "docver",
-    // ไม่ให้ตั้งเกิน 7 วัน — ขอบบนของ S3 presign เอง
-    ttlSeconds:
-      Number.isFinite(ttl) && ttl > 0 ? Math.min(ttl, 7 * 24 * 60 * 60) : 900,
-  };
-}
-
-// เก็บ client/bucket บน globalThis แบบเดียวกับ db/index.ts — Next dev hot-reload
-// re-evaluate module บ่อย ไม่งั้นสะสม client จนเปลือง; key คิดจาก config ที่อ่านได้
-// ตอนนั้นเพื่อ env เปลี่ยนกลาง dev แล้ว client เก่าไม่ติดค้าง
-const globalForMinio = globalThis as unknown as {
-  docverClient?: { key: string; client: Client };
-  docverBucketReady?: { bucket: string; promise: Promise<void> };
-};
-
-function getClient(): { client: Client; config: MinioConfig } {
-  const config = readConfig();
-  const key = `${config.endPoint}|${config.port}|${config.useSSL}|${config.accessKey}`;
-  if (globalForMinio.docverClient?.key !== key) {
-    globalForMinio.docverClient = {
-      key,
-      client: new Client({
-        endPoint: config.endPoint,
-        port: config.port,
-        useSSL: config.useSSL,
-        accessKey: config.accessKey,
-        secretKey: config.secretKey,
-      }),
-    };
-  }
-  return { client: globalForMinio.docverClient.client, config };
-}
-
-/** สร้าง bucket ถ้ายังไม่มี — ครั้งเดียวต่อ process (cached promise กัน request
- *  พร้อมกันยิง makeBucket ซ้ำ) · ชน race ข้าม process (อีก process สร้างแย่งกัน)
- *  = ตรวจ bucketExists ซ้ำอีกรอบ มีแล้ว = ผ่าน · ล้มจริง = เคลียร์ cache ให้รอบหลังลองใหม่ */
-async function ensureBucket(client: Client, bucket: string): Promise<void> {
-  if (globalForMinio.docverBucketReady?.bucket !== bucket) {
-    const promise = (async () => {
-      if (await client.bucketExists(bucket)) return;
-      try {
-        await client.makeBucket(bucket);
-      } catch (err) {
-        if (!(await client.bucketExists(bucket))) throw err;
-      }
-    })();
-    globalForMinio.docverBucketReady = { bucket, promise };
-    promise.catch(() => {
-      // อย่าปล่อย rejected promise ค้างใน cache — request ถัดไปต้องได้ลองใหม่
-      if (globalForMinio.docverBucketReady?.promise === promise) {
-        globalForMinio.docverBucketReady = undefined;
-      }
-    });
-  }
-  return globalForMinio.docverBucketReady.promise;
-}
-
-/** object key ของ version หนึ่ง — uuid ล้วน ใช้ร่วมทั้งตอน put และตอน insert row */
-export function versionObjectKeys(versionId: string): { docx: string; pdf: string } {
-  return {
-    docx: `docver/${versionId}/document.docx`,
-    pdf: `docver/${versionId}/document.pdf`,
-  };
-}
-
-export type PutVersionInput = {
-  versionId: string;
-  docx: { bytes: Buffer; fileName: string | null };
-  pdf?: { bytes: Buffer; fileName: string | null };
-};
-
-/** เขียน object ของ version ลง MinIO (docx ก่อน pdf) — ฝัง Content-Type +
- *  Content-Disposition ตอน put เพื่อให้ presigned GET ได้ชื่อไฟล์สวยตอนดาวน์โหลด
- *  · pdf ล้มกลางทาง = เก็บกวาด docx ที่เขียนไปแล้ว (ไม่ให้เกิด version ครึ่ง ๆ) */
-export async function putVersionObjects(input: PutVersionInput): Promise<void> {
-  const { client, config } = getClient();
-  await ensureBucket(client, config.bucket);
-  const keys = versionObjectKeys(input.versionId);
-  await client.putObject(config.bucket, keys.docx, input.docx.bytes, input.docx.bytes.length, {
-    "Content-Type": DOCX_CONTENT_TYPE,
-    "Content-Disposition": contentDispositionValue(input.docx.fileName, "docx"),
-  });
-  if (!input.pdf) return;
-  try {
-    await client.putObject(config.bucket, keys.pdf, input.pdf.bytes, input.pdf.bytes.length, {
-      "Content-Type": PDF_CONTENT_TYPE,
-      "Content-Disposition": contentDispositionValue(input.pdf.fileName, "pdf"),
-    });
-  } catch (err) {
-    await client.removeObject(config.bucket, keys.docx).catch(() => undefined);
-    throw err;
-  }
-}
-
-/** เก็บกวาด object หลัง DB ล้ม (pattern unlink + rethrow ของ N4) — best-effort ไม่โยน:
- *  เหลือไว้ก็เป็น object ไร้ row ชี้ (key เป็น uuid ไม่ชนใคร — PLAN-DOCVER.md §4) */
-export async function removeVersionObjects(
-  versionId: string,
-  hadPdf: boolean,
-): Promise<void> {
-  try {
-    const { client, config } = getClient();
-    const keys = versionObjectKeys(versionId);
-    await client.removeObject(config.bucket, keys.docx);
-    if (hadPdf) await client.removeObject(config.bucket, keys.pdf);
-  } catch (err) {
-    console.error("docver: เก็บกวาด object หลังงานล้มไม่สำเร็จ (ไม่มีผลต่อ response)", err);
-  }
-}
-
-/** presigned GET URL อายุสั้นให้ UI เปิดในเบราว์เซอร์จริงของผู้ใช้ (webview ของ Word
- *  ทิ้ง blob download เงียบ ๆ — เหตุผลเดียวกับแผน add-in เดิม) · presign เป็นการ
- *  คำนวณ local ล้วนไม่มี network call */
-export async function presignVersionUrl(
-  versionId: string,
-  format: "docx" | "pdf",
-): Promise<{ url: string; expiresAt: string }> {
-  const { client, config } = getClient();
-  const key = versionObjectKeys(versionId)[format];
-  const url = await client.presignedGetObject(config.bucket, key, config.ttlSeconds);
-  return {
-    url,
-    expiresAt: new Date(Date.now() + config.ttlSeconds * 1000).toISOString(),
-  };
-}
-
-// ─── DB ──────────────────────────────────────────────────────────────────────
-
-export async function findDocumentByDocId(docId: string): Promise<DocumentRow | null> {
-  const [row] = await db.select().from(documents).where(eq(documents.docId, docId)).limit(1);
-  return row ?? null;
-}
-
-/** history ของเอกสาร — ใหม่ → เก่า ตาม contract ของ add-in */
-export async function listVersionsByDocId(documentId: string): Promise<DocumentVersionRow[]> {
-  return db
-    .select()
-    .from(documentVersions)
-    .where(eq(documentVersions.documentId, documentId))
-    .orderBy(desc(documentVersions.versionNumber));
-}
-
-/** หา version เดียวโดยเช็คทั้ง docId และ versionId พร้อมกัน — กันโยน id ข้ามเอกสาร */
-export async function findVersionForDoc(
-  docId: string,
-  versionId: string,
-): Promise<DocumentVersionRow | null> {
-  const [row] = await db
-    .select({ version: documentVersions })
-    .from(documentVersions)
-    .innerJoin(documents, eq(documentVersions.documentId, documents.id))
-    .where(and(eq(documents.docId, docId), eq(documentVersions.id, versionId)))
-    .limit(1);
-  return row?.version ?? null;
-}
-
-export type InsertVersionInput = {
-  /** กำหนดเอง (ไม่ปล่อย defaultRandom) เพราะ object ใน MinIO เขียนด้วย uuid นี้ไปก่อนแล้ว */
-  versionId: string;
-  docId: string;
-  clientVersionId: string | null;
-  contentHash: string;
-  message: string | null;
-  fields: Record<string, string> | null;
-  templateId: string | null;
-  fileName: string | null;
-  docxObjectKey: string;
-  pdfObjectKey: string | null;
-  docxSize: number;
-  pdfSize: number | null;
-  userId: string;
-  userName: string;
-};
-
-/** สร้าง (ถ้ายังไม่มี) เอกสาร + insert version พร้อมจ่ายเลข version ปลอดภัยเรียกคู่ขนาน
- *  (PLAN-DOCVER.md §3): ON CONFLICT DO NOTHING สร้าง row เอกสาร → SELECT … FOR UPDATE
- *  serialize ผู้จ่ายเลขรายเอกสาร (unique doc_id ได้ row เดียวเสมอ ไม่มี deadlock) →
- *  max+1 → insert (UNIQUE(document_id, version_number) เป็น safety net) */
-export async function insertVersionRecord(input: InsertVersionInput): Promise<DocumentVersionRow> {
-  return db.transaction(async (tx) => {
-    await tx
-      .insert(documents)
-      .values({ docId: input.docId })
-      .onConflictDoNothing({ target: documents.docId });
-
-    const [doc] = await tx
-      .select({ id: documents.id })
-      .from(documents)
-      .where(eq(documents.docId, input.docId))
-      .for("update");
-    if (!doc) {
-      // ไปไม่ถึงเว้นแต่ unique index หาย — เผื่อไว้ให้ error อ่านง่ายกว่า undefined
-      throw new Error("docver: ไม่พบ row เอกสารหลัง upsert (unique index documents.doc_id)");
-    }
-
-    const [latest] = await tx
-      .select({ max: sql<number | null>`max(${documentVersions.versionNumber})` })
-      .from(documentVersions)
-      .where(eq(documentVersions.documentId, doc.id));
-
-    const [row] = await tx
-      .insert(documentVersions)
-      .values({
-        id: input.versionId,
-        documentId: doc.id,
-        versionNumber: (latest?.max ?? 0) + 1,
-        clientVersionId: input.clientVersionId,
-        contentHash: input.contentHash,
-        message: input.message,
-        fields: input.fields,
-        templateId: input.templateId,
-        fileName: input.fileName,
-        docxObjectKey: input.docxObjectKey,
-        pdfObjectKey: input.pdfObjectKey,
-        docxSize: input.docxSize,
-        pdfSize: input.pdfSize,
-        userId: input.userId,
-        userName: input.userName,
-      })
-      .returning();
-    return row!;
-  });
-}

lib/docver-token.ts

@@ -1,223 +0,0 @@
-// PLAN-DOCVER.md §auth — access_token ของกลุ่ม /api/documents (document versioning)
-// - POST /api/documents/token ออก JWT HS256 ให้ผู้เรียกที่ยืนยัน header "x-api-key"
-//   กับ env DOCVER_API_KEY (fail closed เมื่อ env ไม่ตั้ง/ว่าง — pattern เดียวกับ
-//   lib/external-api-auth.ts ของ N10: hash SHA-256 ทั้งสองค่า + timingSafeEqual,
-//   ข้อความ 401 ของ "ไม่ใส่ key" กับ "key ผิด" เป็นอันเดียวกัน, ห้าม log ค่าดิบ)
-// - token เซ็นด้วย env DOCVER_TOKEN_SECRET (มือเขียน HS256 ผ่าน node:crypto ล้วน —
-//   ไม่เพิ่ม dependency) แล้วทุก endpoint อื่นของกลุ่มบังคับ Authorization: Bearer —
-//   identity (userid/username) กับ templateId แกะจาก claims ไม่รับจาก payload
-// - claims "fid" = fileId ของ e-Court (string) — เป็น docId ของทุก operation ตรง ๆ
-//   — บังคับตั้งแต่ขอ token และ verify ไม่รับ token ที่ไม่มี fid
-//
-// ห้าม import อะไรที่ลาก @/db หรือ minio มาด้วย — unit test (tests/lib/) ต้องรันได้
-// โดยไม่ต้องตั้ง DATABASE_URL/MINIO_* (pattern เดียวกับ lib/external-api-auth.ts)
-import { createHash, createHmac, timingSafeEqual } from "node:crypto";
-
-import { docverError, type DocverError } from "@/lib/document-versioning";
-
-/** claims ของ access_token docver — โครงสร้างตามผู้เรียกกำหนด (e-Court) */
-export type DocverTokenClaims = {
-  userid: string;
-  username: string;
-  fid: string;
-  template: string | null;
-};
-
-function base64url(input: string): string {
-  return Buffer.from(input, "utf8").toString("base64url");
-}
-
-function decodeJsonSegment(segment: string): Record<string, unknown> | null {
-  let text: string;
-  try {
-    text = Buffer.from(segment, "base64url").toString("utf8");
-  } catch {
-    return null;
-  }
-  try {
-    const parsed = JSON.parse(text) as unknown;
-    if (
-      parsed === null ||
-      typeof parsed !== "object" ||
-      Array.isArray(parsed)
-    ) {
-      return null;
-    }
-    return parsed as Record<string, unknown>;
-  } catch {
-    return null;
-  }
-}
-
-/** ออก JWT HS256 (base64url 3 segment) — payload = claims + iat/exp (วินาที) */
-export function issueDocverToken(
-  claims: DocverTokenClaims,
-  secret: string,
-  ttlSeconds: number,
-): string {
-  const header = base64url(JSON.stringify({ alg: "HS256", typ: "JWT" }));
-  const iat = Math.floor(Date.now() / 1000);
-  const payload = base64url(
-    JSON.stringify({ ...claims, iat, exp: iat + ttlSeconds }),
-  );
-  const signature = createHmac("sha256", secret)
-    .update(`${header}.${payload}`)
-    .digest("base64url");
-  return `${header}.${payload}.${signature}`;
-}
-
-/** claims ที่ถอดได้จาก payload ที่ตรวจ signature ผ่านแล้ว — รูปร่างผิด = invalid
- *  (กัน token ที่เซ็นถูกแต่ claims ไม่ครบ/ผิด type หลุดไปใช้ต่อ) */
-function claimsFromPayload(
-  payload: Record<string, unknown>,
-): DocverTokenClaims | null {
-  const { userid, username, fid, template } = payload;
-  if (typeof userid !== "string" || userid === "") return null;
-  if (typeof username !== "string" || username === "") return null;
-  if (typeof fid !== "string" || fid === "") return null;
-  if (template !== null && typeof template !== "string") return null;
-  return { userid, username, fid, template };
-}
-
-/** ตรวจ token: 3 segment → alg บังคับ HS256 (กัน alg-confusion เช่น "none") →
- *  เทียบ signature แบบ timing-safe (hash ทั้งสองฝั่งก่อน — digest ยาวเท่ากันเสมอ) →
- *  exp ต้องยังไม่ผ่านมาแล้ว → claims ต้องครบรูปร่าง */
-export function verifyDocverToken(
-  token: string,
-  secret: string,
-): { ok: true; claims: DocverTokenClaims } | { ok: false } {
-  const segments = token.split(".");
-  if (segments.length !== 3) return { ok: false };
-  const [headerSegment, payloadSegment, signatureSegment] = segments;
-
-  const header = decodeJsonSegment(headerSegment);
-  if (header === null || header.alg !== "HS256") return { ok: false };
-
-  const expected = createHmac("sha256", secret)
-    .update(`${headerSegment}.${payloadSegment}`)
-    .digest();
-  // ถอด base64url กลับเป็น byte ดิบของ signature ก่อน — แล้ว hash ทั้งสองฝั่ง
-  // (SHA-256 = 32 byte เท่ากันเสมอ แม้ segment จะเป็นขยะ decode ได้สั้น/ว่าง —
-  // timingSafeEqual จึงไม่ throw เรื่องความยาวต่างกัน)
-  const provided = createHash("sha256")
-    .update(Buffer.from(signatureSegment, "base64url"))
-    .digest();
-  const expectedHash = createHash("sha256").update(expected).digest();
-  if (!timingSafeEqual(provided, expectedHash)) return { ok: false };
-
-  const payload = decodeJsonSegment(payloadSegment);
-  if (payload === null) return { ok: false };
-  const exp = payload.exp;
-  if (typeof exp !== "number" || !Number.isFinite(exp)) return { ok: false };
-  if (exp <= Math.floor(Date.now() / 1000)) return { ok: false };
-
-  const claims = claimsFromPayload(payload);
-  if (claims === null) return { ok: false };
-  return { ok: true, claims };
-}
-
-/** auth ของ POST /api/documents/token — mirror requireExternalApiKey (N10) แต่
- *  env เป็น DOCVER_API_KEY และตอบผ่าน docverError ของกลุ่มนี้
- *  คืน null เมื่อผ่าน / Response 401 เมื่อไม่ผ่าน */
-export function requireDocverApiKey(request: Request): Response | null {
-  // เทียบกับค่า trim แล้ว — กัน trailing newline จาก K8s secret / docker env_file
-  const envKey = process.env.DOCVER_API_KEY?.trim();
-  // const envKey =
-  //   "2d9b76d49a4f5311f6a0dacf759ecec53f34b6d102f24c696890a4052c99cf54";
-  if (envKey === undefined || envKey === "") {
-    return docverError("ระบบยังไม่ได้ตั้งค่า API key", 401);
-  }
-  const provided = request.headers.get("x-api-key");
-  if (provided === null || provided === "") {
-    return docverError("API key ไม่ถูกต้อง", 401);
-  }
-  const providedHash = createHash("sha256").update(provided).digest();
-  const envHash = createHash("sha256").update(envKey).digest();
-  return timingSafeEqual(providedHash, envHash)
-    ? null
-    : docverError("API key ไม่ถูกต้อง", 401);
-}
-
-/** 401 เดียวสำหรับทุกกรณี — ไม่แยกสาเหตุ (ไม่มี header / รูปผิด / signature ผิด /
- *  หมดอายุ / secret ไม่ตั้ง) กันใช้ endpoint เป็น oracle สำรวจ */
-const BEARER_DENIED = "โทเคนไม่ถูกต้องหรือหมดอายุ";
-
-/** บังคับ Authorization: Bearer <token> ของกลุ่ม docver — เรียกเป็นอย่างแรกของ
- *  ทุก endpoint ก่อน parse path param · env DOCVER_TOKEN_SECRET ไม่ตั้ง = ไม่มี
- *  token ใดผ่าน (fail closed — ไม่ใช่ 500 เพราะไม่ใช่ความผิดของผู้เรียก) */
-export function requireDocverBearer(
-  request: Request,
-): { ok: true; claims: DocverTokenClaims } | { ok: false; response: Response } {
-  const denied = () =>
-    ({ ok: false, response: docverError(BEARER_DENIED, 401) }) as const;
-  const secret = process.env.DOCVER_TOKEN_SECRET?.trim();
-  // const secret =
-  //   "487023dd1c1c4d6a07475e96b1cc300fec1e68ac9c2dd7d5ac9b1bf75da1053e";
-  if (secret === undefined || secret === "") return denied();
-  const header = request.headers.get("authorization");
-  if (header === null) return denied();
-  const match = /^Bearer\s+(\S+)$/i.exec(header);
-  if (match === null) return denied();
-  const verified = verifyDocverToken(match[1], secret);
-  if (!verified.ok) return denied();
-  return { ok: true, claims: verified.claims };
-}
-
-/** body ของ POST /api/documents/token — strict allowlist กัน typo เงียบ ๆ ตาม
- *  convention ของกลุ่ม (key อื่น = 400) · trim-ว่าง = ถือว่าไม่ส่ง */
-const TOKEN_BODY_FIELDS = ["userid", "username", "fid", "template"] as const;
-
-export function parseTokenRequestBody(
-  raw: unknown,
-): { ok: true; claims: DocverTokenClaims } | DocverError {
-  if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
-    return { ok: false, error: "body ต้องเป็น JSON object" };
-  }
-  const record = raw as Record<string, unknown>;
-  for (const key of Object.keys(record)) {
-    if (!(TOKEN_BODY_FIELDS as readonly string[]).includes(key)) {
-      return {
-        ok: false,
-        error: `ไม่รู้จัก field '${key}' (รับเฉพาะ ${TOKEN_BODY_FIELDS.join(", ")})`,
-      };
-    }
-  }
-
-  const rawUserid = record.userid;
-  if (typeof rawUserid !== "string" || rawUserid.trim() === "") {
-    return { ok: false, error: "ต้องระบุ userid (string)" };
-  }
-  const userid = rawUserid.trim();
-  if (userid.length > 100) {
-    return { ok: false, error: "userid ยาวเกิน 100 ตัวอักษร" };
-  }
-
-  const rawUsername = record.username;
-  if (typeof rawUsername !== "string" || rawUsername.trim() === "") {
-    return { ok: false, error: "ต้องระบุ username (string)" };
-  }
-  const username = rawUsername.trim();
-  if (username.length > 200) {
-    return { ok: false, error: "username ยาวเกิน 200 ตัวอักษร" };
-  }
-
-  const rawFid = record.fid;
-  if (typeof rawFid !== "string" || rawFid.trim() === "") {
-    return { ok: false, error: "ต้องระบุ fid (string)" };
-  }
-  const fid = rawFid.trim();
-  if (fid.length > 200) {
-    return { ok: false, error: "fid ยาวเกิน 200 ตัวอักษร" };
-  }
-
-  const rawTemplate = record.template ?? null;
-  if (rawTemplate !== null && typeof rawTemplate !== "string") {
-    return { ok: false, error: "template ต้องเป็น string" };
-  }
-  const template = rawTemplate?.trim() || null;
-  if (template !== null && template.length > 100) {
-    return { ok: false, error: "template ยาวเกิน 100 ตัวอักษร" };
-  }
-
-  return { ok: true, claims: { userid, username, fid, template } };
-}

lib/lib-utils.ts

@@ -1,112 +0,0 @@
-
-import { createHmac, createPrivateKey, createPublicKey, timingSafeEqual, verify, sign } from 'node:crypto';
-/**
- * คำนวณ HMAC-SHA256 จาก string หรือ JSON Object
- */
-export function generateHmacSha256(data: string | object, secretKey: string): string {
-  const payload = typeof data === 'string' ? data : JSON.stringify(data);
-  return createHmac('sha256', secretKey)
-    .update(payload, 'utf8')
-    .digest('hex');
-}
-
-/**
- * ตรวจสอบความถูกต้องของ HMAC (ใช้ timingSafeEqual เพื่อป้องกัน Timing Attacks)
- */
-export function verifyHmacSha256(data: string | object, secretKey: string, expectedHmac: string): boolean {
-  const calculatedHmac = generateHmacSha256(data, secretKey);
-  const a = Buffer.from(calculatedHmac, 'hex');
-  const b = Buffer.from(expectedHmac, 'hex');
-
-  if (a.length !== b.length) {
-    return false;
-  }
-  return timingSafeEqual(a, b);
-}
-// ==========================================
-// ตัวอย่างการใช้งาน
-// ==========================================
-/*
-const secret = 'my-super-secret-key';
-const jsonData = {
-  userId: 12345,
-  action: 'transfer',
-  amount: 500
-};
-
-// 1. สร้าง HMAC
-const hmacSignature = generateHmacSha256(jsonData, secret);
-console.log('HMAC Signature (Hex):', hmacSignature);
-
-// 2. ตรวจสอบ HMAC
-const isValid = verifyHmacSha256(jsonData, secret, hmacSignature);
-console.log('Is Signature Valid?:', isValid); // true
-*/
-
-
-/**
- * ฟังก์ชันสำหรับลงนามดิจิทัล (Sign) ข้อมูลด้วย Ed25519 Private Key (Hex)
- * @param message ข้อความดิบที่ต้องการเซ็น (string หรือ Buffer)
- * @param privateKeyHex คีย์ลับในรูปแบบ Hex String (ความยาว 64 ตัวอักษร)
- * @returns ลายเซ็น (Signature) ในรูปแบบ Hex String (ความยาว 128 ตัวอักษร)
- */
-export function signDataEd25519(message: string | Buffer, privateKeyHex: string): string {
-  const rawKeyBuffer = Buffer.from(privateKeyHex, 'hex');
-    // ตัดเอาเฉพาะ 32 bytes (Seed) กรณีที่ Hex ยาว 64 bytes (ที่ต่อกับ Public Key มา)
-  const seed = rawKeyBuffer.length === 64 ? rawKeyBuffer.subarray(0, 32) : rawKeyBuffer;
-  // PKCS#8 Header สำหรับ Ed25519 Private Key
-  const pkcs8Header = Buffer.from('302e020100300506032b657004220420', 'hex');
-  const pkcs8Buffer = Buffer.concat([pkcs8Header, seed]);
-
-  const privateKey = createPrivateKey({
-    key: pkcs8Buffer,
-    format: 'der',
-    type: 'pkcs8',
-  });
-
-  const dataBuffer = typeof message === 'string' ? Buffer.from(message, 'utf-8') : message;
-  const signatureBuffer = sign(null, dataBuffer, privateKey);
-  return signatureBuffer.toString('hex');
-}
-
-/**
- * ฟังก์ชันสำหรับตรวจสอบลายเซ็น (Verify) ด้วย Ed25519 Public Key (Hex)
- * @param message ข้อความดิบที่ใช้ในการเซ็น (string หรือ Buffer)
- * @param signatureHex ลายเซ็นในรูปแบบ Hex String
- * @param publicKeyHex คีย์สาธารณะในรูปแบบ Hex String (ความยาว 64 ตัวอักษร)
- * @returns ผลลัพธ์ความถูกต้อง (true = ผ่าน, false = ไม่ผ่าน)
- */
-export function verifyDataEd25519(message: string | Buffer, signatureHex: string, publicKeyHex: string): boolean {
-  try {
-    const rawPublicKey = Buffer.from(publicKeyHex, 'hex');
-
-    // SPKI Header สำหรับ Ed25519 Public Key (32 bytes)
-    const spkiHeader = Buffer.from('302a300506032b6570032100', 'hex');
-    const spkiBuffer = Buffer.concat([spkiHeader, rawPublicKey]);
-
-    const publicKey = createPublicKey({
-      key: spkiBuffer,
-      format: 'der',
-      type: 'spki',
-    });
-
-  const dataBuffer = typeof message === 'string' ? Buffer.from(message, 'utf-8') : message;
-    const signatureBuffer = Buffer.from(signatureHex, 'hex');
-
-    return verify(null, dataBuffer, publicKey, signatureBuffer);
-  } catch (error) {
-    return false;
-  }
-}
-
-/**
- * ฟังก์ชันสำหรับเรียงคีย์ของ Object ตามตัวอักษรเพื่อไม่ให้โครงสร้าง JSON เพี้ยน
- */
-export function sortObjectKeys(obj: Record<string, unknown>): Record<string, unknown> {
-  return Object.keys(obj)
-    .sort()
-    .reduce((result: Record<string, unknown>, key: string) => {
-      result[key] = obj[key];
-      return result;
-    }, {});
-}

lib/openapi.ts

@@ -1,6 +1,5 @@
 // OpenAPI 3.0 spec ของ API ทดสอบทั้งหมดของ judes-note — เส้นเดียวกับที่ Swagger UI
-// แสดงผล: กลุ่ม template (DOCX Content Control) + N10 external API + docver
+// แสดงผล: กลุ่ม template (DOCX Content Control) + N10 external API
-// (จัด version เอกสาร)
 // route handler GET /api/swagger (app/api/swagger/route.ts) เป็นคนเดียวที่ใช้
 // — inline เป็น JSON ลงใน HTML ตอน respond (ไม่มี endpoint spec แยก)
 //
@@ -24,8 +23,8 @@ export const openApiSpec = {
     title: "Document Template & External API ของระบบ Judge's Note",
     version: "1.0.0",
     description:
-      "API ทดสอบของระบบ Judge's Note — กลุ่ม Template (DOCX Content Control), " +
+      "API ทดสอบของระบบ Judge's Note — กลุ่ม Template (DOCX Content Control) " +
-      "API ภายนอกสำหรับ backend e-Court (N10) และ API จัด version เอกสาร (docver)",
+      "และ API ภายนอกสำหรับ backend e-Court (N10)",
   },
   servers: [{ url: BASE_PATH, description: "origin เดียวกับหน้านี้ (basePath /docedit)" }],
   tags: [
@@ -35,16 +34,6 @@ export const openApiSpec = {
         "Template เอกสาร DOCX ด้วย Content Control — ส่ง template (.docx) + data (JSON) " +
         "แล้วได้เอกสารที่กรอกค่าแล้วกลับมา",
     },
-    {
-      name: "documents",
-      description:
-        "จัด version เอกสาร (docver — docs/PLAN-DOCVER.md): เอกสารเดียวต่อ docId แต่ละ " +
-        "version เก็บ .docx + .pdf ใน MinIO พร้อมผู้อัปโหลด — auth ด้วย access_token " +
-        "ของกลุ่มนี้: ขอที่ POST /api/documents/token (ยืนยัน x-api-key กับ env " +
-        "DOCVER_API_KEY) แล้วแนบ Authorization: Bearer ทุก request — identity/template " +
-        "และ docId (= fid — fileId ของ e-Court, string) แกะจาก claims ของ token ทั้งหมด " +
-        "ไม่รับจาก URL/multipart form อีก",
-    },
     {
       name: "Judge's Note",
       description:
@@ -95,20 +84,6 @@ export const openApiSpec = {
                     format: "binary",
                     description: "ไฟล์ .docx ที่มี Content Control",
                   },
-                  secret: {
-                    type: "string",
-                    description:
-                      "ค่า secret สำหรับ validate HMAC-SHA256 กับข้อมูลใน custom property" ,
-                    example:
-                      "super_secret",
-                  },
-                  public_key: {
-                    type: "string",
-                    description:
-                      "Public key ในรูปแบบ HEX <br/> openssl genpkey -algorithm ED25519 -out private.pem <br/> openssl pkey -in private.pem -outform DER | tail -c 32 | xxd -p -c 32 > private.hex <br/>openssl pkey -in private.pem -pubout -outform DER | tail -c 32 | xxd -p -c 32 > public.hex",
-                    example:
-                      "66b09b4a1b66271d5728c592c2409657e1c070a7bf371bf9f6ed457855270546",
-                  },
                 },
               },
             },
@@ -157,23 +132,9 @@ export const openApiSpec = {
                   dataJson: {
                     type: "string",
                     description:
-                      "JSON เป็น string ตรง ๆ (ทางเลือกแทนการแนบไฟล์ data)<br/>{\"info:\"{\"ticket_data\":\"JSON String\"},\"dc:\"{..},\"dc:\"{\"blackyear\": \"๙๐/๒๕๖๙\",...}}",
+                      "JSON เป็น string ตรง ๆ (ทางเลือกแทนการแนบไฟล์ data)",
                     example:
-                      '',
+                      '{"notname":"คำสั่งเรียก ให้ทำคำให้การ","blackno":"คดีหมายเลขดำที่","blackyear":"๑๐/๒๕๖๙"}',
-                  },
-                  secret: {
-                    type: "string",
-                    description:
-                      "ค่า secret สำหรับทดสอบการทำ HMAC-SHA256",
-                    example:
-                      'super_secret',
-                  },
-                  private_key: {
-                    type: "string",
-                    description:
-                      "Private key ในรูปแบบ HEX <br/> openssl genpkey -algorithm ED25519 -out private.pem <br/> openssl pkey -in private.pem -outform DER | tail -c 32 | xxd -p -c 32 > private.hex <br/>openssl pkey -in private.pem -pubout -outform DER | tail -c 32 | xxd -p -c 32 > public.hex",
-                    example:
-                      '8f2077b57b39399b6a7828f35da03a63ade8e3a36a6bf437b091a8bdb3d18ee1',
                   },
                 },
               },
@@ -256,220 +217,6 @@ export const openApiSpec = {
         },
       },
     },
-    "/api/documents/token": {
-      post: {
-        tags: ["documents"],
-        summary: "ขอ access_token ของกลุ่ม documents (docver)",
-        description:
-          "ออก access_token ใช้กับ endpoint อื่นของกลุ่ม documents เท่านั้น — token เป็น " +
-          "JWT HS256 ฝัง claims {userid, username, fid, template} ตามที่ส่งมา อายุตาม env " +
-          "DOCVER_TOKEN_TTL_SECONDS (default 3600 วินาที) · identity (userId/userName), " +
-          "templateId และ docId (= fid) ตอนทำงานแกะจาก claims ของ token นี้ — " +
-          "fid จึงบังคับ",
-        security: [{ ApiKeyAuth: [] }],
-        requestBody: {
-          required: true,
-          content: {
-            "application/json": {
-              schema: { $ref: "#/components/schemas/TokenRequest" },
-              examples: {
-                "ครบทุก claim": {
-                  value: {
-                    userid: "123",
-                    username: "Sorawit Bholsithi",
-                    fid: "3",
-                    template: "T12",
-                  },
-                },
-                "ขั้นต่ำ (template เป็นทางเลือก)": {
-                  value: { userid: "123", username: "Sorawit Bholsithi", fid: "3" },
-                },
-              },
-            },
-          },
-        },
-        responses: {
-          200: {
-            description: "access_token พร้อมใช้ (แนบเป็น Authorization: Bearer ทุก request ถัดไป)",
-            content: {
-              "application/json": {
-                schema: { $ref: "#/components/schemas/TokenResponse" },
-              },
-            },
-          },
-          400: { $ref: "#/components/responses/BadRequest" },
-          401: {
-            description: "ไม่ได้ส่ง header x-api-key หรือค่าไม่ถูกต้อง (env DOCVER_API_KEY)",
-            content: {
-              "application/json": {
-                schema: { $ref: "#/components/schemas/Error" },
-              },
-            },
-          },
-          500: { $ref: "#/components/responses/ServerError" },
-        },
-      },
-    },
-    "/api/documents/versions": {
-      post: {
-        tags: ["documents"],
-        summary: "อัปโหลด version ใหม่ของเอกสาร (docx + pdf)",
-        description:
-          "เอกสารถูกระบุด้วย fid ใน Bearer token (docId = fid) — สร้างเอกสาร " +
-          "อัตโนมัติเมื่อ docId ยังไม่เคยมี แล้วเก็บไฟล์ .docx (+ .pdf ถ้าแนบมา) ลง MinIO " +
-          "พร้อมผู้อัปโหลด — versionNumber ที่ server จ่ายคือค่าจริงเสมอ (client ที่เลขไม่ตรง " +
-          "ต้องแก้ XML part ของตัวเอง) · pdf เป็น optional: ไม่แนบ/ไฟล์เปล่า = version นี้ไม่มี " +
-          "สำเนา PDF (ดู hasPdf ใน response) · ผู้อัปโหลด (userId/userName) และ templateId " +
-          "แกะจาก Bearer token ไม่รับใน form (ส่ง field เหล่านั้นมา = 400)",
-        security: [{ DocverBearer: [] }],
-        requestBody: {
-          required: true,
-          content: {
-            "multipart/form-data": {
-              schema: {
-                type: "object",
-                required: ["file"],
-                properties: {
-                  file: {
-                    type: "string",
-                    format: "binary",
-                    description: "ไฟล์ .docx ของ version นี้ (บังคับ)",
-                  },
-                  pdf: {
-                    type: "string",
-                    format: "binary",
-                    description:
-                      "ไฟล์ .pdf ของ version นี้ (optional — ไม่แนบหรือไฟล์เปล่า = ไม่มี)",
-                  },
-                  clientVersionId: {
-                    type: "string",
-                    description: "GUID ที่ client generate ก่อนเรียก (เก็บไว้สืบสวน ไม่ใช่ identity)",
-                  },
-                  fields: {
-                    type: "string",
-                    description:
-                      'JSON string ของค่า Content Control เช่น {"blackno":"คดีหมายเลขดำที่"}',
-                  },
-                  message: {
-                    type: "string",
-                    description: "commit message ของ version (≤ 2048 ตัวอักษร)",
-                  },
-                  fileName: {
-                    type: "string",
-                    description:
-                      "ชื่อไฟล์สำหรับแสดงตอนดาวน์โหลด (ไม่ส่ง = ใช้ชื่อไฟล์ที่แนบ)",
-                  },
-                },
-              },
-            },
-          },
-        },
-        responses: {
-          200: {
-            description: "version ถูกบันทึกแล้ว",
-            content: {
-              "application/json": {
-                schema: { $ref: "#/components/schemas/UploadVersionResult" },
-              },
-            },
-          },
-          400: { $ref: "#/components/responses/BadRequest" },
-          401: { $ref: "#/components/responses/DocverUnauthorized" },
-          413: {
-            description: "ไฟล์แนบใหญ่เกิน 100MB",
-            content: {
-              "application/json": {
-                schema: { $ref: "#/components/schemas/Error" },
-              },
-            },
-          },
-          500: { $ref: "#/components/responses/ServerError" },
-        },
-      },
-      get: {
-        tags: ["documents"],
-        summary: "รายการ version ทั้งหมดของเอกสาร (ใหม่ → เก่า)",
-        description:
-          "เอกสารถูกระบุด้วย fid ใน Bearer token (docId = fid) — version ทุกตัว " +
-          "ของเอกสารนั้น พร้อมผู้อัปโหลด (userId/userName), เวลา, commit message, ค่า fields " +
-          "และ hasPdf — ใช้เขียน UI version history ของ add-in",
-        security: [{ DocverBearer: [] }],
-        responses: {
-          200: {
-            description: "รายการ version เรียงใหม่ → เก่า",
-            content: {
-              "application/json": {
-                schema: {
-                  type: "array",
-                  items: { $ref: "#/components/schemas/VersionRecord" },
-                },
-              },
-            },
-          },
-          400: { $ref: "#/components/responses/BadRequest" },
-          401: { $ref: "#/components/responses/DocverUnauthorized" },
-          404: {
-            description: "ไม่พบเอกสารนี้ในระบบ (ยังไม่เคยอัปโหลด version)",
-            content: {
-              "application/json": {
-                schema: { $ref: "#/components/schemas/Error" },
-              },
-            },
-          },
-          500: { $ref: "#/components/responses/ServerError" },
-        },
-      },
-    },
-    "/api/documents/versions/{versionId}/download-link": {
-      get: {
-        tags: ["documents"],
-        summary: "ขอ presigned URL ดาวน์โหลดไฟล์ของ version (docx/pdf)",
-        description:
-          "เอกสารถูกระบุด้วย fid ใน Bearer token (docId = fid) · คืน URL อายุสั้น " +
-          "(env DOCVER_LINK_TTL_SECONDS, default 900 วินาที) ให้เปิดในเบราว์เซอร์/Word ของ " +
-          "ผู้ใช้ — URL อ้าง endpoint MinIO ตรง ๆ จึงต้องเป็นโฮสต์ที่ผู้ใช้เข้าถึงได้ · ขอ pdf " +
-          "ใน version ที่ไม่มีสำเนา = 404",
-        security: [{ DocverBearer: [] }],
-        parameters: [
-          {
-            name: "versionId",
-            in: "path",
-            required: true,
-            schema: { type: "string", format: "uuid" },
-            description: "id ของ version (field versionId ใน VersionRecord)",
-          },
-          {
-            name: "format",
-            in: "query",
-            required: false,
-            schema: { type: "string", enum: ["docx", "pdf"], default: "docx" },
-            description: "ชนิดไฟล์ที่จะดาวน์โหลด (ไม่ส่ง = docx)",
-          },
-        ],
-        responses: {
-          200: {
-            description: "presigned URL พร้อมเวลาหมดอายุ",
-            content: {
-              "application/json": {
-                schema: { $ref: "#/components/schemas/DownloadLink" },
-              },
-            },
-          },
-          400: { $ref: "#/components/responses/BadRequest" },
-          401: { $ref: "#/components/responses/DocverUnauthorized" },
-          404: {
-            description:
-              "ไม่พบ version นี้ของเอกสาร หรือขอ format=pdf ใน version ที่ไม่มีสำเนา PDF",
-            content: {
-              "application/json": {
-                schema: { $ref: "#/components/schemas/Error" },
-              },
-            },
-          },
-          500: { $ref: "#/components/responses/ServerError" },
-        },
-      },
-    },
   },
   components: {
     securitySchemes: {
@@ -478,17 +225,7 @@ export const openApiSpec = {
         in: "header",
         name: "x-api-key",
         description:
-          "x-api-key ของ N10 = env EXTERNAL_API_KEY · ของการขอ token กลุ่ม documents = env " +
+          "ค่าเดียวกับ env EXTERNAL_API_KEY ของ server — กดปุ่ม Authorize ด้านบนเพื่อใส่ครั้งเดียวแล้วใช้ทุก request",
-          "DOCVER_API_KEY (คนละค่ากับของ N10 — กดปุ่ม Authorize ใส่ครั้งเดียวแล้วใช้ได้ทุก " +
-          "request ของกลุ่มที่ key ตรง)",
-      },
-      DocverBearer: {
-        type: "http",
-        scheme: "bearer",
-        bearerFormat: "JWT",
-        description:
-          "access_token จาก POST /api/documents/token — แนบเป็น Authorization: Bearer " +
-          "กับ endpoint อื่นของกลุ่ม documents ทุกตัว",
       },
     },
     responses: {
@@ -502,15 +239,6 @@ export const openApiSpec = {
           },
         },
       },
-      DocverUnauthorized: {
-        description:
-          "ไม่ได้แนบ Authorization: Bearer หรือ token ไม่ถูกต้อง/หมดอายุ (กลุ่ม documents — ข้อความเดียวกันทุกสาเหตุ)",
-        content: {
-          "application/json": {
-            schema: { $ref: "#/components/schemas/Error" },
-          },
-        },
-      },
       ServerError: {
         description: "เกิดข้อผิดพลาดของระบบ (เช่นไฟล์ .docx ไม่ถูกต้อง / DB ล้ม)",
         content: {
@@ -528,38 +256,6 @@ export const openApiSpec = {
           error: { type: "string" },
         },
       },
-      TokenRequest: {
-        type: "object",
-        description: "claims ที่จะฝังใน access_token ของกลุ่ม documents — key อื่น = 400",
-        required: ["userid", "username", "fid"],
-        properties: {
-          userid: { type: "string", description: "รหัสผู้ใช้ (บังคับ, ≤ 100 ตัวอักษร)" },
-          username: { type: "string", description: "ชื่อผู้ใช้ (บังคับ, ≤ 200 ตัวอักษร)" },
-          fid: {
-            type: "string",
-            description:
-              "fileId ของ e-Court (บังคับ, ≤ 200 ตัวอักษร) — เป็น docId ของทุก operation ตรง ๆ",
-          },
-          template: {
-            type: "string",
-            nullable: true,
-            description:
-              "รหัส template ที่ใช้สร้างเอกสาร — กลายเป็น templateId ตอนอัปโหลด version",
-          },
-        },
-      },
-      TokenResponse: {
-        type: "object",
-        description: "access_token ของกลุ่ม documents (JWT HS256 อายุสั้น)",
-        properties: {
-          access_token: { type: "string", description: "JWT พร้อมใช้แนบเป็น Bearer" },
-          token_type: { type: "string", example: "Bearer" },
-          expires_in: {
-            type: "integer",
-            description: "อายุวินาที (env DOCVER_TOKEN_TTL_SECONDS, default 3600)",
-          },
-        },
-      },
       ExtractResponse: {
         type: "object",
         properties: {
@@ -711,48 +407,6 @@ export const openApiSpec = {
           createdAt: { type: "string", format: "date-time" },
         },
       },
-      UploadVersionResult: {
-        type: "object",
-        description: "ตอบกลับหลังอัปโหลด version สำเร็จ",
-        properties: {
-          hasPdf: { type: "boolean", description: "true = version นี้มีสำเนา PDF" },
-          versionId: { type: "string", format: "uuid" },
-          versionNumber: {
-            type: "integer",
-            description: "เลข version ที่ server จ่าย (ค่าจริง — ไม่ใช่ที่ client คาด)",
-          },
-        },
-      },
-      VersionRecord: {
-        type: "object",
-        description: "รายการ version หนึ่งตัว (GET /versions คืนเป็น array ใหม่ → เก่า)",
-        properties: {
-          versionId: { type: "string", format: "uuid" },
-          versionNumber: { type: "integer" },
-          createdAt: { type: "string", format: "date-time" },
-          createdByUserId: { type: "string" },
-          createdByUserName: { type: "string" },
-          contentHash: {
-            type: "string",
-            description: "SHA-256 hex ของไฟล์ .docx (คำนวณฝั่ง server เสมอ)",
-          },
-          fields: {
-            type: "object",
-            nullable: true,
-            description: "ค่า Content Control ตอนอัปโหลด (ไม่ส่ง = null)",
-            additionalProperties: { type: "string" },
-          },
-          message: { type: "string", nullable: true, description: "commit message" },
-          hasPdf: { type: "boolean" },
-        },
-      },
-      DownloadLink: {
-        type: "object",
-        properties: {
-          url: { type: "string", description: "presigned URL ของ MinIO (GET โดยตรง)" },
-          expiresAt: { type: "string", format: "date-time" },
-        },
-      },
     },
   },
 } as const;

middleware.ts

@@ -23,9 +23,7 @@ export function middleware(req: NextRequest) {
 
 // ยกเว้น: หน้า login เอง, API/SSE/export (อยู่ใต้ api/note/**), API template
 // (api/template/** — เปิดกว้างให้ทางศาล/ผู้ทดสอบภายนอกยิงได้เลย ไม่แตะ DB
-// ไม่มีข้อมูลรับ), API เอกสาร versioning (api/documents/** — กลุ่ม docver
+// ไม่มีข้อมูลรับ), หน้า Swagger UI (api/swagger — document ของทุกกลุ่ม),
-// stand-alone ของ wordaddin: ไม่มี session ผู้เรียกบอก userId/userName เอง —
-// docs/PLAN-DOCVER.md), หน้า Swagger UI (api/swagger — document ของทุกกลุ่ม),
 // taskpane ของ wordaddin (wordaddin/** — รันใน webview ของ Word ไม่มี cookie
 // oacCase และมี auth ของตัวเองแยกจากแอป note), ไฟล์อัปโหลด, Next internal,
 // และ static ใน public/note/ (pdf.worker, samples, asset Swagger UI)
@@ -37,6 +35,6 @@ export function middleware(req: NextRequest) {
 // ยังถูกคุมอยู่ดีเพราะ root page ส่งต่อให้ /note ซึ่ง middleware จับตามปกติ
 export const config = {
   matcher: [
-    "/((?!note/login|api/note|api/template|api/documents|api/swagger|tmpl|wordaddin|note/uploads|note/samples|note/swagger-ui|note/pdf\\.worker\\.min\\.mjs|_next|fonts|favicon\\.ico).+)",
+    "/((?!note/login|api/note|api/template|api/swagger|wordaddin|note/uploads|note/samples|note/swagger-ui|note/pdf\\.worker\\.min\\.mjs|_next|fonts|favicon\\.ico).+)",
   ],
 };

package-lock.json

@@ -11,10 +11,8 @@
       "dependencies": {
         "@pdf-lib/fontkit": "^1.1.1",
         "@xmldom/xmldom": "^0.9.12",
-        "docx-templates": "^4.15.0",
         "drizzle-orm": "^0.45.2",
         "lucide-react": "^1.42.0",
-        "minio": "^8.0.7",
         "next": "^14.2.35",
         "pdf-lib": "^1.17.1",
         "pdfjs-dist": "^4.10.38",
@@ -28,7 +26,7 @@
         "xpath": "^0.0.34"
       },
       "devDependencies": {
-        "@types/node": "^26.6.5",
+        "@types/node": "^26.5.0",
         "@types/office-js": "^1.0.612",
         "@types/pngjs": "^6.0.5",
         "@types/react": "^18.3.31",
@@ -3827,6 +3825,7 @@
       "version": "3.1.0",
       "resolved": "https://registry.npmjs.org/@nodable/entities/-/entities-3.1.0.tgz",
       "integrity": "sha512-LsS/DjHr+uDM647Gru/cA8+J3a3HfhttwCKLyuoyN7yXTFCxKBtSgMQBvrW9yNPa2/zDRUNuGPaH5QUFoa4arQ==",
+      "dev": true,
       "funding": [
         {
           "type": "github",
@@ -4259,9 +4258,9 @@
       }
     },
     "node_modules/@types/node": {
-      "version": "26.6.5",
+      "version": "26.5.0",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-26.6.5.tgz",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-26.5.0.tgz",
-      "integrity": "sha512-uMzsv9stDdofIZBx4UGh4Z9ZgXnGC9seRDscilBcTHAeOFk67MZg/k9bWVfO+bk4qZmG+l52hRnLwUiH2LnJTg==",
+      "integrity": "sha512-dVSGpriSoCgz8WnDNTuSSuSv1PC/ALXihO4ulRZt7Md8k9mlbdin3lGOcDE8SnWOgf513ByWlXd7BK4azmyg/A==",
       "dev": true,
       "license": "MIT",
       "dependencies": {
@@ -4568,6 +4567,7 @@
       "version": "1.0.1",
       "resolved": "https://registry.npmjs.org/anynum/-/anynum-1.0.1.tgz",
       "integrity": "sha512-N6//FLET/tXYNM/F6ABca1oH6fWB+KlTt909Le28WMDBk8oaT4vY17DCrwg2MvmuqUKt3Ni4N5dGJ/EoBgcO6A==",
+      "dev": true,
       "funding": [
         {
           "type": "github",
@@ -4660,12 +4660,6 @@
         "node": ">=12"
       }
     },
-    "node_modules/async": {
-      "version": "3.2.6",
-      "resolved": "https://registry.npmjs.org/async/-/async-3.2.6.tgz",
-      "integrity": "sha512-htCUDlxyyCLMgaM3xXg0C0LW2xqfuQ6p05pCEIsXuyQ+a1koYKTuBMzRNwmybfLgvJDMd0r1LTn4+E0Ti6C2AA==",
-      "license": "MIT"
-    },
     "node_modules/async-hook-jl": {
       "version": "1.7.6",
       "resolved": "https://registry.npmjs.org/async-hook-jl/-/async-hook-jl-1.7.6.tgz",
@@ -4897,15 +4891,6 @@
         "readable-stream": "^3.4.0"
       }
     },
-    "node_modules/block-stream2": {
-      "version": "2.1.0",
-      "resolved": "https://registry.npmjs.org/block-stream2/-/block-stream2-2.1.0.tgz",
-      "integrity": "sha512-suhjmLI57Ewpmq00qaygS8UgEq2ly2PCItenIyhMqVjo4t4pGzqMvfgJuX8iWTeSDdfSSqS6j38fL4ToNL7Pfg==",
-      "license": "MIT",
-      "dependencies": {
-        "readable-stream": "^3.4.0"
-      }
-    },
     "node_modules/body-parser": {
       "version": "1.20.8",
       "resolved": "https://registry.npmjs.org/body-parser/-/body-parser-1.20.8.tgz",
@@ -5017,12 +5002,6 @@
         "node": ">=8"
       }
     },
-    "node_modules/browser-or-node": {
-      "version": "2.1.1",
-      "resolved": "https://registry.npmjs.org/browser-or-node/-/browser-or-node-2.1.1.tgz",
-      "integrity": "sha512-8CVjaLJGuSKMVTxJ2DpBl5XnlNDiT4cQFeuCJJrvJmts9YrTZDizTX7PjC2s6W4x+MBGZeEY6dGMrF04/6Hgqg==",
-      "license": "MIT"
-    },
     "node_modules/browserslist": {
       "version": "4.28.9",
       "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.28.9.tgz",
@@ -5083,15 +5062,6 @@
         "ieee754": "^1.1.13"
       }
     },
-    "node_modules/buffer-crc32": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/buffer-crc32/-/buffer-crc32-1.0.0.tgz",
-      "integrity": "sha512-Db1SbgBS/fg/392AblrMJk97KggmvYhr4pB5ZIMTWtaivCPMWLkmb7m21cJvpvgK+J3nsU2CmmixNBZx4vFj/w==",
-      "license": "MIT",
-      "engines": {
-        "node": ">=8.0.0"
-      }
-    },
     "node_modules/buffer-equal-constant-time": {
       "version": "1.0.1",
       "resolved": "https://registry.npmjs.org/buffer-equal-constant-time/-/buffer-equal-constant-time-1.0.1.tgz",
@@ -5527,12 +5497,6 @@
       "dev": true,
       "license": "MIT"
     },
-    "node_modules/core-util-is": {
-      "version": "1.0.3",
-      "resolved": "https://registry.npmjs.org/core-util-is/-/core-util-is-1.0.3.tgz",
-      "integrity": "sha512-ZQBvi1DcpJ4GDqanjucZ2Hj3wEO5pZDS89BWbkcrvdxksJorwUDDZamX9ldFkp9aw2lmBDLgkObEA4DWNJ9FYQ==",
-      "license": "MIT"
-    },
     "node_modules/cors": {
       "version": "2.8.6",
       "resolved": "https://registry.npmjs.org/cors/-/cors-2.8.6.tgz",
@@ -5718,15 +5682,6 @@
       "dev": true,
       "license": "MIT"
     },
-    "node_modules/decode-uri-component": {
-      "version": "0.2.2",
-      "resolved": "https://registry.npmjs.org/decode-uri-component/-/decode-uri-component-0.2.2.tgz",
-      "integrity": "sha512-FqUYQ+8o158GyGTrMFJms9qh3CqTKvAqgqsTnkLI8sKu0028orqBhxNMFkFen0zGyg6epACD32pjVk58ngIErQ==",
-      "license": "MIT",
-      "engines": {
-        "node": ">=0.10"
-      }
-    },
     "node_modules/decompress-response": {
       "version": "6.0.0",
       "resolved": "https://registry.npmjs.org/decompress-response/-/decompress-response-6.0.0.tgz",
@@ -5917,25 +5872,6 @@
       "dev": true,
       "license": "MIT"
     },
-    "node_modules/docx-templates": {
-      "version": "4.15.0",
-      "resolved": "https://registry.npmjs.org/docx-templates/-/docx-templates-4.15.0.tgz",
-      "integrity": "sha512-H0JEDFVCF5j64Do9fqHVWwF86MOWUnHhQ2dfGWy7C2o9yPwtbCT1pXpotE6165Px07fia1Ted1Xh1fj1UZ9u1g==",
-      "license": "MIT",
-      "dependencies": {
-        "jszip": "^3.10.1",
-        "sax": "1.3.0"
-      },
-      "engines": {
-        "node": ">=6"
-      }
-    },
-    "node_modules/docx-templates/node_modules/sax": {
-      "version": "1.3.0",
-      "resolved": "https://registry.npmjs.org/sax/-/sax-1.3.0.tgz",
-      "integrity": "sha512-0s+oAmw9zLl1V1cS9BtZN7JAd0cW5e0QH4W3LWEK6a4LaLEA2OTpGYWDY+6XasBLtz6wkm3u1xRw95mRuJ59WA==",
-      "license": "ISC"
-    },
     "node_modules/dom-serializer": {
       "version": "3.1.1",
       "resolved": "https://registry.npmjs.org/dom-serializer/-/dom-serializer-3.1.1.tgz",
@@ -6897,12 +6833,6 @@
         "node": ">= 0.6"
       }
     },
-    "node_modules/eventemitter3": {
-      "version": "5.0.4",
-      "resolved": "https://registry.npmjs.org/eventemitter3/-/eventemitter3-5.0.4.tgz",
-      "integrity": "sha512-mlsTRyGaPBjPedk6Bvw+aqbsXDtoAyAzm5MO7JgU+yVRyMQ5O8bD4Kcci7BS85f93veegeCPkL8R4GLClnjLFw==",
-      "license": "MIT"
-    },
     "node_modules/events": {
       "version": "3.3.0",
       "resolved": "https://registry.npmjs.org/events/-/events-3.3.0.tgz",
@@ -6962,7 +6892,6 @@
       "integrity": "sha512-Bdcs4+3qlpVlx2NRn6fgX2Ue2/gGRaPeawebgclM0ERSCqDpA+owF1fdPwjJUTAJWMTuAaxjDf+hzb0/4eKvvw==",
       "dev": true,
       "license": "MIT",
-      "peer": true,
       "dependencies": {
         "accepts": "~1.3.8",
         "array-flatten": "1.1.1",
@@ -7106,6 +7035,7 @@
       "version": "1.3.1",
       "resolved": "https://registry.npmjs.org/fast-xml-builder/-/fast-xml-builder-1.3.1.tgz",
       "integrity": "sha512-pIM/1n3ntFXKYrUZwW7QCK0gAW7XY+wzj1YMIV3tLDvPj/V+zTGJK5e3/4WJfwj0qWw2ElNXiTixda/R+3YSug==",
+      "dev": true,
       "funding": [
         {
           "type": "github",
@@ -7122,6 +7052,7 @@
       "version": "5.11.2",
       "resolved": "https://registry.npmjs.org/fast-xml-parser/-/fast-xml-parser-5.11.2.tgz",
       "integrity": "sha512-R9iDuNrQYeQut46cn2r2wHKn4HYzVDvDm5J1wW+koZewykv0yuO2HChTYeZtrULyHIDM9cj9TUXloCsueCQUog==",
+      "dev": true,
       "funding": [
         {
           "type": "github",
@@ -7204,15 +7135,6 @@
         "node": ">=8"
       }
     },
-    "node_modules/filter-obj": {
-      "version": "1.1.0",
-      "resolved": "https://registry.npmjs.org/filter-obj/-/filter-obj-1.1.0.tgz",
-      "integrity": "sha512-8rXg1ZnX7xzy2NGDVkBVaAy+lSlPNwad13BtgSlLuxfIslyt5Vg64U7tFcCt4WS1R0hvtnQybT/IyCkGZ3DpXQ==",
-      "license": "MIT",
-      "engines": {
-        "node": ">=0.10.0"
-      }
-    },
     "node_modules/finalhandler": {
       "version": "1.3.2",
       "resolved": "https://registry.npmjs.org/finalhandler/-/finalhandler-1.3.2.tgz",
@@ -7839,16 +7761,11 @@
         "node": ">= 4"
       }
     },
-    "node_modules/immediate": {
-      "version": "3.0.6",
-      "resolved": "https://registry.npmjs.org/immediate/-/immediate-3.0.6.tgz",
-      "integrity": "sha512-XXOFtyqDjNDAQxVfYxuF7g9Il/IbWmmlQg2MYKOH8ExIT1qg6xc4zyS3HaEEATgs1btfzxq15ciUiY7gjSXRGQ==",
-      "license": "MIT"
-    },
     "node_modules/inherits": {
       "version": "2.0.4",
       "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz",
       "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==",
+      "dev": true,
       "license": "ISC"
     },
     "node_modules/ini": {
@@ -8145,6 +8062,7 @@
       "version": "2.0.2",
       "resolved": "https://registry.npmjs.org/is-unsafe/-/is-unsafe-2.0.2.tgz",
       "integrity": "sha512-HgbIHPBH0KHHCcjLfGsCvhtPTVxjaAZlXjwdz7/GQC40SjSe4sfQsar8J5VFo8JOSbarkpV0OLG95bbaNd9aAQ==",
+      "dev": true,
       "funding": [
         {
           "type": "github",
@@ -8166,12 +8084,6 @@
         "node": ">=8"
       }
     },
-    "node_modules/isarray": {
-      "version": "1.0.0",
-      "resolved": "https://registry.npmjs.org/isarray/-/isarray-1.0.0.tgz",
-      "integrity": "sha512-VLghIWNM6ELQzo7zwmcg0NmTVyWKYjvIeM83yjp0wRDTmUnrM678fQbcKBo6n2CJEF0szoG//ytg+TKla89ALQ==",
-      "license": "MIT"
-    },
     "node_modules/isexe": {
       "version": "2.0.0",
       "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz",
@@ -8352,48 +8264,6 @@
         "npm": ">=6"
       }
     },
-    "node_modules/jszip": {
-      "version": "3.10.2",
-      "resolved": "https://registry.npmjs.org/jszip/-/jszip-3.10.2.tgz",
-      "integrity": "sha512-3l+rb15IOWtUhU0H5MFqES/T6Kh7abYwjosBey/vD6hDt8zoEffkSC5Ws5SGtgVw3gBx2NEbhTeSW1+kWkpyTQ==",
-      "license": "(MIT OR GPL-3.0-or-later)",
-      "dependencies": {
-        "lie": "~3.3.0",
-        "pako": "~1.0.2",
-        "readable-stream": "~2.3.6",
-        "setimmediate": "^1.0.5"
-      }
-    },
-    "node_modules/jszip/node_modules/readable-stream": {
-      "version": "2.3.8",
-      "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-2.3.8.tgz",
-      "integrity": "sha512-8p0AUk4XODgIewSi0l8Epjs+EVnWiK7NoDIEGU0HhE7+ZyY8D1IMY7odu5lRrFXGg71L15KG8QrPmum45RTtdA==",
-      "license": "MIT",
-      "dependencies": {
-        "core-util-is": "~1.0.0",
-        "inherits": "~2.0.3",
-        "isarray": "~1.0.0",
-        "process-nextick-args": "~2.0.0",
-        "safe-buffer": "~5.1.1",
-        "string_decoder": "~1.1.1",
-        "util-deprecate": "~1.0.1"
-      }
-    },
-    "node_modules/jszip/node_modules/safe-buffer": {
-      "version": "5.1.2",
-      "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.1.2.tgz",
-      "integrity": "sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==",
-      "license": "MIT"
-    },
-    "node_modules/jszip/node_modules/string_decoder": {
-      "version": "1.1.1",
-      "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.1.1.tgz",
-      "integrity": "sha512-n/ShnvDi6FHbbVfviro+WojiFzv+s8MPMHBczVePfUpDJLwoLT0ht1l4YwBCbi8pJAveEEdnkHyPyTP/mzRfwg==",
-      "license": "MIT",
-      "dependencies": {
-        "safe-buffer": "~5.1.0"
-      }
-    },
     "node_modules/junk": {
       "version": "3.1.0",
       "resolved": "https://registry.npmjs.org/junk/-/junk-3.1.0.tgz",
@@ -8449,15 +8319,6 @@
         "graceful-fs": "^4.1.9"
       }
     },
-    "node_modules/lie": {
-      "version": "3.3.0",
-      "resolved": "https://registry.npmjs.org/lie/-/lie-3.3.0.tgz",
-      "integrity": "sha512-UaiMJzeWRlEujzAuw5LokY1L5ecNQYZKfmyZ9L7wDHb/p5etKaxXhohBcrw0EYby+G/NA52vRSN4N39dxHAIwQ==",
-      "license": "MIT",
-      "dependencies": {
-        "immediate": "~3.0.5"
-      }
-    },
     "node_modules/lightningcss": {
       "version": "1.33.0",
       "resolved": "https://registry.npmjs.org/lightningcss/-/lightningcss-1.33.0.tgz",
@@ -8768,6 +8629,7 @@
       "version": "4.18.1",
       "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.18.1.tgz",
       "integrity": "sha512-dMInicTPVE8d1e5otfwmmjlxkZoUpiVLwyeTdUsi/Caj/gfzzblBcCE5sRHV/AsjuCmxWrte2TNGSYuCeCq+0Q==",
+      "dev": true,
       "license": "MIT"
     },
     "node_modules/lodash.includes": {
@@ -8987,6 +8849,7 @@
       "version": "1.52.0",
       "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.52.0.tgz",
       "integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==",
+      "dev": true,
       "license": "MIT",
       "engines": {
         "node": ">= 0.6"
@@ -8996,6 +8859,7 @@
       "version": "2.1.35",
       "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.35.tgz",
       "integrity": "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==",
+      "dev": true,
       "license": "MIT",
       "dependencies": {
         "mime-db": "1.52.0"
@@ -9043,39 +8907,6 @@
         "url": "https://github.com/sponsors/ljharb"
       }
     },
-    "node_modules/minio": {
-      "version": "8.0.7",
-      "resolved": "https://registry.npmjs.org/minio/-/minio-8.0.7.tgz",
-      "integrity": "sha512-E737MgufW8CeQAsTAtnEMrxZ9scMSf29kkhZoXzDTKj/Jszzo2SfeZUH9wbDQH2Rsq6TCtl/yQL0+XdVKZansQ==",
-      "license": "Apache-2.0",
-      "dependencies": {
-        "async": "^3.2.4",
-        "block-stream2": "^2.1.0",
-        "browser-or-node": "^2.1.1",
-        "buffer-crc32": "^1.0.0",
-        "eventemitter3": "^5.0.1",
-        "fast-xml-parser": "^5.3.4",
-        "ipaddr.js": "^2.0.1",
-        "lodash": "^4.17.21",
-        "mime-types": "^2.1.35",
-        "query-string": "^7.1.3",
-        "stream-json": "^1.8.0",
-        "through2": "^4.0.2",
-        "xml2js": "^0.5.0 || ^0.6.2"
-      },
-      "engines": {
-        "node": "^16 || ^18 || >=20"
-      }
-    },
-    "node_modules/minio/node_modules/ipaddr.js": {
-      "version": "2.5.0",
-      "resolved": "https://registry.npmjs.org/ipaddr.js/-/ipaddr.js-2.5.0.tgz",
-      "integrity": "sha512-aq+t5NAc+cS6rZQQVWC2x98CPqGtKKTMDd4Gaodv0wShnItdKg/51djkGJ1hqH+Oy0ivDftCbSLCQob8zso01w==",
-      "license": "MIT",
-      "engines": {
-        "node": ">= 10"
-      }
-    },
     "node_modules/minipass": {
       "version": "7.1.3",
       "resolved": "https://registry.npmjs.org/minipass/-/minipass-7.1.3.tgz",
@@ -10740,6 +10571,7 @@
       "version": "1.6.2",
       "resolved": "https://registry.npmjs.org/path-expression-matcher/-/path-expression-matcher-1.6.2.tgz",
       "integrity": "sha512-enSlaiat05iasnzmgNxRj8reFdj3puY2QpNgP1aPIaVfT6nn9ICuPoFlKHk8EN22HcwewshO+mN2DGbkCEOtqQ==",
+      "dev": true,
       "funding": [
         {
           "type": "github",
@@ -11124,12 +10956,6 @@
         "node": ">=10"
       }
     },
-    "node_modules/process-nextick-args": {
-      "version": "2.0.1",
-      "resolved": "https://registry.npmjs.org/process-nextick-args/-/process-nextick-args-2.0.1.tgz",
-      "integrity": "sha512-3ouUOpQhtgrbOa17J7+uxOTpITYWaGP7/AhoR3+A+/1e9skrzelGi/dXzEYyvbxubEF6Wn2ypscTKiKJFFn1ag==",
-      "license": "MIT"
-    },
     "node_modules/proper-lockfile": {
       "version": "4.1.2",
       "resolved": "https://registry.npmjs.org/proper-lockfile/-/proper-lockfile-4.1.2.tgz",
@@ -11215,24 +11041,6 @@
         "url": "https://github.com/sponsors/ljharb"
       }
     },
-    "node_modules/query-string": {
-      "version": "7.1.3",
-      "resolved": "https://registry.npmjs.org/query-string/-/query-string-7.1.3.tgz",
-      "integrity": "sha512-hh2WYhq4fi8+b+/2Kg9CEge4fDPvHS534aOOvOZeQ3+Vf2mCFsaFBYj0i+iXcAq6I9Vzp5fjMFBlONvayDC1qg==",
-      "license": "MIT",
-      "dependencies": {
-        "decode-uri-component": "^0.2.2",
-        "filter-obj": "^1.1.0",
-        "split-on-first": "^1.0.0",
-        "strict-uri-encode": "^2.0.0"
-      },
-      "engines": {
-        "node": ">=6"
-      },
-      "funding": {
-        "url": "https://github.com/sponsors/sindresorhus"
-      }
-    },
     "node_modules/queue-microtask": {
       "version": "1.2.3",
       "resolved": "https://registry.npmjs.org/queue-microtask/-/queue-microtask-1.2.3.tgz",
@@ -11348,6 +11156,7 @@
       "version": "3.6.2",
       "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-3.6.2.tgz",
       "integrity": "sha512-9u/sniCrY3D5WdsERHzHE4G2YCXqoG5FTHUiCC4SIbr6XcLZBY05ya9EKjYek9O5xOAwjGq+1JdGBAS7Q9ScoA==",
+      "dev": true,
       "license": "MIT",
       "dependencies": {
         "inherits": "^2.0.3",
@@ -11591,6 +11400,7 @@
       "version": "5.2.1",
       "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz",
       "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==",
+      "dev": true,
       "funding": [
         {
           "type": "github",
@@ -11618,6 +11428,7 @@
       "version": "1.6.1",
       "resolved": "https://registry.npmjs.org/sax/-/sax-1.6.1.tgz",
       "integrity": "sha512-42tBVwLWnaQvW5zc4HbZrTuWccECCZfBi92FDuwtqxasH+JbPB3/FOKb1m222K42R4WxuxzzMsTswfzgtSu64Q==",
+      "dev": true,
       "license": "BlueOak-1.0.0",
       "engines": {
         "node": ">=11.0.0"
@@ -11729,12 +11540,6 @@
         "node": ">= 0.8.0"
       }
     },
-    "node_modules/setimmediate": {
-      "version": "1.0.5",
-      "resolved": "https://registry.npmjs.org/setimmediate/-/setimmediate-1.0.5.tgz",
-      "integrity": "sha512-MATJdZp8sLqDl/68LfQmbP8zKPLQNV6BIZoIgrscFDQ+RsvK/BxeDQOgyxKKoh0y/8h3BqVFnCqQ/gd+reiIXA==",
-      "license": "MIT"
-    },
     "node_modules/setprototypeof": {
       "version": "1.2.0",
       "resolved": "https://registry.npmjs.org/setprototypeof/-/setprototypeof-1.2.0.tgz",
@@ -12018,15 +11823,6 @@
         "source-map": "^0.6.0"
       }
     },
-    "node_modules/split-on-first": {
-      "version": "1.1.0",
-      "resolved": "https://registry.npmjs.org/split-on-first/-/split-on-first-1.1.0.tgz",
-      "integrity": "sha512-43ZssAJaMusuKWL8sKUBQXHWOpq8d6CfN/u1p4gUzfJkM05C8rxTmYrkIPTXapZpORA6LkkzcUulJ8FqA7Uudw==",
-      "license": "MIT",
-      "engines": {
-        "node": ">=6"
-      }
-    },
     "node_modules/stack-chain": {
       "version": "1.3.7",
       "resolved": "https://registry.npmjs.org/stack-chain/-/stack-chain-1.3.7.tgz",
@@ -12058,21 +11854,6 @@
       "dev": true,
       "license": "MIT"
     },
-    "node_modules/stream-chain": {
-      "version": "2.2.5",
-      "resolved": "https://registry.npmjs.org/stream-chain/-/stream-chain-2.2.5.tgz",
-      "integrity": "sha512-1TJmBx6aSWqZ4tx7aTpBDXK0/e2hhcNSTV8+CbFJtDjbb+I1mZ8lHit0Grw9GRT+6JbIrrDd8esncgBi8aBXGA==",
-      "license": "BSD-3-Clause"
-    },
-    "node_modules/stream-json": {
-      "version": "1.9.1",
-      "resolved": "https://registry.npmjs.org/stream-json/-/stream-json-1.9.1.tgz",
-      "integrity": "sha512-uWkjJ+2Nt/LO9Z/JyKZbMusL8Dkh97uUBTv3AJQ74y07lVahLY4eEFsPsE97pxYBwr8nnjMAIch5eqI0gPShyw==",
-      "license": "BSD-3-Clause",
-      "dependencies": {
-        "stream-chain": "^2.2.5"
-      }
-    },
     "node_modules/streamroller": {
       "version": "3.1.5",
       "resolved": "https://registry.npmjs.org/streamroller/-/streamroller-3.1.5.tgz",
@@ -12131,19 +11912,11 @@
         "node": ">=10.0.0"
       }
     },
-    "node_modules/strict-uri-encode": {
-      "version": "2.0.0",
-      "resolved": "https://registry.npmjs.org/strict-uri-encode/-/strict-uri-encode-2.0.0.tgz",
-      "integrity": "sha512-QwiXZgpRcKkhTj2Scnn++4PKtWsH0kpzZ62L2R6c/LUVYv7hVnZqcg2+sMuT6R7Jusu1vviK/MFsu6kNJfWlEQ==",
-      "license": "MIT",
-      "engines": {
-        "node": ">=4"
-      }
-    },
     "node_modules/string_decoder": {
       "version": "1.3.0",
       "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.3.0.tgz",
       "integrity": "sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==",
+      "dev": true,
       "license": "MIT",
       "dependencies": {
         "safe-buffer": "~5.2.0"
@@ -12204,6 +11977,7 @@
       "version": "2.5.1",
       "resolved": "https://registry.npmjs.org/strnum/-/strnum-2.5.1.tgz",
       "integrity": "sha512-UM4nTLWzQiDBseVxUGxN0wJzIk0UU89Qi7pKXz9qISo+lhviJikTuikBsK/oFRlpvYHvSdz0TVoLyQ+sEpYwxA==",
+      "dev": true,
       "funding": [
         {
           "type": "github",
@@ -12538,15 +12312,6 @@
         "node": ">=0.8"
       }
     },
-    "node_modules/through2": {
-      "version": "4.0.2",
-      "resolved": "https://registry.npmjs.org/through2/-/through2-4.0.2.tgz",
-      "integrity": "sha512-iOqSav00cVxEEICeD7TjLB1sueEL+81Wpzp2bY17uZjZN0pWZPuo4suZ/61VujxmqSGFfgOcNuTZ85QJwNZQpw==",
-      "license": "MIT",
-      "dependencies": {
-        "readable-stream": "3"
-      }
-    },
     "node_modules/tinybench": {
       "version": "6.1.4",
       "resolved": "https://registry.npmjs.org/tinybench/-/tinybench-6.1.4.tgz",
@@ -12917,6 +12682,7 @@
       "version": "1.0.2",
       "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz",
       "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==",
+      "dev": true,
       "license": "MIT"
     },
     "node_modules/utils-merge": {
@@ -13356,6 +13122,7 @@
       "version": "0.3.0",
       "resolved": "https://registry.npmjs.org/xml-naming/-/xml-naming-0.3.0.tgz",
       "integrity": "sha512-ghig2TBE/H11aOVgmahA3MhimvkBr6JIYknH/Dhdk10nXwdbIqBJsbfMxpvFPG8bAw77gN29aQWvKpmVoPlvPQ==",
+      "dev": true,
       "funding": [
         {
           "type": "github",
@@ -13371,6 +13138,7 @@
       "version": "0.5.0",
       "resolved": "https://registry.npmjs.org/xml2js/-/xml2js-0.5.0.tgz",
       "integrity": "sha512-drPFnkQJik/O+uPKpqSgr22mpuFHqKdbS835iAQrUC73L2F5WkboIRd63ai/2Yg6I1jzifPFKH2NTK+cfglkIA==",
+      "dev": true,
       "license": "MIT",
       "dependencies": {
         "sax": ">=0.6.0",
@@ -13384,6 +13152,7 @@
       "version": "11.0.1",
       "resolved": "https://registry.npmjs.org/xmlbuilder/-/xmlbuilder-11.0.1.tgz",
       "integrity": "sha512-fDlsI/kFEx7gLvbecc0/ohLG50fugQp8ryHzMTuW9vSa1GJ0XYWKnhsUx7oie3G98+r56aTQIUB4kht42R3JvA==",
+      "dev": true,
       "license": "MIT",
       "engines": {
         "node": ">=4.0"

package.json

@@ -15,10 +15,8 @@
   "dependencies": {
     "@pdf-lib/fontkit": "^1.1.1",
     "@xmldom/xmldom": "^0.9.12",
-    "docx-templates": "^4.15.0",
     "drizzle-orm": "^0.45.2",
     "lucide-react": "^1.42.0",
-    "minio": "^8.0.7",
     "next": "^14.2.35",
     "pdf-lib": "^1.17.1",
     "pdfjs-dist": "^4.10.38",
@@ -32,7 +30,7 @@
     "xpath": "^0.0.34"
   },
   "devDependencies": {
-    "@types/node": "^26.6.5",
+    "@types/node": "^26.5.0",
     "@types/office-js": "^1.0.612",
     "@types/pngjs": "^6.0.5",
     "@types/react": "^18.3.31",

pnpm-workspace.yaml

@@ -1,6 +0,0 @@
-allowBuilds:
-  '@azure/msal-node-extensions': set this to true or false
-  '@microsoft/m365agentstoolkit-cli': set this to true or false
-  '@scarf/scarf': set this to true or false
-  esbuild: set this to true or false
-  keytar: set this to true or false

public/tmpl/T12_b2_IN.json

@@ -1,41 +0,0 @@
-{
-    "info": {
-        "ticket_data": "{\"fid\":\"T12_b2_IN_XXX\",\"tid\":\"T12\",\"uid\":\"oom\",\"uname\":\"สรวิชญ์\"}"
-    },
-    "dc": {
-        "Interpleader": true,
-        "docname": "",
-        "docabbr": "(ต. ๑๒)",
-        "blackno": "คดีหมายเลขดำที่",
-        "redno": "คดีหมายเลขแดงที่",
-        "court": "ศาลปกครองนครราชสีมา",
-        "panels": [
-            {
-                "pname": "นายวิรุฬห์ จินตนะกุล",
-                "pmname": "ตุลาการศาลปกครองกลาง",
-                "pm": "ตุลาการเจ้าของสำนวน"
-            },
-            {
-                "pname": "นายสัมฤทธิ์ อ่อนคำ",
-                "pmname": "ตุลาการศาลปกครองสูงสุด"
-            }
-        ],
-        "pnameT":"",
-        "pmnameT":"",
-        "pmT":"",
-        "acc_name":""
-
-    },
-    "cc": {
-        "blackyear": "๙๐/๒๕๖๙",
-        "redyear": "",
-        "curdate": "วันที่   เดือน สิงหาคม พุทธศักราช ๒๕๖๙",
-        "accuser": "นายธีรพล ร่มเริง",
-        "acc1": "ผู้ฟ้องคดี",
-        "accused": "รร",
-        "acc2": "ผู้ถูกฟ้องคดี",
-        "interpleader": "สมชาย ใจดี",
-        "acc3": "ผู้ร้องสอด",
-        "detail1": "ตุลาการเจ้าของสำนวนได้พิจารณาคำฟ้องและเอกสารประกอบคำฟ้องแล้วเห็นว่าคดีนี้เป็นคดีพิพาทซึ่งไม่อยู่ในอำนาจศาลปกครองสูงสุด ผู้ฟ้องเป็นผู้มีสิทธิฟ้องคดี คดีนี้มีกฎหมายกำหนดให้ต้องดำเนินการแก้ไขความเดือดร้อนหรือเสียหายก่อนฟ้องคดี และผู้ฟ้องคดีได้ดำเนินการครบถ้วน โดยเป็นการยื่นฟ้องคดีภายในระยะเวลาการฟ้องคดีตาม พรบ. จัดตั้งศาลปกครองและวิธีพิจารณาคดีปกครองฯ คดีนี้มีค่าธรรมเนียมที่ต้องชำระ\nโดยผู้ฟ้องคดีได้ชำระค่าธรรมเนียมครบถ้วนแล้ว รวมทั้งคดีนี้ไม่เป็นการฟ้องซ้อน การดำเนินกระบวนพิจารณาซ้ำ และการฟ้องซ้ำ\n\nจึงมีคำสั่งรับคำฟ้องไว้พิจารณาและสั่งให้ส่งสำเนาคำฟ้องพร้อมทั้งสำเนาพยานหลักฐานไปยังผู้ถูกฟ้องคดีเพื่อให้ผู้ถูกฟ้องคดีทำคำให้การยื่นต่อศาลภายใน ๓๐ วัน นับแต่วันที่ได้รับคำสั่ง"
-    }
-}

public/tmpl/T12_b2_IN.out.json

@@ -1,51 +0,0 @@
-{
-  "cc": {
-    "blackyear": "๙๐/๒๕๖๙",
-    "redyear": "",
-    "curdate": "วันที่   เดือน สิงหาคม พุทธศักราช ๒๕๖๙",
-    "accuser": "นายธีรพล ร่มเริง",
-    "acc1": "ผู้ฟ้องคดี",
-    "interpleader": "สมชาย ใจดี",
-    "acc3": "ผู้ร้องสอด",
-    "accused": "รร",
-    "acc2": "ผู้ถูกฟ้องคดี",
-    "detail1": "ตุลาการเจ้าของสำนวนได้พิจารณาคำฟ้องและเอกสารประกอบคำฟ้องแล้วเห็นว่าคดีนี้เป็นคดีพิพาทซึ่งไม่อยู่ในอำนาจศาลปกครองสูงสุด ผู้ฟ้องเป็นผู้มีสิทธิฟ้องคดี คดีนี้มีกฎหมายกำหนดให้ต้องดำเนินการแก้ไขความเดือดร้อนหรือเสียหายก่อนฟ้องคดี และผู้ฟ้องคดีได้ดำเนินการครบถ้วน โดยเป็นการยื่นฟ้องคดีภายในระยะเวลาการฟ้องคดีตาม พรบ. จัดตั้งศาลปกครองและวิธีพิจารณาคดีปกครองฯ คดีนี้มีค่าธรรมเนียมที่ต้องชำระ\nโดยผู้ฟ้องคดีได้ชำระค่าธรรมเนียมครบถ้วนแล้ว รวมทั้งคดีนี้ไม่เป็นการฟ้องซ้อน การดำเนินกระบวนพิจารณาซ้ำ และการฟ้องซ้ำ\n\nจึงมีคำสั่งรับคำฟ้องไว้พิจารณาและสั่งให้ส่งสำเนาคำฟ้องพร้อมทั้งสำเนาพยานหลักฐานไปยังผู้ถูกฟ้องคดีเพื่อให้ผู้ถูกฟ้องคดีทำคำให้การยื่นต่อศาลภายใน ๓๐ วัน นับแต่วันที่ได้รับคำสั่ง",
-    "pmname1": "ตุลาการศาลปกครองกลาง",
-    "pmname2": "ตุลาการศาลปกครองสูงสุด"
-  },
-  "bookmark": {
-    "signature1": "",
-    "signature2": ""
-  },
-  "properties": {
-    "standard": {
-      "title": "           ",
-      "subject": "",
-      "creator": "oom",
-      "keywords": "",
-      "lastModifiedBy": "Sorawit Bholsithi",
-      "revision": "61",
-      "created": "2026-10-15T05:18:00.000Z",
-      "modified": "2026-10-21T04:59:00.000Z"
-    },
-    "extended": {
-      "template": "Normal.dotm",
-      "totalTime": 345,
-      "pages": 1,
-      "words": 42,
-      "characters": 493,
-      "charactersWithSpaces": 534,
-      "lines": 4,
-      "paragraphs": 1,
-      "application": "Microsoft Office Word",
-      "appVersion": "16.0000",
-      "company": "",
-      "docSecurity": 0
-    },
-    "custom": {
-      "ticket_data": "{\"exp\":1792667826,\"fid\":\"T12_b2_IN_XXX\",\"tid\":\"T12\",\"uid\":\"oom\",\"uname\":\"สรวิชญ์\"}",
-      "HmacSha256": "791987c9274493db02561f4ec16b83d05c89766b54661da615e8e02db293d1d4",
-      "Ed25519": "7ef8b0f2a03a52c49f8c348e3c392f448b71c8462ee860342b0e06a91b555f860cad5649c648dc466982017683f3718caff139c85e17e952ee1570ecfc021e08"
-    }
-  }
-}

public/tmpl/TF_no_warning_P2.json

@@ -1,50 +0,0 @@
-{
-    "info": {
-        "ticket_data": "{\"fid\":\"TF_no_warning_P2\",\"tid\":\"T_X\",\"uid\":\"oom\",\"uname\":\"สรวิชญ์\"}"
-    },
-    "dc": {
-        "Interpleader": false,
-        "CommandTo": true,
-        "SendTo": false,
-        "AdditionCommand" : true,
-        "Warning":false,
-
-        "docname":"คำสั่งศาล",
-        "doctype":"(ต. ๔๗.๑)",
-        "blackno": "คดีหมายเลขดำที่",
-        "redno": "คดีหมายเลขแดงที่",
-
-        "court": "ศาลปกครองนครราชสีมา",
-        "doctitle":"คำสั่งศาลถึง",
-        "pname":"สมหญิง",
-
-        "courtname":"ศาลปกครองสุพรรณบุรี",
-        "courtno":"๓๓๓ หมู่ ๖ ตำบลสนามชัย อำเภอเมืองสุพรรณบุรี",
-        "courttam":"จังหวัดสุพรรณบุรี ๗๒๐๐๐",
-        "courttel":"กลุ่มออกหมาย โทรศัพท์ ๐๓๕ ๔๓๒ ๓๓๓ ต่อ ๑๐๐๑,๒๒๐๓",
-        "courttel2":"สอบถามติดตามคดี ขอคำปรึกษาแนะนำ โทรสายด่วน ๑๓๕๕",
-        "pname2":"ชื่อของ pname2"
-    },
-    "cc": {
-        "blackyear": "๙๐/๒๕๖๙",
-        "redyear": "xxx",
-        "curdate": "วันที่   เดือน สิงหาคม พุทธศักราช ๒๕๖๙ ",
-        "commto" : "นายสมชาย จรดปลายเท้า",
-        "addrno" : "3/77 xxx yyy ทุ่งสองห้อง,หลักสี่, จังหวัดกรุงเทพฯ ",        
-        "groupname":"ผู้อำนวยการโรงเรียน",
-
-        "accuser": "นายธีรพล ร่มเริง",
-        "acc1": "ผู้ฟ้องคดี",
-        "accused": "รร",
-        "acc2": "ผู้ถูกฟ้องคดี",
-        "interpleader": "สมชาย ใจดี",
-        "acc3": "ผู้ร้องสอด",
-        "detail1": "ตุลาการเจ้าของสำนวนได้พิจารณาคำฟ้อง และเอกสารประกอบคำฟ้องแล้ว เห็นว่าคดีนี้เป็นคดีพิพาทซึ่งไม่อยู่ในอำนาจศาลปกครองสูงสุด\n\nผู้ฟ้องเป็นผู้มีสิทธิฟ้องคดี คดีนี้มีกฎหมายกำหนดให้ต้องดำเนินการแก้ไข ความเดือดร้อนหรือเสียหายก่อนฟ้องคดี ",
-        "sendto" : "นายสมศักดิ์ ฟักมี",
-        
-        "warning": "หากผู้ถูกฟ้องคดีไม่ปฏิบัติตามคำสั่งศาลภายในระยะเวลาที่กำหนด ศาลจะถือว่า ผู้ถูกฟ้องคดียอมรับข้อเท็จจริงตามข้อหาของผู้ฟ้องคดี",
-        "detail2":"คำสั่งเพิ่มเติมคือ bla bla",
-        "remarkhead":"หัวของ Remark",
-        "remark":"This is remark Text bla bla "
-    }
-}

public/tmpl/TS_P2_IN.json

@@ -1,52 +0,0 @@
-{
-    "info": {
-        "ticket_data": "{\"fid\":\"TS_P2_IN_YYY\",\"tid\":\"T_X\",\"uid\":\"oom\",\"uname\":\"สรวิชญ์\"}"
-    },
-    "dc": {
-        "Interpleader": true,
-        "CommandTo": true,
-        "SendTo": false,
-        "AdditionCommand" : true,
-        "Warning":true,
-
-        "docname":"คำสั่งเรียกพยานบุคคล",
-        "doctype":"(ต. ๖)",
-        "blackno": "คดีหมายเลขดำที่",
-        "redno": "คดีหมายเลขแดงที่",
-
-        "court": "ศาลปกครองนครราชสีมา",
-        "doctitle":"คำสั่งถึง",
-        "pname":"สมหญิง",
-
-        "courtname":"ศาลปกครองสุพรรณบุรี",
-        "courtno":"๓๓๓ หมู่ ๖ ตำบลสนามชัย อำเภอเมืองสุพรรณบุรี",
-        "courttam":"จังหวัดสุพรรณบุรี ๗๒๐๐๐",
-        "courttel":"กลุ่มออกหมาย โทรศัพท์ ๐๓๕ ๔๓๒ ๓๓๓ ต่อ ๑๐๐๑,๒๒๐๓",
-        "courttel2":"สอบถามติดตามคดี ขอคำปรึกษาแนะนำ โทรสายด่วน ๑๓๕๕",
-
-        "pname2":"ชื่อของ pname2",
-        "remarkhead":"หัวของ Remark"
-    },
-    "cc": {
-        "blackyear": "๙๐/๒๕๖๙",
-        "redyear": "xxx",
-        "curdate": "วันที่   เดือน สิงหาคม พุทธศักราช ๒๕๖๙ ",
-        "commto" : "นายสมชาย จรดปลายเท้า",
-        "addrno" : "3/77 xxx yyy ทุ่งสองห้อง,หลักสี่, จังหวัดกรุงเทพฯ ",        
-        "groupname":"ผู้อำนวยการโรงเรียน",
-
-        "accuser": "นายธีรพล ร่มเริง",
-        "acc1": "ผู้ฟ้องคดี",
-        "accused": "รร",
-        "acc2": "ผู้ถูกฟ้องคดี",
-        "interpleader": "สมชาย ใจดี",
-        "acc3": "ผู้ร้องสอด",
-        "detail1": "ตุลาการเจ้าของสำนวนได้พิจารณาคำฟ้อง และเอกสารประกอบคำฟ้องแล้ว เห็นว่าคดีนี้เป็นคดีพิพาทซึ่งไม่อยู่ในอำนาจศาลปกครองสูงสุด\n\nผู้ฟ้องเป็นผู้มีสิทธิฟ้องคดี คดีนี้มีกฎหมายกำหนดให้ต้องดำเนินการแก้ไข ความเดือดร้อนหรือเสียหายก่อนฟ้องคดี ",
-        "sendto" : "นายสมศักดิ์ ฟักมี",
-        
-        "warning": "หากผู้ถูกฟ้องคดีไม่ปฏิบัติตามคำสั่งศาลภายในระยะเวลาที่กำหนด ศาลจะถือว่า ผู้ถูกฟ้องคดียอมรับข้อเท็จจริงตามข้อหาของผู้ฟ้องคดี",
-        "detail2":"คำสั่งเพิ่มเติมคือ bla bla",
-
-        "remark":"This is remark Text bla bla "
-    }
-}

public/tmpl/T_no_warning.json

@@ -1,51 +0,0 @@
-{
-    "info": {
-        "ticket_data": "{\"fid\":\"T3_P2_IN_XXX\",\"tid\":\"T_X\",\"uid\":\"oom\",\"uname\":\"สรวิชญ์\"}"
-    },
-    "dc": {
-        "Interpleader": false,
-        "CommandTo": true,
-        "SendTo": true,
-        "AdditionCommand" : false,
-        "Warning":false,
-
-        "docname":"คำสั่งเรียก\nให้ทำคำให้การเพิ่มเติม",
-        "doctype":"(ต. ๓)",
-        "blackno": "คดีหมายเลขดำที่",
-        "redno": "คดีหมายเลขแดงที่",
-
-        "court": "ศาลปกครองนครราชสีมา",
-        "doctitle":"คำสั่งถึง",
-        "pname":"สมหญิง",
-
-        "courtname":"ศาลปกครองสุพรรณบุรี",
-        "courtno":"๓๓๓ หมู่ ๖ ตำบลสนามชัย อำเภอเมืองสุพรรณบุรี",
-        "courttam":"จังหวัดสุพรรณบุรี ๗๒๐๐๐",
-        "courttel":"กลุ่มออกหมาย โทรศัพท์ ๐๓๕ ๔๓๒ ๓๓๓ ต่อ ๑๐๐๑,๒๒๐๓",
-        "courttel2":"สอบถามติดตามคดี ขอคำปรึกษาแนะนำ โทรสายด่วน ๑๓๕๕",
-        "pname2":"ชื่อของ pname2"
-    },
-    "cc": {
-        "docname":"คำสั่งเรียกพยานบุคคล",
-        "blackyear": "๙๐/๒๕๖๙",
-        "redyear": "xxx",
-        "curdate": "วันที่   เดือน สิงหาคม พุทธศักราช ๒๕๖๙ ",
-        "commto" : "นายสมชาย จรดปลายเท้า",
-        "addrno" : "3/77 xxx yyy ทุ่งสองห้อง,หลักสี่, จังหวัดกรุงเทพฯ ",        
-        "groupname":"ผู้อำนวยการโรงเรียน",
-
-        "accuser": "นายธีรพล ร่มเริง",
-        "acc1": "ผู้ฟ้องคดี",
-        "accused": "รร",
-        "acc2": "ผู้ถูกฟ้องคดี",
-        "interpleader": "สมชาย ใจดี",
-        "acc3": "ผู้ร้องสอด",
-        "detail1": "ตุลาการเจ้าของสำนวนได้พิจารณาคำฟ้อง และเอกสารประกอบคำฟ้องแล้ว เห็นว่าคดีนี้เป็นคดีพิพาทซึ่งไม่อยู่ในอำนาจศาลปกครองสูงสุด\n\nผู้ฟ้องเป็นผู้มีสิทธิฟ้องคดี คดีนี้มีกฎหมายกำหนดให้ต้องดำเนินการแก้ไข ความเดือดร้อนหรือเสียหายก่อนฟ้องคดี ",
-        "sendto" : "นายสมศักดิ์ ฟักมี",
-        
-        "warning": "หากผู้ถูกฟ้องคดีไม่ปฏิบัติตามคำสั่งศาลภายในระยะเวลาที่กำหนด ศาลจะถือว่า ผู้ถูกฟ้องคดียอมรับข้อเท็จจริงตามข้อหาของผู้ฟ้องคดี",
-        "detail2":"คำสั่งเพิ่มเติมคือ bla bla",
-        "remarkhead":"หัวของ Remark",
-        "remark":"This is remark Text bla bla "
-    }
-}

public/tmpl/index.html

@@ -1,20 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Document</title>
-</head>
-<body>
-    <h1>Template & Data</h1>
-
-    <ol>
-        <li><a href="T12_X.docx">T12_X</a> 
-            (<a href="T12_b2_IN.json">T12_b2_IN</a>, <a href="T12_FD155_3s-long.json">T12_FD155_3s-long</a>)
-        </li>
-        <li><a href="T_X.docx">T_X</a>
-            (<a href="TF_no_warning_P2.json">TF_no_warning_P2</a>, <a href="T_no_warning">T_no_warning</a>, <a href="T_no_warning">TS_P2_IN.json</a>)
-        </li>
-    </ol>
-</body>
-</html>

public/wordaddin/manifest.template.xml

@@ -18,7 +18,7 @@
 -->
 <OfficeApp xmlns="http://schemas.microsoft.com/office/appforoffice/1.1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:bt="http://schemas.microsoft.com/office/officeappbasictypes/1.0" xmlns:ov="http://schemas.microsoft.com/office/taskpaneappversionoverrides" xsi:type="TaskPaneApp">
   <Id>4a1e184a-ab31-4fa4-b3c7-9a2283051c3f</Id>
-  <Version>1.0.0.2</Version>
+  <Version>1.0.0.1</Version>
   <ProviderName>e-Court Documents Versioning</ProviderName>
   <DefaultLocale>en-US</DefaultLocale>
   <DisplayName DefaultValue="e-Court Documents Versioning"/>
@@ -33,16 +33,11 @@
     <Host Name="Document"/>
   </Hosts>
   <!-- Requirement sets ที่ services layer ใช้จริง — host ที่ไม่รองรับจะไม่โหลด add-in เลย (fail fast ดีกว่าพังกลางทาง)
-       WordApi 1.3: API สูงสุดที่ใช้นอกเหนือจาก close() — customXmlParts (1.3), customProperties /
+       WordApi 1.5: customProperties / customXmlParts / document.save()
-       document.save() / contentControls (1.1) — และเป็นระดับสูงสุดที่ Office 2019 perpetual
-       รองรับ (WordApi 1.4/1.5 = Microsoft 365 เท่านั้น — เดิมตั้ง 1.5 ทำให้เครื่องศาลที่ใช้
-       Office 2019 โหลด add-in ไม่ขึ้นเลย 2026-10-16); document.close() (FR-18) ตรวจ runtime
-       แยกที่ canCloseDocument() → isSetSupported("WordApi","1.5") — เครื่องที่ไม่ถึงซ่อนปุ่ม
-       ปิดเอกสารทุกแบบ (พฤติกรรมเดียวกับ Word on the web)
        OpenBrowserWindowApi 1.1: เปิด presigned download URL ในเบราว์เซอร์ของเครื่อง (webview ของ Word ทิ้ง blob download) -->
   <Requirements>
     <Sets DefaultMinVersion="1.1">
-      <Set Name="WordApi" MinVersion="1.3"/>
+      <Set Name="WordApi" MinVersion="1.5"/>
       <Set Name="OpenBrowserWindowApi" MinVersion="1.1"/>
     </Sets>
   </Requirements>

tests/lib/document-versioning.test.ts

@@ -1,217 +0,0 @@
-import { describe, expect, it } from "vitest";
-
-import {
-  DOCVER_MESSAGE_MAX,
-  contentDispositionValue,
-  docverError,
-  isDocxBytes,
-  isPdfBytes,
-  parseDownloadFormat,
-  parseFieldsJson,
-  parseVersionIdParam,
-  parseVersionUploadForm,
-  sanitizeDisplayFileName,
-  sanitizeFilePartName,
-} from "@/lib/document-versioning";
-
-// docver (PLAN-DOCVER.md) — validation ล้วนของ /api/documents/*: ไฟล์นี้ตั้งใจไม่แตะ
-// module ใดที่ลาก @/db หรือ minio มาด้วย (pattern เดียวกับ external-api-auth.test.ts
-// — vitest ไม่โหลด .env จึงต้องรันได้โดยไม่ตั้ง DATABASE_URL/MINIO_*)
-
-function ok<T>(result: { ok: boolean } & T): asserts result is { ok: true } & T {
-  expect(result.ok).toBe(true);
-}
-
-describe("parseVersionIdParam", () => {
-  it("รับ UUID ทั้งพิมพ์ใหญ่/เล็ก (normalize ลงตัวพิมพ์เล็ก) + trim", () => {
-    const result = parseVersionIdParam("  6F9619FF-8B86-D011-B42D-00C04FC964FF  ");
-    ok(result);
-    expect(result.versionId).toBe("6f9619ff-8b86-d011-b42d-00c04fc964ff");
-  });
-
-  it("ตกเมื่อไม่ใช่รูป UUID", () => {
-    for (const raw of ["not-a-uuid", "123", "{6f9619ff-8b86-d011-b42d-00c04fc964ff}", ""]) {
-      expect(parseVersionIdParam(raw).ok).toBe(false);
-    }
-  });
-});
-
-describe("parseDownloadFormat", () => {
-  it("ไม่ส่ง/ว่าง/ข้างในมี whitespace = docx (default ตาม contract)", () => {
-    for (const raw of [null, "", "   ", " docx "]) {
-      const result = parseDownloadFormat(raw);
-      ok(result);
-      expect(result.format).toBe("docx");
-    }
-  });
-
-  it("รับ pdf ตรง ๆ และตกเมื่อค่าอื่น (รวมพิมพ์ใหญ่)", () => {
-    const pdf = parseDownloadFormat("pdf");
-    ok(pdf);
-    expect(pdf.format).toBe("pdf");
-    for (const raw of ["exe", "PDF", "docxx"]) {
-      expect(parseDownloadFormat(raw).ok).toBe(false);
-    }
-  });
-});
-
-describe("isDocxBytes / isPdfBytes", () => {
-  it("ผ่านเมื่อ magic bytes ตรง (แม้ buffer สั้นกว่าที่อ่าน)", () => {
-    expect(isDocxBytes(Buffer.from("PK\x03\x04rest-of-zip"))).toBe(true);
-    expect(isPdfBytes(Buffer.from("%PDF-1.7\n..."))).toBe(true);
-  });
-
-  it("ตกเมื่อ signature ผิดหรือ buffer ว่าง/สั้นกว่า signature", () => {
-    expect(isDocxBytes(Buffer.from("%PDF-1.7"))).toBe(false);
-    expect(isDocxBytes(Buffer.from("PK"))).toBe(false);
-    expect(isDocxBytes(Buffer.alloc(0))).toBe(false);
-    expect(isPdfBytes(Buffer.from("PK\x03\x04"))).toBe(false);
-    expect(isPdfBytes(Buffer.from("%PD"))).toBe(false);
-    expect(isPdfBytes(Buffer.alloc(0))).toBe(false);
-  });
-});
-
-describe("parseFieldsJson", () => {
-  it("แยก JSON object ล้วนได้ และ `{}` = null (ถือว่าไม่ส่ง)", () => {
-    const result = parseFieldsJson('{"blackno":"คดีหมายเลขดำที่"}');
-    ok(result);
-    expect(result.fields).toEqual({ blackno: "คดีหมายเลขดำที่" });
-    const empty = parseFieldsJson("{}");
-    ok(empty);
-    expect(empty.fields).toBeNull();
-  });
-
-  it("ตกเมื่อ JSON เพี้ยน / ไม่ใช่ object / value ไม่ใช่ string", () => {
-    for (const raw of ["ไม่ใช่ JSON", "[1,2]", '"string"', "null", '{"a":1}']) {
-      expect(parseFieldsJson(raw).ok).toBe(false);
-    }
-  });
-});
-
-describe("parseVersionUploadForm", () => {
-  // identity (userId/userName) กับ templateId ถอดออกจาก form แล้ว — route แกะจาก
-  // Bearer token ผ่าน lib/docver-token.ts (เคสของ token อยู่ docver-token.test.ts)
-  function baseForm(): FormData {
-    const form = new FormData();
-    form.append("file", new File([Buffer.from("PK\x03\x04")], "draft.docx"));
-    return form;
-  }
-
-  it("happy path: แยกทุก field + trim ค่าว่างเป็น null + fileName ตัด path ที่ฝังมา", () => {
-    const form = baseForm();
-    form.append("clientVersionId", " 11111111-1111-4111-8111-111111111111 ");
-    form.append("message", "   ");
-    form.append("fields", '{"blackno":"1"}');
-    form.append("fileName", "C:\\Users\\judge\\คำสั่งเรียก.docx");
-    const result = parseVersionUploadForm(form);
-    ok(result);
-    expect(result.form).toEqual({
-      clientVersionId: "11111111-1111-4111-8111-111111111111",
-      message: null,
-      fileName: "คำสั่งเรียก.docx",
-      fields: { blackno: "1" },
-    });
-  });
-
-  it("ตกเมื่อมี field ที่ไม่รู้จัก (กัน typo เงียบ ๆ)", () => {
-    const form = baseForm();
-    form.append("oops", "1");
-    const result = parseVersionUploadForm(form);
-    expect(result.ok).toBe(false);
-    if (!result.ok) expect(result.error).toContain("oops");
-  });
-
-  it("ส่ง userId/userName/templateId ใน form = 400 ไม่รู้จัก field (identity มาจาก token)", () => {
-    for (const legacy of ["userId", "userName", "templateId"]) {
-      const form = baseForm();
-      form.append(legacy, "x");
-      const result = parseVersionUploadForm(form);
-      expect(result.ok).toBe(false);
-      if (!result.ok) expect(result.error).toContain(legacy);
-    }
-  });
-
-  it("ตกเมื่อ text field ถูกส่งมาเป็นไฟล์", () => {
-    const form = baseForm();
-    form.append("message", new File(["x"], "m.txt"));
-    const result = parseVersionUploadForm(form);
-    expect(result.ok).toBe(false);
-    if (!result.ok) expect(result.error).toContain("message");
-  });
-
-  it(`message ยาว ${DOCVER_MESSAGE_MAX} ผ่าน แต่เกิน = ตก`, () => {
-    const edge = baseForm();
-    edge.append("message", "a".repeat(DOCVER_MESSAGE_MAX));
-    ok(parseVersionUploadForm(edge));
-    const over = baseForm();
-    over.append("message", "a".repeat(DOCVER_MESSAGE_MAX + 1));
-    expect(parseVersionUploadForm(over).ok).toBe(false);
-  });
-
-  it("fields ใน form ผิดกติกาส่งต่อ error ของ parseFieldsJson", () => {
-    const form = baseForm();
-    form.append("fields", '{"a":1}');
-    expect(parseVersionUploadForm(form).ok).toBe(false);
-  });
-});
-
-describe("sanitizeDisplayFileName / sanitizeFilePartName", () => {
-  it("ตัด path ฝังมา (ทั้ง / และ \\) + trim ว่าง = null + cap 200", () => {
-    expect(sanitizeDisplayFileName("C:\\Users\\judge\\a.docx")).toBe("a.docx");
-    expect(sanitizeDisplayFileName("/tmp/b.pdf")).toBe("b.pdf");
-    expect(sanitizeDisplayFileName("   ")).toBeNull();
-    expect(sanitizeDisplayFileName(null)).toBeNull();
-    expect(sanitizeDisplayFileName(`${"a".repeat(250)}.docx`)).toHaveLength(200);
-  });
-
-  it("File.name ที่ undici ถอดเป็น latin1 (ชื่อไทยเพี้ยนแบบ N4) กู้คืนเป็น UTF-8 ได้", () => {
-    const original = "คำสั่งเรียกเอกสาร.docx";
-    const mangled = Buffer.from(original, "utf8").toString("latin1");
-    expect(mangled).not.toBe(original); // ต้องเพี้ยนจริงก่อน ไม่ใช่ทดสอบตัวเอง
-    expect(sanitizeFilePartName(mangled)).toBe(original);
-    // ชื่อ ASCII ไม่มีตัว U+0080–U+00FF จึงไม่ถูกแตะ
-    expect(sanitizeFilePartName("plain.docx")).toBe("plain.docx");
-  });
-});
-
-describe("docverError", () => {
-  it("สร้าง Response JSON ไทยพร้อม status ที่ขอ", async () => {
-    const res = docverError("ไม่พบ version นี้ของเอกสาร", 404);
-    expect(res.status).toBe(404);
-    expect(res.headers.get("content-type")).toBe("application/json; charset=utf-8");
-    expect(await res.json()).toEqual({ error: "ไม่พบ version นี้ของเอกสาร" });
-  });
-});
-
-describe("contentDispositionValue", () => {
-  it("ไม่มีชื่อ = ชื่อ default อย่างเดียว", () => {
-    expect(contentDispositionValue(null, "docx")).toBe('attachment; filename="document.docx"');
-    expect(contentDispositionValue("   ", "pdf")).toBe('attachment; filename="document.pdf"');
-  });
-
-  it("ชื่อ ASCII: เติม extension ที่ขาด / คงชื่อที่มีอยู่แล้ว / ตัด quote-backslash", () => {
-    expect(contentDispositionValue("Report Final", "docx")).toBe(
-      'attachment; filename="Report Final.docx"; filename*=UTF-8\'\'Report%20Final',
-    );
-    expect(contentDispositionValue("Report Final.docx", "docx")).toBe(
-      'attachment; filename="Report Final.docx"; filename*=UTF-8\'\'Report%20Final.docx',
-    );
-    expect(contentDispositionValue('bad"name\\', "pdf")).toBe(
-      'attachment; filename="badname.pdf"; filename*=UTF-8\'\'bad%22name%5C',
-    );
-  });
-
-  it("ชื่อไทยล้วน = ASCII fallback เป็นชื่อ default แต่ filename* ยังชื่อเต็ม", () => {
-    expect(contentDispositionValue("คำสั่งเรียก", "docx")).toBe(
-      'attachment; filename="document.docx"; filename*=UTF-8\'\''
-      + encodeURIComponent("คำสั่งเรียก"),
-    );
-  });
-
-  it("ชื่อผสมไทย+เลข = ส่วน ASCII ที่เหลือใช้เป็น fallback ได้", () => {
-    expect(contentDispositionValue("รายงาน 2026", "pdf")).toBe(
-      'attachment; filename="2026.pdf"; filename*=UTF-8\'\''
-      + encodeURIComponent("รายงาน 2026"),
-    );
-  });
-});

tests/lib/docver-token.test.ts

@@ -1,316 +0,0 @@
-import { createHmac } from "node:crypto";
-import { afterEach, describe, expect, it } from "vitest";
-
-import {
-  issueDocverToken,
-  parseTokenRequestBody,
-  requireDocverApiKey,
-  requireDocverBearer,
-  verifyDocverToken,
-  type DocverTokenClaims,
-} from "@/lib/docver-token";
-
-// docver token (PLAN-DOCVER.md §auth) — validation/auth ล้วนของ /api/documents/*:
-// ไฟล์นี้ตั้งใจไม่แตะ module ใดที่ลาก @/db หรือ minio มาด้วย (pattern เดียวกับ
-// external-api-auth.test.ts — vitest ไม่โหลด .env จึงต้องรันได้โดยไม่ต้องตั้ง
-// DATABASE_URL/MINIO_*)
-
-const SECRET = "test-secret-docver";
-const CLAIMS: DocverTokenClaims = {
-  userid: "123",
-  username: "Sorawit Bholsithi",
-  fid: "3",
-  template: "T12",
-};
-
-function ok<T>(result: { ok: boolean } & T): asserts result is { ok: true } & T {
-  expect(result.ok).toBe(true);
-}
-
-// --- env save/restore — require* อ่าน env ตอนเรียก ไม่ใช่ตอน module load
-const HAD_API_KEY = Object.prototype.hasOwnProperty.call(process.env, "DOCVER_API_KEY");
-const ORIG_API_KEY = process.env.DOCVER_API_KEY;
-const HAD_SECRET = Object.prototype.hasOwnProperty.call(process.env, "DOCVER_TOKEN_SECRET");
-const ORIG_SECRET = process.env.DOCVER_TOKEN_SECRET;
-
-afterEach(() => {
-  if (HAD_API_KEY) process.env.DOCVER_API_KEY = ORIG_API_KEY;
-  else delete process.env.DOCVER_API_KEY;
-  if (HAD_SECRET) process.env.DOCVER_TOKEN_SECRET = ORIG_SECRET;
-  else delete process.env.DOCVER_TOKEN_SECRET;
-});
-
-function reqWithKey(key?: string): Request {
-  return new Request("http://localhost/docedit/api/documents/token", {
-    headers: key === undefined ? {} : { "x-api-key": key },
-  });
-}
-
-function reqWithBearer(authorization: string | null): Request {
-  return new Request("http://localhost/docedit/api/documents/doc1/versions", {
-    headers: authorization === null ? {} : { authorization },
-  });
-}
-
-async function bodyOf(res: Response): Promise<{ error: string }> {
-  expect(res.headers.get("content-type")).toBe("application/json; charset=utf-8");
-  return (await res.json()) as { error: string };
-}
-
-/** เซ็น payload ใด ๆ ด้วย SECRET ผ่านมือ — ใช้ประกอบเคส claims ผิดรูปที่ issueDocverToken สร้างเองไม่ได้ */
-function signPayload(payload: Record<string, unknown>): string {
-  const header = Buffer.from(JSON.stringify({ alg: "HS256", typ: "JWT" }), "utf8").toString(
-    "base64url",
-  );
-  const body = Buffer.from(JSON.stringify(payload), "utf8").toString("base64url");
-  const signature = createHmac("sha256", SECRET)
-    .update(`${header}.${body}`)
-    .digest("base64url");
-  return `${header}.${body}.${signature}`;
-}
-
-describe("issueDocverToken / verifyDocverToken", () => {
-  it("issue → verify ได้ claims ครบทุกตัว (userid/username/fid/template)", () => {
-    const verified = verifyDocverToken(issueDocverToken(CLAIMS, SECRET, 60), SECRET);
-    ok(verified);
-    expect(verified.claims).toEqual(CLAIMS);
-  });
-
-  it("template เป็นทางเลือก (null ได้) แต่ fid บังคับ — token ไม่มี fid = ไม่ผ่าน", () => {
-    const verified = verifyDocverToken(
-      issueDocverToken({ userid: "u1", username: "ชื่อ", fid: "7", template: null }, SECRET, 60),
-      SECRET,
-    );
-    ok(verified);
-    expect(verified.claims).toEqual({ userid: "u1", username: "ชื่อ", fid: "7", template: null });
-    const noFid = signPayload({
-      userid: "u1",
-      username: "n",
-      template: "T1",
-      iat: 0,
-      exp: Math.floor(Date.now() / 1000) + 60,
-    });
-    expect(verifyDocverToken(noFid, SECRET).ok).toBe(false);
-  });
-
-  it("แก้ payload แล้วใช้ signature เดิม (tampered) หรือ secret ผิด = ไม่ผ่าน", () => {
-    const token = issueDocverToken(CLAIMS, SECRET, 60);
-    const [header, , signature] = token.split(".");
-    const tamperedPayload = Buffer.from(
-      JSON.stringify({ ...CLAIMS, userid: "999" }),
-      "utf8",
-    ).toString("base64url");
-    expect(verifyDocverToken(`${header}.${tamperedPayload}.${signature}`, SECRET).ok).toBe(false);
-    expect(verifyDocverToken(token, "wrong-secret").ok).toBe(false);
-  });
-
-  it("header alg อื่น (none / HS512) = ไม่ผ่าน แม้จะเซ็นด้วย secret ถูก (กัน alg-confusion)", () => {
-    const body = Buffer.from(
-      JSON.stringify({ ...CLAIMS, iat: 0, exp: Math.floor(Date.now() / 1000) + 60 }),
-      "utf8",
-    ).toString("base64url");
-    for (const alg of ["none", "HS512"]) {
-      const header = Buffer.from(JSON.stringify({ alg, typ: "JWT" }), "utf8").toString("base64url");
-      const signature = createHmac("sha256", SECRET)
-        .update(`${header}.${body}`)
-        .digest("base64url");
-      expect(verifyDocverToken(`${header}.${body}.${signature}`, SECRET).ok).toBe(false);
-    }
-  });
-
-  it("token หมดอายุ (ttl ติดลบ) หรือไม่มี exp = ไม่ผ่าน", () => {
-    expect(verifyDocverToken(issueDocverToken(CLAIMS, SECRET, -10), SECRET).ok).toBe(false);
-    const noExp = signPayload({ ...CLAIMS, iat: Math.floor(Date.now() / 1000) });
-    expect(verifyDocverToken(noExp, SECRET).ok).toBe(false);
-  });
-
-  it("claims ไม่ครบรูปร่าง (แม้เซ็นถูก) = ไม่ผ่าน — กัน token เซ็นเองหลุดไปใช้", () => {
-    const now = Math.floor(Date.now() / 1000) + 60;
-    for (const bad of [
-      { username: "n", fid: "3", template: null, iat: 0, exp: now }, // ไม่มี userid
-      { userid: "u", fid: "3", template: null, iat: 0, exp: now }, // ไม่มี username
-      { userid: "", username: "n", fid: "3", template: null, iat: 0, exp: now }, // userid ว่าง
-      { userid: "u", username: "n", fid: 3, template: null, iat: 0, exp: now }, // fid เป็น number
-      { userid: "u", username: "n", fid: "", template: null, iat: 0, exp: now }, // fid ว่าง
-      { userid: "u", username: "n", template: null, iat: 0, exp: now }, // ไม่มี fid (บังคับแล้ว)
-      { userid: "u", username: "n", fid: null, template: null, iat: 0, exp: now }, // fid null
-    ]) {
-      expect(verifyDocverToken(signPayload(bad), SECRET).ok).toBe(false);
-    }
-  });
-
-  it("รูป token ผิด (ไม่ใช่ 3 segment / segment เป็น base64 ปกติไม่ใช่ base64url) = ไม่ผ่าน", () => {
-    expect(verifyDocverToken("not-a-jwt", SECRET).ok).toBe(false);
-    expect(verifyDocverToken("a.b.c.d", SECRET).ok).toBe(false);
-    // base64 ปกติมี + / ซึ่ง base64url decode แล้วได้ byte ผิด → header/payload พัง
-    expect(verifyDocverToken("???.???.???", SECRET).ok).toBe(false);
-  });
-});
-
-describe("requireDocverApiKey", () => {
-  it("env ไม่ตั้ง / ว่าง / ช่องว่างล้วน = 401 fail closed ทุกกรณี", async () => {
-    for (const value of [undefined, "", "   "]) {
-      if (value === undefined) delete process.env.DOCVER_API_KEY;
-      else process.env.DOCVER_API_KEY = value;
-      const res = requireDocverApiKey(reqWithKey("test-key"));
-      expect(res?.status).toBe(401);
-      expect(await bodyOf(res!)).toEqual({ error: "ระบบยังไม่ได้ตั้งค่า API key" });
-    }
-  });
-
-  it("ไม่ใส่ header กับ key ผิด ต้องได้ 401 ข้อความเดียวกันเป๊ะ (กัน enumerate)", async () => {
-    process.env.DOCVER_API_KEY = "test-key";
-    const missing = requireDocverApiKey(reqWithKey());
-    const wrong = requireDocverApiKey(reqWithKey("not-the-key"));
-    expect(missing?.status).toBe(401);
-    expect(wrong?.status).toBe(401);
-    expect(await bodyOf(missing!)).toEqual(await bodyOf(wrong!));
-  });
-
-  it("key ตรง = ผ่าน (คืน null) · env มี whitespace รอบ ๆ ก็ trim ให้เทียบได้", () => {
-    process.env.DOCVER_API_KEY = "test-key";
-    expect(requireDocverApiKey(reqWithKey("test-key"))).toBeNull();
-    process.env.DOCVER_API_KEY = "  test-key  ";
-    expect(requireDocverApiKey(reqWithKey("test-key"))).toBeNull();
-  });
-});
-
-describe("requireDocverBearer", () => {
-  it("ทุกกรณีพ้นสภาพ (ไม่มี header / ไม่ใช่ Bearer / token เน่า / หมดอายุ / secret ไม่ตั้ง) = 401 ข้อความเดียวกัน", async () => {
-    const deniedBodies = new Set<string>();
-    const cases: { label: string; secret: string | undefined; authorization: string | null }[] = [
-      { label: "ไม่มี Authorization", secret: SECRET, authorization: null },
-      { label: "scheme อื่น (Basic)", secret: SECRET, authorization: "Basic dXNlcjpwYXNz" },
-      { label: "Bearer ว่างเปล่า", secret: SECRET, authorization: "Bearer " },
-      { label: "token เน่า", secret: SECRET, authorization: "Bearer garbage.token.here" },
-      {
-        label: "token หมดอายุ",
-        secret: SECRET,
-        authorization: `Bearer ${issueDocverToken(CLAIMS, SECRET, -10)}`,
-      },
-      {
-        label: "เซ็นด้วย secret ผิด",
-        secret: SECRET,
-        authorization: `Bearer ${issueDocverToken(CLAIMS, "other-secret", 60)}`,
-      },
-      { label: "secret ไม่ตั้ง (fail closed)", secret: undefined, authorization: null },
-      {
-        label: "secret ไม่ตั้งแม้จะมี token ถูก",
-        secret: undefined,
-        authorization: `Bearer ${issueDocverToken(CLAIMS, SECRET, 60)}`,
-      },
-    ];
-    for (const testCase of cases) {
-      if (testCase.secret === undefined) delete process.env.DOCVER_TOKEN_SECRET;
-      else process.env.DOCVER_TOKEN_SECRET = testCase.secret;
-      const auth = requireDocverBearer(reqWithBearer(testCase.authorization));
-      expect(auth.ok, testCase.label).toBe(false);
-      if (!auth.ok) {
-        expect(auth.response.status, testCase.label).toBe(401);
-        deniedBodies.add(JSON.stringify(await bodyOf(auth.response)));
-      }
-    }
-    expect(deniedBodies.size).toBe(1); // ข้อความ 401 เดียวกันหมด — ไม่ใช้ endpoint เป็น oracle
-  });
-
-  it("Bearer ที่ verify ผ่าน = ได้ claims · คำว่า bearer พิมพ์เล็กก็รับ (case-insensitive)", () => {
-    process.env.DOCVER_TOKEN_SECRET = SECRET;
-    const token = issueDocverToken(CLAIMS, SECRET, 60);
-    const auth = requireDocverBearer(reqWithBearer(`Bearer ${token}`));
-    ok(auth);
-    expect(auth.claims).toEqual(CLAIMS);
-    const lower = requireDocverBearer(reqWithBearer(`bearer ${token}`));
-    ok(lower);
-    expect(lower.claims).toEqual(CLAIMS);
-  });
-
-  it("env มี whitespace รอบ secret ก็ trim แล้ว verify ได้", () => {
-    process.env.DOCVER_TOKEN_SECRET = `  ${SECRET}  `;
-    const auth = requireDocverBearer(
-      reqWithBearer(`Bearer ${issueDocverToken(CLAIMS, SECRET, 60)}`),
-    );
-    ok(auth);
-    expect(auth.claims).toEqual(CLAIMS);
-  });
-});
-
-describe("parseTokenRequestBody", () => {
-  it("ครบทุก field = ได้ claims (trim ค่า) · template ไม่ส่ง = null (fid บังคับ)", () => {
-    const full = parseTokenRequestBody({
-      userid: " 123 ",
-      username: " Sorawit Bholsithi ",
-      fid: " 3 ",
-      template: " T12 ",
-    });
-    ok(full);
-    expect(full.claims).toEqual({ userid: "123", username: "Sorawit Bholsithi", fid: "3", template: "T12" });
-
-    const minimal = parseTokenRequestBody({ userid: "123", username: "Sorawit", fid: "3" });
-    ok(minimal);
-    expect(minimal.claims).toEqual({ userid: "123", username: "Sorawit", fid: "3", template: null });
-  });
-
-  it("template ส่งมาเป็นช่องว่าง = null (ถือว่าไม่ส่ง)", () => {
-    const result = parseTokenRequestBody({ userid: "123", username: "n", fid: "3", template: "   " });
-    ok(result);
-    expect(result.claims.template).toBeNull();
-  });
-
-  it("ไม่ใช่ object (array / string / null) = 400", () => {
-    for (const raw of [[], "text", null]) {
-      const result = parseTokenRequestBody(raw);
-      expect(result.ok).toBe(false);
-      if (!result.ok) expect(result.error).toBe("body ต้องเป็น JSON object");
-    }
-  });
-
-  it("key อื่นนอก allowlist = 400 ไม่รู้จัก field (กัน typo เงียบ ๆ)", () => {
-    const result = parseTokenRequestBody({ userid: "1", username: "n", oops: 1 });
-    expect(result.ok).toBe(false);
-    if (!result.ok) expect(result.error).toContain("oops");
-  });
-
-  it("ขาด userid หรือ username / ส่งมาไม่ใช่ string = 400 ข้อความเฉพาะ field", () => {
-    for (const raw of [
-      { username: "n" },
-      { userid: "  ", username: "n" },
-      { userid: 123, username: "n" },
-      { userid: "1" },
-      { userid: "1", username: "" },
-    ]) {
-      const result = parseTokenRequestBody(raw);
-      expect(result.ok).toBe(false);
-      if (!result.ok) {
-        expect(result.error).toMatch(/ต้องระบุ (userid|username)/);
-      }
-    }
-  });
-
-  it("fid ขาด/null/ว่าง/ไม่ใช่ string (number) หรือ template ไม่ใช่ string = 400", () => {
-    const missing = parseTokenRequestBody({ userid: "1", username: "n" });
-    expect(missing.ok).toBe(false);
-    if (!missing.ok) expect(missing.error).toContain("fid");
-    for (const raw of [
-      { userid: "1", username: "n", fid: null },
-      { userid: "1", username: "n", fid: 3 },
-      { userid: "1", username: "n", fid: "" },
-      { userid: "1", username: "n", fid: "   " },
-      { userid: "1", username: "n", template: 12 },
-    ]) {
-      expect(parseTokenRequestBody(raw).ok).toBe(false);
-    }
-  });
-
-  it("ความยาวเกิน cap: userid > 100 / username > 200 / fid > 200 / template > 100 = 400", () => {
-    expect(parseTokenRequestBody({ userid: "a".repeat(101), username: "n" }).ok).toBe(false);
-    expect(
-      parseTokenRequestBody({ userid: "1", username: "a".repeat(201) }).ok,
-    ).toBe(false);
-    expect(
-      parseTokenRequestBody({ userid: "1", username: "n", fid: "a".repeat(201) }).ok,
-    ).toBe(false);
-    expect(
-      parseTokenRequestBody({ userid: "1", username: "n", template: "a".repeat(101) }).ok,
-    ).toBe(false);
-  });
-});

wordaddin/services/errors.ts

@@ -8,21 +8,3 @@ export function getErrorMessage(error: unknown, fallback: string): string {
   }
   return fallback;
 }
-
-/** เหมือน getErrorMessage แต่ต่อท้าย code/errorLocation จาก debugInfo ของ OfficeExtension.Error —
- *  สำหรับ error จาก Word.run ที่ต้องการสาเหตุละเอียด (เช่น ราย tag ที่เขียนค่าไม่สำเร็จ) */
-export function getDetailedErrorMessage(
-  error: unknown,
-  fallback = "เกิดข้อผิดพลาดที่ไม่ทราบสาเหตุ",
-): string {
-  if (error instanceof Error && error.message) {
-    const debugInfo = (error as { debugInfo?: { code?: string; errorLocation?: string } }).debugInfo;
-    const code = debugInfo?.code ? ` [${debugInfo.code}]` : "";
-    const location = debugInfo?.errorLocation ? ` (${debugInfo.errorLocation})` : "";
-    return `${error.message}${code}${location}`;
-  }
-  if (typeof error === "string" && error) {
-    return error;
-  }
-  return fallback;
-}

wordaddin/services/templateService.ts

@@ -1,240 +0,0 @@
-/* global Word, Office */
-
-/**
- * แท็บ "เครื่องมือ Template" (แท็บที่สองของ taskpane) — เครื่องมือจัดการ Content Controls
- * ฝั่ง Office.js ล้วน ไม่ยิง backend: สแกนรายช่อง / กระโดดไปเลือกช่อง / เขียนค่าทดสอบกลับ
- * เข้าเอกสาร / แทรกย่อหน้า-ตัวแบ่งบรรทัด-ตัวแบ่งหน้าที่ cursor
- *
- * API ที่ใช้เป็น WordApi 1.1 เกือบทั้งหมด (ยืนยันจาก @types/office-js 1.0.612) ยกเว้น
- * getByIdOrNullObject (1.3) — ไม่เกินความต้องการต่ำสุดของ manifest (1.3) จึงใช้ได้ทุก platform
- * รวม Office 2019 และ Word on the web
- *
- * ⚠️ collection `contentControls` ธรรมดามองเห็น**เฉพาะ rich text CC** (docstring ของ
- * Body.contentControls: "rich text content control objects") — template ของศาลส่วนใหญ่เป็น
- * plain text CC จึงต้องใช้ `Document.getContentControls()` (WordApi 1.5, ครอบทุกชนิดที่รองรับ)
- * ผ่าน feature-detect ตอน runtime แทนการยก MinVersion ของ manifest (Office 2019 = 1.3
- * ต้องยังโหลดได้ — เห็นเฉพาะ rich text + UI แจ้งเตือน)
- *
- * กติกาตาม repo: ห้ามมี Office/Word access ระดับ top-level (module นี้ถูก evaluate ใน
- * browser ธรรมดาตอนโหมด `?addindemo` ที่ไม่มี Office global — top-level access จะ throw ก่อน UI ทัน render) · operation ที่เขียนเอกสารต้อง suspend/resume
- * auto-save คู่กันเสมอ และเรียก notifyDocumentChanged() หลังสำเร็จให้ debounce และ flag FR-3
- * ทำงานถูกต้อง (pattern เดียวกับ versionFlow.ts)
- */
-
-import { autoSaveService } from "./autoSaveService";
-import { getDetailedErrorMessage } from "./errors";
-
-/** ผลสแกนหนึ่งช่อง — id ของ CC ไม่เสถียรข้าม session/coauthor (ตาม docstring ของ Office.js
- *  เอง: "The ID differs across sessions and coauthors") จึงใช้ได้เฉพาะอายุผลสแกนรอบเดียว ห้ามเก็บไปใช้ภายหลัง */
-export interface ScannedField {
-  id: number;
-  /** tag ดิบไม่ trim — เพื่อให้ UI เตือน "tag ว่าง / มี space นำ-ท้าย" ได้ (ตอนเทียบ/ใช้งานคือ trim เสมอ) */
-  tag: string;
-  title: string;
-  text: string;
-  /** enum ดิบ เช่น "RichTextInline" — ไว้ debug ใน tooltip */
-  type: string;
-  /** heuristics หยาบจาก enum type: ลงท้ายด้วย "Inline" = ในบรรทัด ไม่งั้น = บล็อก */
-  kind: "inline" | "block";
-}
-
-function toScannedField(control: Word.ContentControl): ScannedField {
-  const type = control.type ?? "";
-  return {
-    id: control.id,
-    tag: control.tag ?? "",
-    title: control.title ?? "",
-    text: control.text ?? "",
-    type,
-    kind: type.endsWith("Inline") ? "inline" : "block",
-  };
-}
-
-/** host นี้มองเห็น CC ทุกชนิด (รวม plain text) ได้ไหม — WordApi 1.5+ เท่านั้น
- *  (เรียกนอก Word เช่น browser ธรรมดา → catch คืน false เสมอ ตามแบบ canCloseDocument) */
-export function supportsAllContentControlTypes(): boolean {
-  try {
-    return Office.context.requirements.isSetSupported("WordApi", "1.5");
-  } catch {
-    return false;
-  }
-}
-
-/** collection ของ CC ที่ host รองรับสูงสุด — 1.5+ ใช้ getContentControls() (ทุกชนิด)
- *  ต่ำกว่านั้นต้องยอมรับ collection  rich-text-only */
-function supportedContentControls(context: Word.RequestContext): Word.ContentControlCollection {
-  return supportsAllContentControlTypes()
-    ? context.document.getContentControls()
-    : context.document.contentControls;
-}
-
-/** สแกน Content Controls ทั้งเอกสาร (1 sync) — เรียงตามลำดับในเอกสาร · ไม่มีช่อง = คืน [] ไม่ error
- *  อ่านอย่างเดียวจึงไม่ต้อง suspend auto-save */
-export async function listContentControls(): Promise<ScannedField[]> {
-  return Word.run(async (context) => {
-    const controls = supportedContentControls(context);
-    controls.load("id, tag, title, text, type");
-    await context.sync();
-    return controls.items.map(toScannedField);
-  });
-}
-
-/** เลือก + เลื่อน Word ไปที่ช่องตาม id ของผลสแกน — select() ตาม docstring จะ scroll ให้เอง
- *  ไม่ใช่การแก้เอกสาร (document.saved ไม่ dirty) จึงไม่ต้อง suspend */
-export async function selectContentControl(id: number): Promise<void> {
-  await Word.run(async (context) => {
-    const control = supportedContentControls(context).getByIdOrNullObject(id);
-    control.load("id");
-    await context.sync();
-    if (control.isNullObject) {
-      throw new Error("ไม่พบช่องนี้ในเอกสาร (อาจถูกลบไปแล้ว) — กดสแกนใหม่");
-    }
-    control.select();
-    await context.sync();
-  });
-}
-
-/** แทรกย่อหน้าว่างใหม่หลังตำแหน่ง cursor (เหมือนกด Enter) — ปุ่มเสริมตอนจัดโครงสร้าง template
- *  (คำขอผู้ใช้ 2026-10-19: ตอนแก้ template ต้องเพิ่มย่อหน้าบ่อย แล้วเปิด formatting marks ตรวจ —
- *  ส่วนการเปิด/ปิด formatting marks เป็น application setting ที่ Office.js ไม่มี API ให้แตะ) */
-export async function insertParagraphAtSelection(): Promise<void> {
-  await autoSaveService.suspend();
-  try {
-    await Word.run(async (context) => {
-      context.document.getSelection().insertParagraph("", "After");
-      await context.sync();
-    });
-    autoSaveService.notifyDocumentChanged();
-  } finally {
-    autoSaveService.resume();
-  }
-}
-
-/** page break แบบ paragraph สมบูรณ์ (block-level) — w:p ครอบ run ที่มี <w:br w:type="page"/>
- *  ใช้เป็นวิธีสำรองเมื่อ insertBreak("Page") โดน E_FAIL (0x80004005) ในบางบริบท เช่น cursor
- *  อยู่ในตาราง (เคสจริงบน T3.docx 2026-10-19 — template ของศาลมีตารางเป็นโครงหลัก) · ระดับ fragment
- *  ต้องเป็น block-level เต็มตัว ไม่ใช่ run เดี่ยว (ลองแล้วยัง E_FAIL อีกรอบ) */
-const PAGE_BREAK_PARAGRAPH_OOXML =
-  '<w:p xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main"><w:r><w:br w:type="page"/></w:r></w:p>';
-
-/** แทรกตัวแบ่งที่ตำแหน่ง cursor — "line" = ขึ้นบรรทัดใหม่ในย่อหน้าเดิม (Shift+Enter) สำหรับ
- *  จัดที่อยู่/รายการให้ตรงแนว, "page" = ขึ้นหน้าใหม่ (Ctrl+Enter) สำหรับเอกสารหลายหน้า (คำขอผู้ใช้ 2026-10-19) */
-export async function insertBreakAtSelection(breakKind: "line" | "page"): Promise<void> {
-  await autoSaveService.suspend();
-  try {
-    if (breakKind === "line") {
-      await Word.run(async (context) => {
-        context.document.getSelection().insertBreak("Line", "After");
-        await context.sync();
-      });
-    } else {
-      // วิธีมาตรฐานก่อน — ถ้า host ปฏิเสธ (E_FAIL ในบางบริบท) สลับไป OOXML block-level
-      // (sync ที่พัง = คำสั่งถูกปฏิเสธ ไม่มีอะไรถูกเขียนค้าง จึง retry ได้; ถ้า retry ก็พัง
-      // โยน error ที่รวมทั้งสองสาเหตุ ไม่กลืนต้นเหตุแรกหาย)
-      let firstError: unknown;
-      try {
-        await Word.run(async (context) => {
-          context.document.getSelection().insertBreak("Page", "After");
-          await context.sync();
-        });
-        autoSaveService.notifyDocumentChanged();
-        return;
-      } catch (error) {
-        firstError = error;
-      }
-      try {
-        await Word.run(async (context) => {
-          context.document.getSelection().insertOoxml(PAGE_BREAK_PARAGRAPH_OOXML, "End");
-          await context.sync();
-        });
-      } catch (fallbackError) {
-        throw new Error(
-          `แทรกตัวแบ่งหน้าไม่สำเร็จทั้งสองวิธี — insertBreak: ${getDetailedErrorMessage(firstError)} · OOXML: ${getDetailedErrorMessage(fallbackError)}`,
-        );
-      }
-    }
-    autoSaveService.notifyDocumentChanged();
-  } finally {
-    autoSaveService.resume();
-  }
-}
-
-export interface ApplyFailure {
-  tag: string;
-  /** สาเหตุที่อ่านได้ (รวม code/errorLocation จาก OfficeExtension.Error ถ้ามี) */
-  reason: string;
-}
-
-export interface ApplyTestValuesResult {
-  /** จำนวนช่อง (CC) ที่ถูกเขียนค่าจริง — tag เดียวซ้ำหลายช่องนับทุกช่อง
-   *  ⚠️ ข้อจำกัด granularity ราย tag: ถ้า tag หนึ่งผูกหลายช่องและ batch sync พังกลางคัน
-   *  (ช่องแรกถูกเขียนแล้วแต่ช่องหลังโดนปฏิเสธ) ทั้ง tag จะถูกนับเป็น failures แม้บางช่องเขียนสำเร็จ —
-   *  เรียก listContentControls หลังเขียนเพื่อเห็นค่าจริงในเอกสาร */
-  appliedCount: number;
-  /** tag ที่ส่งค่ามาแต่ไม่มีช่องตรงในเอกสารตอนเขียน (เช่น ถูกลบไปหลังสแกน) */
-  missingTags: string[];
-  /** tag ที่ Word ปฏิเสธการเขียน (เช่น เอกสารถูก Restrict Editing หรือช่องถูกล็อค/แก้ไม่ได้) —
-   *  เขียนแบบแยกราย tag เพื่อให้เหลืออื่น ๆ ยังสำเร็จและรู้สาเหตุเป็นรายตัว */
-  failures: ApplyFailure[];
-}
-
-/** เขียนค่าทดสอบกลับเข้าทุก CC ที่ tag ตรง (tag ซ้ำหลายช่อง = เขียนทุกช่อง แบบตัวแปรเดียวหลายจุด)
- *  - ค่าที่เว้นว่างจะไม่ถูกแตะ (กันเผลอล้างค่าจริงของช่องนั้น) — ว่างทั้งหมด = ไม่เปิด Word.run
- *  - อ่าน id+tag สดรอบเดียว ไม่เชื่อ snapshot สแกน แล้วเขียน**แยก Word.run ราย tag** —
- *    tag ที่ Word ปฏิเสธ (เอกสารถูก Restrict Editing / ช่องแก้ไม่ได้) fail เฉพาะตัว เหลืออื่นยังเขียนได้
- *    และเหตุผลถูกเก็บลง failures (กรณีเคยเจอจริง: error 0x800A16C6 บนเอกสารที่ make-protected ล็อค) */
-export async function applyTestValues(values: Record<string, string>): Promise<ApplyTestValuesResult> {
-  const entries = Object.entries(values).filter(([, value]) => value.trim() !== "");
-  if (entries.length === 0) {
-    return { appliedCount: 0, missingTags: [], failures: [] };
-  }
-  await autoSaveService.suspend();
-  try {
-    // สำรวจ id ของ CC ราย tag รอบเดียว (เทียบหลัง trim เหมือนฟอร์ม) — id ใช้ได้ทั้ง session นี้
-    const idsByTag = new Map<string, number[]>();
-    await Word.run(async (context) => {
-      const controls = supportedContentControls(context);
-      controls.load("id, tag");
-      await context.sync();
-      for (const control of controls.items) {
-        const tag = (control.tag ?? "").trim();
-        if (tag === "" || !(tag in values)) continue;
-        const ids = idsByTag.get(tag) ?? [];
-        ids.push(control.id);
-        idsByTag.set(tag, ids);
-      }
-    });
-
-    let appliedCount = 0;
-    const missingTags: string[] = [];
-    const failures: ApplyFailure[] = [];
-    for (const [tag, value] of entries) {
-      const ids = idsByTag.get(tag);
-      if (!ids || ids.length === 0) {
-        missingTags.push(tag);
-        continue;
-      }
-      try {
-        let written = 0;
-        await Word.run(async (context) => {
-          const targets = ids.map((id) => supportedContentControls(context).getByIdOrNullObject(id));
-          targets.forEach((control) => control.load("id"));
-          await context.sync();
-          const alive = targets.filter((control) => !control.isNullObject);
-          alive.forEach((control) => control.insertText(value, "Replace"));
-          await context.sync();
-          written = alive.length;
-        });
-        appliedCount += written;
-      } catch (tagError) {
-        failures.push({ tag, reason: getDetailedErrorMessage(tagError) });
-      }
-    }
-    if (appliedCount > 0) {
-      autoSaveService.notifyDocumentChanged();
-    }
-    return { appliedCount, missingTags, failures };
-  } finally {
-    autoSaveService.resume();
-  }
-}

wordaddin/services/versioningService.ts

@@ -5,11 +5,6 @@
  * - คงชื่อ/ลายเซ็น uploadVersion/getVersions/getDownloadLink/newClientVersionId ไว้เป๊ะ —
  *   วันปลด mock: ก้อบ body ของต้นฉบับกลับมาได้เลย
  * - ต้นฉบับมีอีก 2 ตัวที่ไม่มี caller ใน UI จึงไม่พอร์ต: buildDownloadUrl, downloadVersion
- * - **วันปลด mock ห้ามส่ง userId/userName/templateId ใน FormData** — contract ของ
- *   POST /api/documents/versions ถอด 3 field นี้ออกแล้ว (ส่งมา = 400) และไม่มี
- *   segment {docId} ใน URL อีกต่อไป: server แกะ identity/template และ docId
- *   (= fid — fileId ของ e-Court, string) จาก Bearer token (ออกที่ POST
- *   /api/documents/token ด้วย x-api-key, fid บังคับ) ที่ apiClient.ts แนบให้อยู่แล้ว
  * - **metadata ของ version ถูก persist ลง localStorage** (record เล็ก ๆ ต่อ documentId) —
  *   ไม่งั้นปิดเอกสาร (taskpane ปิดตาม) แล้วเปิดใหม่ history ว่างเปล่า ทั้งที่ metadata
  *   การ track อยู่ในไฟล์จริง ทำให้ทดสอบวง FR-18 ปิด→เปิดใหม่ไม่ได้; blob ของไฟล์จริง