`, desktop aside sticky 15rem — pattern เดียวกับ GroupExplorer; คอลัมน์ content ครอบด้วย `
` ไม่ใช่ `` เพราะกฎ print break-inside ของ `main.summary-page section` มุ่งการ์ดรายหน้าข้างใน)
components/summary/SummaryList.tsx ← คอลัมน์ content ของหน้าสรุป — การ์ดรายหน้า "1 หน้า 1 การ์ด" หัวการ์ด sticky ระดับ viewport (เลขหน้า + บรรทัดสรุปหน้า `pageSummaryLine` **คำนวณจากรายการที่เห็นจริงหลังกรอง** + ปุ่ม "เปิดหน้านี้"; กลับเป็น position static ตอนพิมพ์ผ่านกฎ `.page-head` ใน globals.css) + แถว passive จุดคลิกเดียวคือปุ่ม `` "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 หน้า)
diff --git a/README.md b/README.md
index 31ffd89..c914253 100644
--- a/README.md
+++ b/README.md
@@ -19,7 +19,7 @@
| เครื่องมือ | เวอร์ชันที่ใช้พัฒนา/ทดสอบ | หมายเหตุ |
|---|---|---|
| Node.js | v24.3.0 | ≥ 20 น่าจะใช้ได้ |
-| Docker | 29.1.3 | ใช้รัน PostgreSQL container ตัวเดียว |
+| Docker | 29.1.3 | ใช้รัน PostgreSQL + MinIO ผ่าน `docker-compose.yml` |
## ขั้นตอน Setup จากศูนย์
@@ -31,17 +31,16 @@ npm install
> postinstall จะคัดลอก `pdf.worker.min.mjs` จาก `node_modules/pdfjs-dist/build/` มาไว้ที่ `public/` ให้อัตโนมัติ
-### 2. รัน PostgreSQL container
+### 2. รัน PostgreSQL + MinIO ด้วย docker compose
```bash
-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
+docker compose up -d
```
-ครั้งต่อไปแค่ `docker start judes-note-db` — ข้อมูลอยู่ใน volume `judes-note-db-data` ไม่หาย
+- `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`
+- `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`
@@ -50,6 +49,12 @@ 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`)
@@ -125,6 +130,28 @@ 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":"","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//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
| อาการ | สาเหตุ/ทางแก้ |
@@ -132,7 +159,8 @@ curl -X POST -H "x-api-key: $EXTERNAL_API_KEY" -H "content-type: application/jso
| 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 start judes-note-db`) และพอร์ต 54322 ไม่ถูกใช้โดย container อื่น |
+| ต่อ DB ไม่ได้ | ตรวจว่า container รันอยู่ (`docker compose start db` — เดิม `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 ใช้ได้ปกติกับทุกไฟล์) |
## หมายเหตุทางเทคนิค
@@ -148,11 +176,14 @@ curl -X POST -H "x-api-key: $EXTERNAL_API_KEY" -H "content-type: application/jso
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
diff --git a/app/api/documents/token/route.ts b/app/api/documents/token/route.ts
new file mode 100644
index 0000000..2173fe2
--- /dev/null
+++ b/app/api/documents/token/route.ts
@@ -0,0 +1,97 @@
+// PLAN-DOCVER.md §auth — POST /api/documents/token ออก access_token ของกลุ่ม docver
+// ทางเข้า 2 ทาง (PLAN-ADDIN-AUTH.md §3 — header x-api-key เป็นตัวตั้ง):
+// 1) e-Court server-to-server: header "x-api-key" เทียบ env DOCVER_API_KEY
+// (fail closed เมื่อ env ไม่ตั้ง/ว่าง) + body claims ตรง ๆ (เดิมทุกอย่าง)
+// 2) add-in ใน Word: ไม่มี x-api-key + body {ticket_data, HmacSha256} — server
+// ตรวจ HMAC+exp ด้วย env ฝั่ง server (ADDIN_TICKET_SECRET → SECRET →
+// "super_secret", lib/addin-ticket.ts) แล้วออก token จาก claims ของ ticket
+// (secret ตัวเซ็น JWT ไม่มีทางไปอยู่ใน bundle ของ add-in)
+// ทั้งสองทางออก 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 {
+ addinTicketSecret,
+ parseTicketTokenBody,
+ ticketToDocverClaims,
+ verifyAddinTicket,
+} from "@/lib/addin-ticket";
+import {
+ issueDocverToken,
+ parseTokenRequestBody,
+ requireDocverApiKey,
+ type DocverTokenClaims,
+} from "@/lib/docver-token";
+
+export const runtime = "nodejs";
+export const dynamic = "force-dynamic";
+
+/** 401 ของทางเข้า ticket — ข้อความเดียวทุกสาเหตุ (HMAC ผิด/รูปผิด/หมดอายุ/ไม่ส่งมา) กัน oracle */
+const TICKET_DENIED = "ticket ไม่ถูกต้องหรือหมดอายุ";
+
+export async function POST(request: Request) {
+ return request.headers.get("x-api-key") !== null
+ ? postWithApiKey(request)
+ : postWithTicket(request);
+}
+
+/** ทางเข้า 1 (เดิม) — e-Court server-to-server */
+async function postWithApiKey(request: Request): Promise {
+ 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);
+ return issueToken(parsed.claims);
+}
+
+/** ทางเข้า 2 — add-in ส่ง ticket ที่ e-Court stamp มากับไฟล์ */
+async function postWithTicket(request: Request): Promise {
+ let raw: unknown;
+ try {
+ raw = await request.json();
+ } catch {
+ return docverError("body ต้องเป็น JSON", 400);
+ }
+ const parsed = parseTicketTokenBody(raw);
+ if (!parsed.ok) {
+ // missing = ไม่มี ticket มาเล่น ๆ (401 เดียวกับตอน verify ไม่ผ่าน)
+ // invalid = รูป body ผิดจริง ๆ ให้ 400 ตาม convention กัน typo เงียบ ๆ
+ return docverError(parsed.error, parsed.kind === "invalid" ? 400 : 401);
+ }
+ const verified = verifyAddinTicket(parsed.ticketData, parsed.hmacHex, addinTicketSecret());
+ if (!verified.ok) return docverError(TICKET_DENIED, 401);
+ return issueToken(ticketToDocverClaims(verified.ticket));
+}
+
+/** ออก JWT ของ claims ที่ผ่านการยืนยันแล้วจากทั้งสองทาง — ส่วนกลาง */
+async function issueToken(claims: DocverTokenClaims): Promise {
+ // ความผิด 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(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" } },
+ );
+}
diff --git a/app/api/documents/versions/[versionId]/download-link/route.ts b/app/api/documents/versions/[versionId]/download-link/route.ts
new file mode 100644
index 0000000..b97ce00
--- /dev/null
+++ b/app/api/documents/versions/[versionId]/download-link/route.ts
@@ -0,0 +1,52 @@
+// 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);
+ }
+}
diff --git a/app/api/documents/versions/route.ts b/app/api/documents/versions/route.ts
new file mode 100644
index 0000000..79dcc2b
--- /dev/null
+++ b/app/api/documents/versions/route.ts
@@ -0,0 +1,170 @@
+// 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);
+ }
+}
diff --git a/app/api/note/external/documents/route.ts b/app/api/note/external/documents/route.ts
index 3d9f4a1..8a4faff 100644
--- a/app/api/note/external/documents/route.ts
+++ b/app/api/note/external/documents/route.ts
@@ -4,6 +4,7 @@ import { db } from "@/db";
import { files } from "@/db/schema";
import { externalApiError, requireExternalApiKey } from "@/lib/external-api-auth";
import { loadDocumentBundles, parseQueryBody } from "@/lib/external-api";
+import { requestOrigin } from "@/utils/request-origin";
// N10 (PLAN-API.md D2) — POST /api/note/external/documents
// (เดิมชื่อ /api/external/query ถึงรอบสาม — เปลี่ยนชื่อตาม resource ที่คืน 2026-09-25)
@@ -19,21 +20,8 @@ import { loadDocumentBundles, parseQueryBody } from "@/lib/external-api";
const JSON_HEADERS = { "content-type": "application/json; charset=utf-8" };
-/** origin เต็มของ request นี้ (ใช้ประกอบ url เต็มใน response — คำขอผู้ใช้
- * 2026-09-25): เชื่อ header ของ reverse proxy ก่อน (x-forwarded-proto /
- * x-forwarded-host — proxy หลายชั้นส่งเป็น comma list ใช้ค่าแรก) แล้วค่อย
- * fallback จาก host/protocol ของ request ตรง ๆ */
-function requestOrigin(req: Request): string {
- const url = new URL(req.url);
- const proto =
- req.headers.get("x-forwarded-proto")?.split(",")[0]?.trim() ??
- url.protocol.replace(":", "");
- const host =
- req.headers.get("x-forwarded-host")?.split(",")[0]?.trim() ??
- req.headers.get("host") ??
- url.host;
- return `${proto}://${host}`;
-}
+// origin เต็มของ request สำหรับ url เต็มใน response — ถอดเป็น helper ร่วม
+// (utils/request-origin.ts) ให้ route manifest ของ wordaddin ใช้เหมือนกัน (2026-10-16)
export async function POST(req: Request) {
const unauthorized = requireExternalApiKey(req);
diff --git a/app/api/template/download-docx/route.ts b/app/api/template/download-docx/route.ts
new file mode 100644
index 0000000..13f8725
--- /dev/null
+++ b/app/api/template/download-docx/route.ts
@@ -0,0 +1,108 @@
+// ตัวอย่างรองรับค่าจาก Frontend ที่เป็น Vanilla JavaScript และ Classic Framework
+// โดย ผ่าน Form หรือ การกดลิงค์(GET) เปลี่ยนหน้าเพื่อดาว์นโหลดไฟล์
+// จะมีข้อมูล info.ticket_data ที่สมบูรณ์แล้ว({fid,tid,uid,uname})แล้วเเรียก /api/template/generate เพื่อสร้างเอกสาร docx
+import { NextRequest, NextResponse } from 'next/server';
+import path from 'path';
+import fs from 'fs/promises';
+
+const DOCEDIT_BASE_URL = process.env.DOCEDIT_BASE_URL??"";
+const EXTERNAL_API_KEY = process.env.EXTERNAL_API_KEY??"";
+const TMPL_PATH = process.env.TMPL_PATH??"";
+if (!DOCEDIT_BASE_URL||!EXTERNAL_API_KEY||!TMPL_PATH) {
+ console.error('Missing variable DOCEDIT_BASE_URL, EXTERNAL_API_KEY or TMPL_PATH')
+}
+
+
+async function processRequest(fid: string,tid:string,uid:string,uname:string):Promise>
+{
+ // console.log("processRequest get:",fid,tid,uid,uname)
+ // console.log(process.cwd())
+ const filePath = path.join(TMPL_PATH,`${fid}.json`);
+ try {
+ if (!fid||!tid||!uid||!uname) {
+ return NextResponse.json({ error: 'Missing fid, tid, uid or uname' }, { status: 400 });
+ }
+
+ // อ่านไฟล์ JSON จำลองการอ่านจากฐานข้อมูล
+ const rawJson = await fs.readFile(filePath, 'utf-8');
+ const jsonData = JSON.parse(rawJson);
+ if (!jsonData || typeof jsonData !== 'object' ) {
+ return NextResponse.json({error:'Invalid data format'}, { status: 400 });
+ }
+
+ //!! ตรวจสอบสิทธิ์ผู้ใช้ uid ว่ามีสิทธิ์เข้าถึงไฟล์ fid หรือไม่เพื่อกันการการยิง API ตรงๆ ไม่ผ่าน Frontend!!
+
+ // ข้อมูลจำเป็นต้องมี prop นี้เสมอถ้าไม่มีให้สร้าง jsonData.info.ticket_data
+ if(!Object.hasOwn(jsonData, 'info'))
+ jsonData['info']={}
+ jsonData.info['ticket_data'] = JSON.stringify({fid,tid,uid,uname})
+ // sign เองตรงนี้ให้อยู่ในรูปแบบ data.info={ticket_data,HmacSha256,Ed25519} หรือว่างไว้ให้ docedit สร้างให้
+
+ //ยิงไปหาระบบ Docedit เพื่อเอา Stream
+ // console.log(`fetch ${DOCEDIT_BASE_URL}/api/template/generate`)
+ const docxResponse = await fetch(`${DOCEDIT_BASE_URL}/api/template/generate`, {
+ method: 'POST',
+ headers: {
+ 'Content-Type': 'application/json',
+ 'x-api-key': EXTERNAL_API_KEY,
+ },
+ body: JSON.stringify(jsonData),
+ });
+
+ // เช็ค Content-Type และ Status ก่อน
+ const contentType = docxResponse.headers.get('content-type') || '';
+
+ if (!docxResponse.ok || contentType.includes('text/html')) {
+ const errorText = await docxResponse.text();
+ console.error('download-docx:Invalid docx Response:', errorText);
+
+ return NextResponse.json(
+ {error:`Error from docedit generate: Expected docx stream but received ${contentType} (Status ${docxResponse.status})`},
+ { status: 502 }
+ );
+ }
+
+ // 2. ดึง ReadableStream โดยตรงจาก Response ของระบบ
+ const stream = docxResponse.body;
+
+ // 3. ส่ง Binary Stream กลับไปยัง Browser พร้อม Header กำหนดประเภทไฟล์
+ const download_file = `${fid}_${uid}_xxx`
+ return new NextResponse(stream as unknown as BodyInit, {
+ status: 200,
+ headers: {
+ 'Content-Type':
+ 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+ 'Content-Disposition': `attachment; filename="${encodeURIComponent(download_file)}.docx"`,
+ 'Cache-Control': 'no-store, max-age=0',
+ },
+ });
+ } catch (error:any) {
+ if ( error.code === 'ENOENT') {
+ return NextResponse.json(
+ { error: `Data not found: ${filePath}`},
+ { status: 404 }
+ );
+ }
+ console.error(error)
+ return NextResponse.json({error:'Internal Server Error'}, { status: 500 });
+ }
+}
+
+export async function GET(request: NextRequest)
+{
+ const searchParams = request.nextUrl.searchParams;
+ const fid = searchParams.get('fid') || '';
+ const tid = searchParams.get('tid') || '';
+ const uid = searchParams.get('uid') || '';
+ const uname = searchParams.get('uname') || '';
+ return await processRequest(fid,tid,uid,uname)
+}
+
+export async function POST(request: NextRequest) {
+ const formData = await request.formData();
+ const fid = String(formData.get('fid'))
+ const tid = String(formData.get('tid'))
+ const uid = String(formData.get('uid'))
+ const uname = String(formData.get('uname'))
+ return await processRequest(fid,tid,uid,uname)
+}
\ No newline at end of file
diff --git a/app/api/template/extract/route.ts b/app/api/template/extract/route.ts
index dc5b49c..12108b7 100644
--- a/app/api/template/extract/route.ts
+++ b/app/api/template/extract/route.ts
@@ -1,7 +1,7 @@
import { NextResponse } from "next/server";
-import { extractContentControls } from "../lib-tmpl";
-
-export const runtime = "nodejs";
+import { extractContentControls, extractBookmark, templateContentControls, setCustomDocProps, getDocProps,templateDynamicContents } from "@/lib/lib-tmpl";
+import { verifyEd25519, verifyHmacSha256 } from "@/lib/lib-utils";
+// export const runtime = "nodejs";
const DOCX_CONTENT_TYPE =
"application/vnd.openxmlformats-officedocument.wordprocessingml.document";
@@ -14,24 +14,14 @@ 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(
- {
- success: false,
- error: 'Missing DOCX file in field "file".',
- },
- { status: 400 },
- );
- }
-
- if (
- file.type !== DOCX_CONTENT_TYPE &&
- !file.name.toLowerCase().endsWith(".docx")
+ if (!(file instanceof File) ||
+ (file.type !== DOCX_CONTENT_TYPE && !file.name.toLowerCase().endsWith(".docx") )
) {
return NextResponse.json(
{
- success: false,
error: 'Field "file" must be a .docx file.',
},
{ status: 400 },
@@ -41,7 +31,6 @@ export async function POST(request: Request) {
if (file.size > MAX_UPLOAD_BYTES) {
return NextResponse.json(
{
- success: false,
error: 'Field "file" exceeds the 100MB size limit.',
},
{ status: 400 },
@@ -52,18 +41,36 @@ export async function POST(request: Request) {
const buffer = Buffer.from(await file.arrayBuffer());
// ใช้ lib-tmpl.ts เดิม
- const data = extractContentControls(buffer);
+ // const data = extractContentControls(buffer);
- return NextResponse.json({
- success: true,
- data,
- });
+ const cc = extractContentControls(buffer);
+ const bookmark = extractBookmark(buffer)
+ const properties = getDocProps(buffer)
+ let verify: Record ={}
+ const ticket_data = properties?.custom?.ticket_data
+ const HmacSha256 = String(properties?.custom?.HmacSha256)
+ const Ed25519 = String(properties?.custom?.Ed25519)
+
+ if(ticket_data && typeof ticket_data === 'string'){
+ 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['HmacSha256'] = verifyHmacSha256(ticket_data,TEST_SECRET,HmacSha256)
+ }
+ if(TEST_PUBLIC_KEY_HEX&& Ed25519){
+ verify["Ed25519"]=verifyEd25519(ticket_data,Ed25519,TEST_PUBLIC_KEY_HEX)
+ }
+ }
+
+ let returnData : Record = {cc,bookmark,properties,verify}
+ return NextResponse.json(returnData);
} catch (error) {
console.error(error);
-
return NextResponse.json(
{
- success: false,
error:
error instanceof Error
? error.message
diff --git a/app/api/template/generate/route.ts b/app/api/template/generate/route.ts
new file mode 100644
index 0000000..1a057ee
--- /dev/null
+++ b/app/api/template/generate/route.ts
@@ -0,0 +1,101 @@
+// สร้าง docx จาก json
+// - json.info.ticket_data จะมี tid ให้โหลดไฟล์ template นี้มาใช้
+// - สร้าง signature/hash จาก json.info.ticket_data
+
+import { NextRequest, NextResponse } from 'next/server';
+import {readFile} from 'fs/promises';
+import path from 'path';
+import {DocumentTemplate,applyTemplate} from "@/lib/lib-tmpl";
+const EXTERNAL_API_KEY = process.env.EXTERNAL_API_KEY || 'secret-api-key-1234';
+const TMPL_PATH = process.env.TMPL_PATH || ''
+const PRIVATE_KEY_HEX = process.env.PRIVATE_KEY_HEX ||''
+const SECRET = process.env.SECRET || ''
+const TICKET_SEC = Number(process.env.TICKET_SEC||'300')
+
+if (EXTERNAL_API_KEY || !TMPL_PATH || !PRIVATE_KEY_HEX || !SECRET)
+ console.log("api/template/generate: require EXTERNAL_API_KEY, TMPL_PATH and PRIVATE_KEY_HEX")
+
+export async function POST(request: NextRequest) {
+ // 1. ตรวจสอบ API Key จาก HTTP Header (x-api-key)
+ const apiKey = request.headers.get('x-api-key');
+
+ if (!apiKey || apiKey !== EXTERNAL_API_KEY) {
+ return NextResponse.json(
+ { error: 'Unauthorized: Invalid API Key' },
+ { status: 401 }
+ );
+ }
+
+ try {
+ // รับข้อมูล JSON Payload
+ const templateData:DocumentTemplate = (await request.json());
+ console.log(templateData)
+ // ต้องมี templateData.info.ticket_data เป็น json string เสมอ
+ if (!templateData || !templateData.info ||
+ !templateData.info.ticket_data ||
+ typeof templateData.info.ticket_data !== "string"
+ ) {
+ return NextResponse.json(
+ {
+ error: "template/generate json.info.ticket_data not avaliable",
+ },
+ { status: 400 },
+ );
+ }
+ const ticketObj = JSON.parse(templateData.info.ticket_data)
+ const tid = String(ticketObj.tid)
+ const fid = String(ticketObj.fid)
+ const uid = String(ticketObj.uid)
+ if(!tid||!fid||!uid)
+ {
+ return NextResponse.json(
+ {
+ error: "template/generate require json.info.ticket_data.(fid|tid|uid)",
+ },
+ { status: 400 },
+ );
+ }
+
+
+ //เปิดไฟล์ template
+ const tmplPath = path.join(TMPL_PATH, `${tid}.docx`);
+ let templateBuffer: Buffer = await readFile(tmplPath)
+
+ const output = await applyTemplate(templateBuffer, templateData, SECRET, PRIVATE_KEY_HEX, TICKET_SEC);
+
+ // สร้าง ReadableStream ของไฟล์ .docx
+ // ในโค้ดจริง ส่วนนี้จะดึง Binary Buffer จาก Library เช่น docx, docxtemplater หรืออ่านจาก File System
+ // const encoder = new TextEncoder();
+
+ const docxStream = new ReadableStream({
+ start(controller) {
+ controller.enqueue(output);
+ controller.close();
+ },
+ });
+
+ // 4. ส่ง Return เป็น Response พร้อม Stream และ Headers กำหนด MIME type ของ MS Word
+ const dlFileName = encodeURIComponent(`${tid}_${fid}_${uid}XX`)
+ return new NextResponse(docxStream, {
+ status: 200,
+ headers: {
+ 'Content-Type':
+ 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+ 'Content-Disposition': `attachment; filename="${dlFileName}.docx"`,
+ 'Cache-Control': 'no-store, max-age=0',
+ },
+ });
+ } catch (error:any) {
+ if ( error.code === 'ENOENT') {
+ return NextResponse.json(
+ { error: 'NotFound: Invalid template ID or incorrect storage path'},
+ { status: 404 }
+ );
+ }
+ console.error('Error generating docx:', error);
+ return NextResponse.json(
+ { error: 'Failed to generate document payload'},
+ { status: 500 }
+ );
+ }
+}
\ No newline at end of file
diff --git a/app/api/template/lib-tmpl.ts b/app/api/template/lib-tmpl.ts
deleted file mode 100644
index 2c15f52..0000000
--- a/app/api/template/lib-tmpl.ts
+++ /dev/null
@@ -1,518 +0,0 @@
-import PizzaZip from "pizzip";
-import {
- DOMParser,
- XMLSerializer,
- type Document as XmlDocument,
- type Element as XmlElement,
- type Node as XmlNode,
- type Attr as XmlAttr,
-} from "@xmldom/xmldom";
-import xpath from "xpath";
-
-export interface ExtractedData {
- [tagName: string]: string;
-}
-
-const W_NS =
- "http://schemas.openxmlformats.org/wordprocessingml/2006/main";
-
-const asXpathNode = (node: XmlNode): globalThis.Node =>
- node as unknown as globalThis.Node;
-
-function createSelector() {
- return xpath.useNamespaces({ w: W_NS });
-}
-
-/**
- * อ่าน Content Control (w:sdt) จาก DOCX Buffer
- * ปัจจุบันอ่านจาก word/document.xml ตาม logic ของโค้ดต้นฉบับ
- */
-export function extractContentControls(
- docxBuffer: Buffer,
-): ExtractedData {
- const zip = new PizzaZip(docxBuffer);
- const docXmlFile = zip.file("word/document.xml");
-
- if (!docXmlFile) {
- throw new Error("Invalid docx file: word/document.xml not found.");
- }
-
- const parser = new DOMParser();
- const doc = parser.parseFromString(docXmlFile.asText(), "text/xml");
- const select = createSelector();
- const result: ExtractedData = {};
-
- const sdtNodes = select(
- "//w:sdt",
- asXpathNode(doc),
- ) as unknown as XmlElement[];
-
- sdtNodes.forEach((sdt) => {
- const tagAttr = select(
- "./w:sdtPr/w:tag/@w:val",
- asXpathNode(sdt),
- true,
- ) as unknown as XmlAttr | undefined;
-
- const tagName = tagAttr?.value;
-
- if (!tagName) return;
-
- const sdtContent = select(
- "./w:sdtContent",
- asXpathNode(sdt),
- true,
- ) as unknown as XmlElement | undefined;
-
- if (!sdtContent) {
- result[tagName] = "";
- return;
- }
-
- const nodes = select(
- ".//w:p | .//w:t | .//w:tab | .//w:br | .//w:noBreakHyphen | .//w:softHyphen | .//w:sym",
- asXpathNode(sdtContent),
- ) as unknown as XmlElement[];
-
- let extractedText = "";
-
- nodes.forEach((node) => {
- switch (node.nodeName) {
- case "w:p":
- if (
- extractedText.length > 0 &&
- !extractedText.endsWith("\n")
- ) {
- extractedText += "\n";
- }
- break;
-
- case "w:t":
- extractedText += node.textContent || "";
- break;
-
- case "w:tab":
- extractedText += "\t";
- break;
-
- case "w:br":
- extractedText += "\n";
- break;
-
- case "w:noBreakHyphen":
- extractedText += "\u2011";
- break;
-
- case "w:softHyphen":
- extractedText += "\u00ad";
- break;
-
- case "w:sym": {
- const charAttr = node.getAttribute("w:char");
- if (charAttr) {
- const charCode = Number.parseInt(charAttr, 16);
- extractedText += String.fromCharCode(charCode);
- }
- break;
- }
- }
- });
-
- result[tagName] = extractedText;
- });
-
- return result;
-}
-
-type SdtControlType = "plain" | "rich" | "other";
-type SdtStructure = "block" | "inline";
-
-function detectSdtControlType(
- sdt: XmlElement,
- select: xpath.XPathSelect,
-): { type: SdtControlType; multiLine: boolean } {
- const sdtPr = select(
- "./w:sdtPr",
- asXpathNode(sdt),
- true,
- ) as unknown as XmlElement | undefined;
-
- if (!sdtPr) {
- return { type: "other", multiLine: false };
- }
-
- const textEl = select(
- "./w:text",
- asXpathNode(sdtPr),
- true,
- ) as unknown as XmlElement | undefined;
-
- if (textEl) {
- const multiLineAttr = select(
- "./@w:multiLine",
- asXpathNode(textEl),
- true,
- ) as unknown as XmlAttr | undefined;
-
- return {
- type: "plain",
- multiLine:
- multiLineAttr?.value === "1" ||
- multiLineAttr?.value === "true",
- };
- }
-
- const richTextEl = select(
- "./w:richText",
- asXpathNode(sdtPr),
- true,
- ) as unknown as XmlElement | undefined;
-
- if (richTextEl) {
- return { type: "rich", multiLine: true };
- }
-
- const otherTypeTags = [
- "w:date",
- "w:dropDownList",
- "w:comboBox",
- "w:checkbox",
- "w:citation",
- "w:group",
- "w:docPartObj",
- "w:docPartList",
- ];
-
- for (const tag of otherTypeTags) {
- const found = select(
- `./${tag}`,
- asXpathNode(sdtPr),
- true,
- ) as unknown as XmlElement | undefined;
-
- if (found) {
- return { type: "other", multiLine: false };
- }
- }
-
- return { type: "rich", multiLine: true };
-}
-
-function detectSdtStructure(
- sdtContent: XmlElement,
- select: xpath.XPathSelect,
-): SdtStructure {
- const directP = select(
- "./w:p",
- asXpathNode(sdtContent),
- ) as unknown as XmlElement[];
-
- return directP.length > 0 ? "block" : "inline";
-}
-
-function buildRunChildren(
- doc: XmlDocument,
- text: string,
-): XmlElement[] {
- const nodes: XmlElement[] = [];
- const tokens = text.split(/(\t|\n)/);
-
- tokens.forEach((token) => {
- if (token === "") return;
-
- if (token === "\t") {
- nodes.push(doc.createElementNS(W_NS, "w:tab"));
- } else if (token === "\n") {
- nodes.push(doc.createElementNS(W_NS, "w:br"));
- } else {
- const t = doc.createElementNS(W_NS, "w:t");
- t.setAttribute("xml:space", "preserve");
- t.textContent = token;
- nodes.push(t);
- }
- });
-
- if (nodes.length === 0) {
- const t = doc.createElementNS(W_NS, "w:t");
- t.setAttribute("xml:space", "preserve");
- t.textContent = "";
- nodes.push(t);
- }
-
- return nodes;
-}
-
-function buildRun(
- doc: XmlDocument,
- text: string,
- rPr?: XmlElement,
-): XmlElement {
- const run = doc.createElementNS(W_NS, "w:r");
-
- if (rPr) {
- run.appendChild(rPr.cloneNode(true));
- }
-
- buildRunChildren(doc, text).forEach((node) =>
- run.appendChild(node),
- );
-
- return run;
-}
-
-function insertInlineContent(
- doc: XmlDocument,
- sdtContent: XmlElement,
- select: xpath.XPathSelect,
- text: string,
- allowLineBreak: boolean,
-): void {
- const safeText = allowLineBreak
- ? text
- : text.replace(/\n/g, " ");
-
- const existingRuns = select(
- "./w:r",
- asXpathNode(sdtContent),
- ) as unknown as XmlElement[];
-
- const firstRPr =
- existingRuns.length > 0
- ? (select(
- "./w:rPr",
- asXpathNode(existingRuns[0]),
- true,
- ) as unknown as XmlElement | undefined)
- : undefined;
-
- existingRuns.forEach((r) => {
- if (r.parentNode) r.parentNode.removeChild(r);
- });
-
- sdtContent.appendChild(
- buildRun(doc, safeText, firstRPr),
- );
-}
-
-function insertBlockContent(
- doc: XmlDocument,
- sdtContent: XmlElement,
- select: xpath.XPathSelect,
- text: string,
- allowMultiParagraph: boolean,
-): void {
- const allParagraphs = select(
- "./w:p",
- asXpathNode(sdtContent),
- ) as unknown as XmlElement[];
-
- if (allParagraphs.length === 0) {
- // ป้องกัน template ที่มีโครงสร้างผิดปกติ
- const p = doc.createElementNS(W_NS, "w:p");
- sdtContent.appendChild(p);
- allParagraphs.push(p);
- }
-
- const firstP = allParagraphs[0];
-
- const firstPPr = select(
- "./w:pPr",
- asXpathNode(firstP),
- true,
- ) as unknown as XmlElement | undefined;
-
- const firstRun = select(
- "./w:r",
- asXpathNode(firstP),
- true,
- ) as unknown as XmlElement | undefined;
-
- const firstRPr = firstRun
- ? (select(
- "./w:rPr",
- asXpathNode(firstRun),
- true,
- ) as unknown as XmlElement | undefined)
- : undefined;
-
- allParagraphs.forEach((p) => {
- if (p !== firstP && p.parentNode) {
- p.parentNode.removeChild(p);
- }
- });
-
- const existingRuns = select(
- "./w:r",
- asXpathNode(firstP),
- ) as unknown as XmlElement[];
-
- existingRuns.forEach((r) => {
- if (r.parentNode) r.parentNode.removeChild(r);
- });
-
- if (!allowMultiParagraph) {
- firstP.appendChild(buildRun(doc, text, firstRPr));
- return;
- }
-
- text.split("\n").forEach((line, index) => {
- let targetP: XmlElement;
-
- if (index === 0) {
- targetP = firstP;
- } else {
- targetP = doc.createElementNS(W_NS, "w:p");
-
- if (firstPPr) {
- targetP.appendChild(firstPPr.cloneNode(true));
- }
-
- sdtContent.appendChild(targetP);
- }
-
- const run = doc.createElementNS(W_NS, "w:r");
-
- if (firstRPr) {
- run.appendChild(firstRPr.cloneNode(true));
- }
-
- buildRunChildren(doc, line).forEach((node) =>
- run.appendChild(node),
- );
-
- targetP.appendChild(run);
- });
-}
-
-function insertFallbackContent(
- sdtContent: XmlElement,
- select: xpath.XPathSelect,
- text: string,
-): void {
- const textNodes = select(
- ".//w:t",
- asXpathNode(sdtContent),
- ) as unknown as XmlElement[];
-
- if (textNodes.length === 0) return;
-
- textNodes[0].textContent = text;
-
- for (let i = 1; i < textNodes.length; i++) {
- textNodes[i].textContent = "";
- }
-}
-
-export type TemplateData = Record;
-
-function normalizeValue(value: unknown): string {
- if (value === null || value === undefined) {
- return "";
- }
-
- if (typeof value === "string") {
- return value;
- }
-
- if (
- typeof value === "number" ||
- typeof value === "boolean" ||
- typeof value === "bigint"
- ) {
- return String(value);
- }
-
- // รองรับ JSON ที่ส่ง array/object มา แต่ Content Control ต้องการ text
- return JSON.stringify(value);
-}
-
-/**
- * นำ JSON data ไปแทนค่า Content Control ใน DOCX template
- * คืนค่าเป็น Buffer ของ DOCX ที่สร้างเสร็จแล้ว
- */
-export function templateContentControls(
- templateBuffer: Buffer,
- data: TemplateData,
-): Buffer {
- const zip = new PizzaZip(templateBuffer);
- const docXmlFile = zip.file("word/document.xml");
-
- if (!docXmlFile) {
- throw new Error("Invalid docx file: word/document.xml not found.");
- }
-
- const parser = new DOMParser();
- const doc = parser.parseFromString(docXmlFile.asText(), "text/xml");
- const select = createSelector();
-
- const sdtNodes = select(
- "//w:sdt",
- asXpathNode(doc),
- ) as unknown as XmlElement[];
-
- sdtNodes.forEach((sdt) => {
- const tagAttr = select(
- "./w:sdtPr/w:tag/@w:val",
- asXpathNode(sdt),
- true,
- ) as unknown as XmlAttr | undefined;
-
- const tagName = tagAttr?.value;
-
- if (!tagName || !Object.prototype.hasOwnProperty.call(data, tagName)) {
- return;
- }
-
- const newValue = normalizeValue(data[tagName]);
-
- const sdtContent = select(
- "./w:sdtContent",
- asXpathNode(sdt),
- true,
- ) as unknown as XmlElement | undefined;
-
- if (!sdtContent) return;
-
- const { type: controlType, multiLine } =
- detectSdtControlType(sdt, select);
-
- const structure = detectSdtStructure(sdtContent, select);
-
- if (controlType === "other") {
- insertFallbackContent(sdtContent, select, newValue);
- return;
- }
-
- if (structure === "inline") {
- const allowLineBreak =
- controlType === "plain" ? multiLine : true;
-
- insertInlineContent(
- doc,
- sdtContent,
- select,
- newValue,
- allowLineBreak,
- );
- } else {
- insertBlockContent(
- doc,
- sdtContent,
- select,
- newValue,
- controlType === "rich",
- );
- }
- });
-
- const serializer = new XMLSerializer();
- zip.file(
- "word/document.xml",
- serializer.serializeToString(doc),
- );
-
- return zip.generate({
- type: "nodebuffer",
- compression: "DEFLATE",
- });
-}
diff --git a/app/api/template/render/route.ts b/app/api/template/render/route.ts
index df6501c..c738afe 100644
--- a/app/api/template/render/route.ts
+++ b/app/api/template/render/route.ts
@@ -1,94 +1,71 @@
import { NextResponse } from "next/server";
-import {
- templateContentControls,
- type TemplateData,
-} from "../lib-tmpl";
-
+import { DocumentTemplate,applyTemplate} from "@/lib/lib-tmpl";
export const runtime = "nodejs";
+
const DOCX_CONTENT_TYPE =
"application/vnd.openxmlformats-officedocument.wordprocessingml.document";
-
// cap เดียวกับ N4 (app/actions/files.ts) — route นี้เปิดกว้างให้ภายนอกยิงได้
// ต้องเช็คขนาดก่อนอ่านเข้าหน่วยความจำ กัน DoS (bodySizeLimit ครอบเฉพาะ Server Actions)
const MAX_UPLOAD_BYTES = 100 * 1024 * 1024; // 100MB
+const TICKET_SEC = Number(process.env.TICKET_SEC||'300')
export async function POST(request: Request) {
try {
const formData = await request.formData();
-
const template = formData.get("template");
const dataFile = formData.get("data");
const dataJson = formData.get("dataJson");
+ const TEST_SECRET = String(formData.get("secret")||"")
+ const TEST_PRIVATE_KEY_HEX = String(formData.get("private_key")||"")
- // -----------------------------
// ตรวจสอบ Template
- // -----------------------------
-
if (!(template instanceof File)) {
return NextResponse.json(
{
- success: false,
error: 'Missing DOCX file in field "template".',
},
{ status: 400 },
);
}
- if (
- template.type !== DOCX_CONTENT_TYPE &&
- !template.name.toLowerCase().endsWith(".docx")
+ if (template.type !== DOCX_CONTENT_TYPE &&
+ !template.name.toLowerCase().endsWith(".docx") &&
+ template.size > MAX_UPLOAD_BYTES
) {
return NextResponse.json(
{
- success: false,
- error: 'Field "template" must be a .docx file.',
+ error: 'Field "template" must be a .docx file and not exceeds the 100MB size limit.',
},
{ status: 400 },
);
}
- if (template.size > MAX_UPLOAD_BYTES) {
- return NextResponse.json(
- {
- success: false,
- error: 'Field "template" exceeds the 100MB size limit.',
- },
- { status: 400 },
- );
- }
- // -----------------------------
// อ่าน JSON
- // -----------------------------
-
- let data: TemplateData;
-
+ let templateData: DocumentTemplate;
// JSON ผิด syntax เป็นความผิดของฝั่งผู้เรียก — คืน 400 ไม่ใช่ 500
// (catch กลางท้ายฟังก์ชันสงวนไว้ให้ error ของระบบเท่านั้น)
try {
if (typeof dataJson === "string" && dataJson.length > 0) {
// กรณีส่ง JSON ผ่าน form field
- data = JSON.parse(dataJson) as TemplateData;
+ templateData = JSON.parse(dataJson) as DocumentTemplate;
} else if (dataFile instanceof File) {
if (dataFile.size > MAX_UPLOAD_BYTES) {
return NextResponse.json(
{
- success: false,
error: 'Field "data" exceeds the 100MB size limit.',
},
{ status: 400 },
);
}
-
// กรณี upload data.json
const text = await dataFile.text();
- data = JSON.parse(text) as TemplateData;
+ templateData = JSON.parse(text) as DocumentTemplate;
} else {
return NextResponse.json(
{
- success: false,
error:
'Missing JSON data. Send either "data" file or "dataJson" field.',
},
@@ -98,24 +75,20 @@ export async function POST(request: Request) {
} catch (error) {
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 },
);
}
-
// JSON ต้องเป็น object
if (
- data === null ||
- typeof data !== "object" ||
- Array.isArray(data)
+ templateData === null ||
+ typeof templateData !== "object" ||
+ Array.isArray(templateData)
) {
return NextResponse.json(
{
- success: false,
error: "JSON data must be an object.",
},
{ status: 400 },
@@ -126,31 +99,21 @@ export async function POST(request: Request) {
// Template File → Buffer
// -----------------------------
- const templateBuffer = Buffer.from(
+ let templateBuffer: Buffer = Buffer.from(
await template.arrayBuffer(),
);
-
- // -----------------------------
- // ใช้ lib-tmpl.ts เดิม
- // -----------------------------
-
- const output = templateContentControls(
- templateBuffer,
- data,
- );
+ const output = await applyTemplate(templateBuffer,templateData,TEST_SECRET,TEST_PRIVATE_KEY_HEX,TICKET_SEC);
// -----------------------------
// ส่ง DOCX กลับ
// -----------------------------
-
+ if(templateData?.info?.ticket_data)
return new NextResponse(output as BodyInit, {
status: 200,
headers: {
"Content-Type": DOCX_CONTENT_TYPE,
-
"Content-Disposition":
'attachment; filename="generated-document.docx"',
-
"Content-Length": String(output.length),
},
});
@@ -159,7 +122,7 @@ export async function POST(request: Request) {
return NextResponse.json(
{
- success: false,
+
error:
error instanceof Error
? error.message
@@ -168,4 +131,5 @@ export async function POST(request: Request) {
{ status: 500 },
);
}
-}
\ No newline at end of file
+}
+
diff --git a/app/api/template/test/T2.json b/app/api/template/test/T2.json
deleted file mode 100644
index 799c36f..0000000
--- a/app/api/template/test/T2.json
+++ /dev/null
@@ -1,29 +0,0 @@
-{
- "notname": "คำสั่งเรียก ให้ทำคำให้การ",
- "nottype": "(ต. ๑)",
- "blackno": "คดีหมายเลขดำที่",
- "blackyear": "๑๐/๒๕๖๙",
- "redno": "คดีหมายเลขแดงที่",
- "redyear": "",
- "court": "ศาลปกครองสุพรรณบุรี",
- "curdate": "วันที่ ๗ เดือน สิงหาคม พุทธศักราช ๒๕๖๙",
- "accuser": "นายธัญวิสิษฐ์ ศรแก้ว",
- "acc1": "ผู้ฟ้องคดี",
- "accused": "เจ้าคุณมด ที่ ๑ กับพวกรวม ๓ คน",
- "acc2": "ผู้ถูกฟ้องคดี",
- "nottitle": "คำสั่งถึง",
- "commto": "เจ้าคุณมด",
- "groupname": "ผู้ถูกฟ้องคดีที่ ๑",
- "detail1": "ด้วยผู้ฟ้องคดีได้ยื่นฟ้องผู้ถูกฟ้องคดีต่อศาล มีข้อความตามที่ปรากฏ ในระบบงานคดีปกครองอิเล็กทรอนิกส์\nฉะนั้น ให้ ท่านทำคำให้การแก้คำฟ้อง พร้อมด้วยพยานหลักฐาน ๑ ชุด ต่อศาลภายใน ๓๐ วัน นับแต่วันที่ได้รับคำสั่งนี้",
- "pname": "นางนพเก้า เถื่อนชัย",
- "courtname": "ศาลปกครองสุพรรณบุรี",
- "courtno": "๓๓๓ หมู่ ๖ ตำบลสนามชัย อำเภอเมืองสุพรรณบุรี",
- "courttam": "จังหวัดสุพรรณบุรี ๗๒๐๐๐",
- "courttel": "กลุ่มออกหมาย โทรศัพท์ ๐๓๕ ๔๓๒ ๓๓๓ ต่อ ๑๐๐๑,๒๒๐๓",
- "courttel2": "สอบถามติดตามคดี ขอคำปรึกษาแนะนำ โทรสายด่วน “๑๓๕๕”",
- "sendto": "เจ้าคุณมด",
- "addrno": "เลขที่ - หมู่ที่ - ตรอก/ซอย - ถนน - ตำบล/แขวง - อำเภอ/เขต - จังหวัด - โทรศัพท์ -",
- "remarkhead": "",
- "remark": "",
- "warning": "หากผู้ถูกฟ้องคดีไม่ปฏิบัติตามคำสั่งศาลภายในระยะเวลาที่กำหนด ศาลจะถือว่าผู้ถูกฟ้องคดียอมรับข้อเท็จจริงตามข้อหาของผู้ฟ้องคดี"
-}
\ No newline at end of file
diff --git a/app/api/template/test/make-protected.mjs b/app/api/template/test/make-protected.mjs
deleted file mode 100644
index c35f2b2..0000000
--- a/app/api/template/test/make-protected.mjs
+++ /dev/null
@@ -1,298 +0,0 @@
-// ทดลอง: เปิด Restrict Edit (readOnly + enforcement) และฝัง custom properties
-// (token / primary-key / owner) ลงไฟล์ docx — ตามแนวทาง Token-Based ใน note.md
-//
-// ใช้: node app/api/template/test/make-protected.mjs [in.docx] [out.docx]
-// ไม่ส่ง argument = อ่านและเขียนทับ output-T3.docx (ผล render ล่าสุด)
-//
-// สิ่งที่แก้ในไฟล์ docx:
-// 1. word/settings.xml — w:documentProtection edit="readOnly" enforcement="1"
-// (เอกสารทั้งฉบับอ่านอย่างเดียว — ทดสอบแล้ว: readOnly ล็อค CC ด้วย
-// จึงต้องคู่กับข้อ 2 ถึงจะแก้ใน CC ได้)
-// 2. word/document.xml ฯลฯ — ครอบ w:sdt ทุกตัวที่มี w:tag ด้วย
-// w:permStart(w:edGrp="everyone") / w:permEnd — กลไก "Exceptions: Everyone"
-// ของแผง Restrict Editing ใน Word (บริเวณใน perm แก้ได้ นอกนั้นล็อค)
-// พร้อมเติม w:lock="sdtLocked" ให้ CC ที่ยังไม่มี กันลบช่องตอนอยู่ในโหมดนี้
-// 3. docProps/custom.xml — สร้างใหม่ เก็บค่า custom properties แบบ vt:lpwstr
-// 4. [Content_Types].xml — เพิ่ม Override สำหรับ custom.xml
-// 5. _rels/.rels — เพิ่ม Relationship ชี้ docProps/custom.xml
-import PizzaZip from "pizzip";
-import { DOMParser, XMLSerializer } from "@xmldom/xmldom";
-import xpath from "xpath";
-import { readFileSync, writeFileSync } from "node:fs";
-import { fileURLToPath } from "node:url";
-import { dirname, join } from "node:path";
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const inPath = process.argv[2] ?? join(__dirname, "output-T3.docx");
-const outPath = process.argv[3] ?? inPath;
-
-// ตัวอย่างข้อมูลที่จะฝัง (ใน production จะมาจาก backend ตอน render เอกสาร)
-const CUSTOM_PROPS = {
- token: "eyJhbGciOiJIUzI1NiJ9.eyJ1aWQiOiJ1MTAwMSIsImZpZCI6IkRPTi0yMDI2LTAwMDEyMyIsImV4cCI6MTc5NjI0NzIwMH0.demo",
- "primary-key": "DOC-2026-000123",
- owner: "u1001",
-};
-
-const W_NS = "http://schemas.openxmlformats.org/wordprocessingml/2006/main";
-const CUSTOM_NS =
- "http://schemas.openxmlformats.org/officeDocument/2006/custom-properties";
-const VT_NS =
- "http://schemas.openxmlformats.org/officeDocument/2006/docPropsVTypes";
-const REL_CUSTOM =
- "http://schemas.openxmlformats.org/officeDocument/2006/relationships/custom-properties";
-const CT_CUSTOM =
- "application/vnd.openxmlformats-officedocument.custom-properties+xml";
-const FMTID = "{D5CDD505-2E9C-101B-9397-08002B2CF9AE}";
-
-const parser = new DOMParser();
-const serializer = new XMLSerializer();
-
-const parseXml = (text) => parser.parseFromString(text, "text/xml");
-
-// xmldom serializer อาจคง xml declaration ไว้แล้ว — เติมเฉพาะเมื่อยังไม่มี
-// (ถ้า prepend ซ้ำจะได้ declaration สองอัน ไฟล์ XML invalid)
-const serialize = (doc) => {
- const text = serializer.serializeToString(doc);
- return text.startsWith("\r\n' + text;
-};
-
-// ครอบ w:sdt ที่มี w:tag ทุกตัวด้วย w:permStart/w:permEnd (edGrp="everyone")
-// และเติม w:lock="sdtLocked" ให้ CC ที่ยังไม่มี — คืนจำนวน CC ที่ครอบ
-function unlockContentControls(zip) {
- const select = xpath.useNamespaces({ w: W_NS });
- const asNode = (n) => n;
- const parts = Object.keys(zip.files).filter((n) =>
- /^word\/(document|header\d*|footer\d*)\.xml$/.test(n),
- );
-
- // id ของ perm ต้องไม่ซ้ำในเอกสาร — เริ่มสูงกว่าค่าสูงสุดที่มีอยู่ (จากทุก part)
- let nextId = 999;
- for (const part of parts) {
- const ids = select(
- "//w:permStart/@w:id | //w:permEnd/@w:id",
- asNode(parseXml(zip.file(part).asText())),
- );
- for (const id of ids) {
- const n = Number.parseInt(id.value, 10);
- if (Number.isFinite(n) && n >= nextId) nextId = n;
- }
- }
-
- let wrapped = 0;
- let locked = 0;
- for (const part of parts) {
- const doc = parseXml(zip.file(part).asText());
-
- // เฉพาะ sdt ระดับบนสุด (ไม่อยู่ใน sdt อื่น) มี w:tag = ช่องข้อมูลของ template
- // และยังไม่ถูกครอบด้วย permStart อยู่แล้ว (กัน double-wrap ตอนรันซ้ำ)
- const sdts = select(
- "//w:sdt[./w:sdtPr/w:tag][not(ancestor::w:sdt)][not(preceding-sibling::*[1][self::w:permStart])]",
- asNode(doc),
- );
- if (sdts.length === 0) continue;
-
- for (const sdt of sdts) {
- // เติม lock ให้ CC ที่ยังไม่มี — กันลบช่องตอนเปิดช่องให้แก้ผ่าน permission
- const sdtPr = select("./w:sdtPr", sdt)[0];
- const hasLock = select("./w:lock", sdtPr).length > 0;
- if (!hasLock) {
- const lock = doc.createElementNS(W_NS, "w:lock");
- lock.setAttribute("w:val", "sdtLocked");
- // w:lock ต้องอยู่หลัง w:id ตามลำดับ schema ของ sdtPr
- const idEl = select("./w:id", sdtPr)[0];
- if (idEl && idEl.nextSibling) {
- sdtPr.insertBefore(lock, idEl.nextSibling);
- } else {
- sdtPr.appendChild(lock);
- }
- locked++;
- }
-
- const start = doc.createElementNS(W_NS, "w:permStart");
- start.setAttribute("w:id", String(nextId));
- start.setAttribute("w:edGrp", "everyone");
- const end = doc.createElementNS(W_NS, "w:permEnd");
- end.setAttribute("w:id", String(nextId));
- nextId++;
-
- sdt.parentNode.insertBefore(start, sdt);
- sdt.parentNode.insertBefore(end, sdt.nextSibling);
- wrapped++;
- }
-
- zip.file(part, serialize(doc));
- }
- return { wrapped, locked };
-}
-
-function enableReadOnlyProtection(zip) {
- const file = zip.file("word/settings.xml");
- if (!file) throw new Error("word/settings.xml not found");
-
- const doc = parseXml(file.asText());
- const prots = doc.getElementsByTagNameNS(W_NS, "documentProtection");
- const prot = prots.length > 0 ? prots[0] : null;
-
- if (prot) {
- prot.setAttribute("w:edit", "readOnly");
- prot.setAttribute("w:enforcement", "1");
- } else {
- // T3 มี element นี้อยู่แล้ว แต่รองรับไฟล์ที่ไม่มี: แทรกเป็น child แรกของ w:settings
- const el = doc.createElementNS(W_NS, "w:documentProtection");
- el.setAttribute("w:edit", "readOnly");
- el.setAttribute("w:enforcement", "1");
- doc.documentElement.insertBefore(el, doc.documentElement.firstChild);
- }
-
- zip.file("word/settings.xml", serialize(doc));
-}
-
-function setCustomProperties(zip, props) {
- // --- 1. docProps/custom.xml : สร้างใหม่ หรือ merge กับของเดิม ---
- const existing = zip.file("docProps/custom.xml");
- let doc;
- if (existing) {
- doc = parseXml(existing.asText());
- // ลบ property ชื่อซ้ำออกก่อน (เขียนทับค่าใหม่)
- const all = Array.from(doc.getElementsByTagNameNS(CUSTOM_NS, "property"));
- for (const p of all) {
- if (Object.prototype.hasOwnProperty.call(props, p.getAttribute("name"))) {
- p.parentNode.removeChild(p);
- }
- }
- } else {
- doc = parseXml(
- `` +
- `]*\/>/)?.[0];
- const enforced =
- prot?.includes('w:edit="readOnly"') && prot?.includes('w:enforcement="1"');
-
- const customXml = zip.file("docProps/custom.xml")?.asText();
- const propsBack = {};
- if (customXml) {
- const doc = parseXml(customXml);
- for (const p of Array.from(
- doc.getElementsByTagNameNS(CUSTOM_NS, "property"),
- )) {
- propsBack[p.getAttribute("name")] = p.textContent;
- }
- }
-
- const rels = zip.file("_rels/.rels")?.asText() ?? "";
- const ct = zip.file("[Content_Types].xml")?.asText() ?? "";
-
- const docXml = zip.file("word/document.xml")?.asText() ?? "";
- const sdtPrs = docXml.match(/[\s\S]*?<\/w:sdtPr>/g) ?? [];
- const plain = sdtPrs.filter((p) => / / `${k}="${v.length > 40 ? v.slice(0, 40) + "…" : v}"`)
- .join(", ") || "(ว่าง)",
- );
- console.log(
- `relationship : ${rels.includes(REL_CUSTOM) ? "✓" : "✗ ไม่พบ"} | content-type override: ${ct.includes(CT_CUSTOM) ? "✓" : "✗ ไม่พบ"}`,
- );
- console.log(`content controls : ${sdtPrs.length} ตัว (plain=${plain}, rich=${rich}, มี tag=${tagged})`);
- console.log(
- `permission ranges : permStart=${permStarts} / permEnd=${permEnds} (ต้องเท่ากับมี tag=${tagged}) ` +
- (permStarts === tagged && permEnds === tagged ? "✓" : "✗"),
- );
- console.log(
- `CC ไม่มี lock : ${missingLock} ตัว (ต้องเป็น 0 — กันลบช่อง) ${missingLock === 0 ? "✓" : "✗"}`,
- );
-
- return (
- enforced &&
- !!customXml &&
- permStarts === tagged &&
- permEnds === tagged &&
- missingLock === 0
- );
-}
-
-const zip = new PizzaZip(readFileSync(inPath));
-enableReadOnlyProtection(zip);
-const { wrapped, locked } = unlockContentControls(zip);
-setCustomProperties(zip, CUSTOM_PROPS);
-
-if (locked > 0) {
- console.log(`เติม w:lock="sdtLocked" ให้ CC อีก ${locked} ตัวที่ยังไม่มี`);
-}
-console.log(`ครอบ CC ด้วย permission range: ${wrapped} ตัว`);
-
-const out = zip.generate({ type: "nodebuffer", compression: "DEFLATE" });
-writeFileSync(outPath, out);
-console.log(`เขียนไฟล์แล้ว: ${outPath} (${out.length.toLocaleString()} bytes)`);
-
-const ok = verify(outPath);
-process.exit(ok ? 0 : 1);
diff --git a/app/api/template/test/note.md b/app/api/template/test/note.md
deleted file mode 100644
index 919190b..0000000
--- a/app/api/template/test/note.md
+++ /dev/null
@@ -1,127 +0,0 @@
-# Docx Template
-lib-tmpl.ts เป็นแชร์ไลบารีสำหรับการทำ Template ใช้ Content Control ใน MS Word
-## วิธีการใช้ API
-```sh
-## Swagger UI — เปิดในเบราว์เซอร์ (ลองยิงจริงผ่านปุ่ม Try it out ได้เลย ไม่ต้อง login)
-http://localhost:3000/docedit/api/swagger
-
-## template/test ไว้ทดสอบเท่านั้น
-curl.exe http://localhost:3000/docedit/api/template/test
-
-## extract ค่าออกมาจาก content control
-curl.exe -X POST http://localhost:3000/docedit/api/template/extract -F "file=@./output-T3.docx"
-
-## render เอกสาร (docx) = template(docx)+data(json)
-### อาจจะเพิ่มการเอา template จาก url และ file(local) ยังไม่รู้ว่าทางนั้นจะส่งไฟล์แบบไหนมาให้ เอาแค่นี้ไว้ทดสอบก่อน
-curl.exe -X POST http://localhost:3000/docedit/api/template/render -F "template=@./T3.docx" -F "data=@./T2.json" -o output.docx
-### data เอาจาก string
-curl -X POST http://localhost:3000/docedit/api/template/render \
- -F "template=@template.docx" \
- -F 'dataJson={"member_name":"นายสมชาย","member_id":"123456"}' \
- -o generated-document.docx
-
-```
-data(json) ตอนนี้อยู่ในรูปแบบ
-```json
-{
- "notname": "คำสั่งเรียก ให้ทำคำให้การ",
- "nottype": "(ต. ๑)",
- "blackno": "คดีหมายเลขดำที่",
- "blackyear": "๑๐/๒๕๖๙",
- ...
-}
-```
-data(json)น่าจะปรับเป็นแบบนี้เพื่อรองรับการทำ Token-Based Seamless Integration
-หลักผ่าน API
-- ส่วนของ cc จะไปกรอกใน Content Control
-- uid,uname,fid,ott,expire สร้างเป็น token ฝังใน custom property ของเอกสาร
-```json
-{
- "uid":"id ผู้มีสิทธิ์แก้ไขเอกสาร",
- "uname": "ชื่อผู้มีสิทธิ์แก้ไขเอกสาร สำหรับแสดงผล",
- "fid":"file id จะได้เซฟข้อมูลกลับไปที่ Oracle ถูกตารางและหน่วยงาน",
- "ott":"อายุของ one time token แบบระยะสั้น",
- "expire": "อายุเอกสารแบบระยะยาวหลังเอา ott ไปแลก (optional)",
- cc:{
- "notname": "คำสั่งเรียก ให้ทำคำให้การ",
- "nottype": "(ต. ๑)",
- "blackno": "คดีหมายเลขดำที่",
- "blackyear": "๑๐/๒๕๖๙",
- ...
- }
-}
-```
-ที่ต้องทำเพิ่ม
-- render ปัจจุบันมีไว้ให้ทางศาลทดสอบ อันที่ใช้จริงหลังกดสร้าง Template เพื่อ Download จะสร้างเอกสารเวอร์ชั่นแรกใน object storage หรือถ้ามีอยู่แล้ว จะเป็นการอัปเดต
-- Backend จัดการ version
-- อัปเดตข้อมูลและเอกสารกลับระบบเดิม ส่วนนี้ยังไม่ชัดเจนอาจจะทำ mock api เตรียมไว้ก่อน
-
-# ทดลอง Restrict Edit + Custom Properties (2026-10-07)
-
-สคริปต์ `make-protected.mjs` — อ่าน docx → เปิด protection + ฝัง custom properties → เขียนไฟล์ → อ่านกลับ verify ทุกครั้ง
-
-```sh
-node app/api/template/test/make-protected.mjs [in.docx] [out.docx]
-# ไม่ส่ง argument = อ่านและเขียนทับ output-T3.docx (ค่าตัวอย่างฝังอยู่ในตัวสคริปต์ CUSTOM_PROPS)
-```
-
-## Restrict Edit (เปิดผ่านโค้ด)
-
-- อยู่ที่ `word/settings.xml` → `@align` (2026-10-07) — **ถอดออกแล้วตามคำขอ (ยังไม่เอา)**
-
-- เคย implement ใน `lib-tmpl.ts` + spec `lib/openapi.ts` แล้ว**ถอดกลับสถานะเดิม** — extract ปัจจุบันคืนแค่ `{ tag: text }` เหมือนเดิม
-- แนวทางที่พิสูจน์แล้วว่าใช้ได้ (เผื่อกลับมาทำภายหลัง): คืน key `@align` (ค่า w:jc เช่น `thaiDistribute`) เฉพาะช่องที่ต่างจาก default ของเอกสาร โดย resolve: `w:pPr/w:jc` ตรงของย่อหน้า → style ที่ใช้ (ไล่ `w:pStyle` → `w:basedOn`) → `docDefaults` ("left"/"start" นับเป็นไม่ตั้ง) — บริบทย่อหน้าของช่อง: CC block = `w:p` แรกใน `w:sdtContent` / CC inline = `w:p` ที่ครอบ sdt
-- ผลทดสอบตอน implement: direct pPr ชนะ style ✓ inline/block จับได้ทั้งคู่ ✓ และ T3 จัดช่อง 8 ตัวผ่าน style อยู่แล้ว (nottype/blackyear/redyear/acc1/acc2/groupname/detail1/pname — ชิดขวา/กลาง) — ช่องเหล่านี้จะโผล่ `@align` ตามจริง
-
-## จัด paragraph แบบ Thai Distributed — ตัดสินใจ: จัดเองใน Word ตอนทำ template (2026-10-07)
-
-- ค่า OOXML คือ `;
+}) {
+ const entries = Object.entries(searchParams);
+ const isEcourtLink = entries.some(([key]) =>
+ (ECOURT_PARAM_KEYS as readonly string[]).includes(key),
+ );
+ if (!isEcourtLink) {
+ redirect("/wordaddin");
+ }
+ const qs = new URLSearchParams();
+ for (const [key, value] of entries) {
+ if (typeof value === "string") {
+ qs.set(key, value);
+ } else if (Array.isArray(value)) {
+ for (const v of value) qs.append(key, v);
+ }
+ }
+ redirect(`/note?${qs.toString()}`);
+}
diff --git a/app/tmpl/page.tsx b/app/tmpl/page.tsx
new file mode 100644
index 0000000..0eaec44
--- /dev/null
+++ b/app/tmpl/page.tsx
@@ -0,0 +1,100 @@
+// app/page.tsx (ระบบ B)
+'use client';
+import type { ChangeEvent } from 'react';
+// import { createDownloadFormAction } from './actions';
+import DependentDropdown, { DropdownData } from '@/components/utils/DependentDropdown';
+
+
+
+export default function HomePage() {
+ const templateData: DropdownData = {
+ T_X: ['T_no_warning', 'TF_no_warning_P2', 'TS_P2_IN'],
+ T12_X: ['T12_b2_IN', 'T12_FD155_3s-long'],
+ };
+ const handleTmplSelect = (template: string, data: string) => {
+ //console.log('Location Selected:', { template, data });
+ };
+ const handleInput = (e: ChangeEvent)=>{
+ // console.log(e.target)
+ return true;
+ }
+ return (
+ ('');
+ const [subSelection, setSubSelection] = useState('');
+
+ const handleMainChange = (e: ChangeEvent) => {
+ const value = e.target.value;
+ setMainSelection(value);
+ setSubSelection('');
+ };
+
+ const handleSubChange = (e: ChangeEvent) => {
+ setSubSelection(e.target.value);
+ };
+
+ useEffect(() => {
+ if (onSelectChange) {
+ onSelectChange(mainSelection, subSelection);
+ }
+ }, [mainSelection, subSelection, onSelectChange]);
+
+ const subOptions = mainSelection ? data[mainSelection] : [];
+
+ return (
+ (null);
+
+ // component ถูก mount ค้างไว้ตลอด (TaskpaneApp render ไว้นอก phase branch) — ต้องเคลียร์ค่าตอนปิด
+ // ไม่ใช่ตอน unmount ไม่งั้นข้อความรอบก่อนหลุดมารอบถัดไป
+ useEffect(() => {
+ if (!open) {
+ setMessage("");
+ }
+ }, [open]);
+
+ // ESC = ยกเลิก (เฉพาะไม่กำลัง busy — ตอน busy ห้ามปิดได้ทุกทางตาม spec)
+ // Tab กักไว้ใน dialog — สิ่งที่ Fluent Dialog เคยทำให้อัตโนมัติ (WCAG 2.1.2/2.4.3)
+ useEffect(() => {
+ if (!open) return;
+ const onKey = (event: KeyboardEvent) => {
+ if (event.key === "Escape" && !busy) onDismiss();
+ if (event.key === "Tab") {
+ const focusables = dialogRef.current?.querySelectorAll(
+ "button:not([disabled]), textarea:not([disabled]), [href], input, select, [tabindex]:not([tabindex='-1'])",
+ );
+ const first = focusables?.item(0);
+ const last = focusables?.item((focusables?.length ?? 0) - 1);
+ if (!first || !last) return;
+ if (event.shiftKey && document.activeElement === first) {
+ event.preventDefault();
+ last.focus();
+ } else if (!event.shiftKey && document.activeElement === last) {
+ event.preventDefault();
+ first.focus();
+ }
+ }
+ };
+ window.addEventListener("keydown", onKey);
+ return () => window.removeEventListener("keydown", onKey);
+ }, [open, busy, onDismiss]);
+
+ // โฟกัสเข้า dialog ตอนเปิด + คืน focus ให้ trigger เดิมตอนปิด (อีกส่วนที่ Fluent เคยทำให้)
+ useEffect(() => {
+ if (!open) return;
+ const previous = document.activeElement as HTMLElement | null;
+ dialogRef.current?.focus();
+ return () => {
+ previous?.focus();
+ };
+ }, [open]);
+
+ if (!open) return null;
+
+ return createPortal(
+
+
+ );
+}
\ No newline at end of file
diff --git a/app/wordaddin/error.tsx b/app/wordaddin/error.tsx
new file mode 100644
index 0000000..ac42382
--- /dev/null
+++ b/app/wordaddin/error.tsx
@@ -0,0 +1,37 @@
+"use client";
+
+// [DBG-r3p1] error boundary ของ taskpane — แสดง error จริงแทนหน้า
+// "Application error: a client-side exception has occurred" ของ Next
+// (ไว้ใช้ debug ใน webview ของ Word ที่เปิด devtools ไม่ได้ — คงไว้ถาวร
+// เพราะดีกว่าข้อความกลาง ๆ ของ Next เสมอ สำหรับ add-in ที่ผู้ใช้เปิด console ไม่ได้)
+export default function WordAddinError({
+ error,
+ reset,
+}: {
+ error: Error & { digest?: string };
+ reset: () => void;
+}) {
+ return (
+
+
+ ตัวอย่างการใช้ สร้างเอกสารจาก Template
+
+ ตัวอย่าง Frontend ส่งข้อมูลผ่าน <form>(POST) หรือ <a>(GET)
+ เพื่อรองรับ Vanilla JavaScript และ Classic Framework ใช้การเปลี่ยนหน้าเพื่อดาว์นโหลดไฟล์
+ ต้องทำให้ ASP.NET มีฟังก์ชั่นเหมือน /docedit/api/template/download-docx
+
+
+
+
+
+
+ TF_no_warning_P2_john_xxx.docx
+ TS_P2_IN_john_xxx.docx
+ + T12_b2_IN_john_xxx.docx
+ T12_FD155_3s-long_john_xxx.docx
+
+ A Link Get
+ T_no_warning_john_xxx.docx+ TF_no_warning_P2_john_xxx.docx
+ TS_P2_IN_john_xxx.docx
+ + T12_b2_IN_john_xxx.docx
+ T12_FD155_3s-long_john_xxx.docx
+
+
+ Data: TF_no_warning_P2.json, + T_no_warning.json, + TS_P2_IN.json
+ T12_b2_IN.json, + T12_FD155_3s-long.json +
+ Template & Data
+ Template: T_X.docx, + T12_X.docx+ Data: TF_no_warning_P2.json, + T_no_warning.json, + TS_P2_IN.json
+ T12_b2_IN.json, + T12_FD155_3s-long.json +
+
+
+ Flow
+
+ หน้านี้(เลือกไฟล์)
+ ↓
+ download-docx(ตรวจสิทธิ์,ส่งเทมเพลต ID,ส่งข้อมูล)
+ ↓
+ generate(เปิดเทมเพลต,สร้าง docx)
+ ↓
+ ดาว์นโหลด docx เปิด MS Word อัตโนมัติ
+ ↓
+ Add-ins ตรวจสอบไฟล์, ผู้ใช้แก้ไข docx
+ ↓
+ Versioning(คุมเวอร์ชั่น)
+ ↓
+ ecourt(อัปเดตฐานข้อมูลและไฟล์)
+ +
+
+ + ↓
+ download-docx(ตรวจสิทธิ์,ส่งเทมเพลต ID,ส่งข้อมูล)
+ ↓
+ generate(เปิดเทมเพลต,สร้าง docx)
+ ↓
+ ดาว์นโหลด docx เปิด MS Word อัตโนมัติ
+ ↓
+ Add-ins ตรวจสอบไฟล์, ผู้ใช้แก้ไข docx
+ ↓
+ Versioning(คุมเวอร์ชั่น)
+ ↓
+ ecourt(อัปเดตฐานข้อมูลและไฟล์)
+ +
+
+ );
+}
diff --git a/app/wordaddin/layout.tsx b/app/wordaddin/layout.tsx
new file mode 100644
index 0000000..54a73c7
--- /dev/null
+++ b/app/wordaddin/layout.tsx
@@ -0,0 +1,10 @@
+import type { Metadata } from "next";
+
+/** nested layout แรกของ repo — override ชื่อแท็บ browser ของ taskpane (ส่วนอื่นสืบทอดจาก root layout) */
+export const metadata: Metadata = {
+ title: "e-Court Documents Versioning",
+};
+
+export default function WordAddinLayout({ children }: { children: React.ReactNode }) {
+ return children;
+}
diff --git a/app/wordaddin/manifest.xml/route.ts b/app/wordaddin/manifest.xml/route.ts
new file mode 100644
index 0000000..9b19dbd
--- /dev/null
+++ b/app/wordaddin/manifest.xml/route.ts
@@ -0,0 +1,33 @@
+import fs from "node:fs";
+import path from "node:path";
+
+import { requestOrigin } from "@/utils/request-origin";
+
+// GET /wordaddin/manifest.xml — manifest ของ Word add-in สำหรับ sideload
+//
+// URL ใน manifest เป็น absolute https ตามข้อบังคับของ Office แต่ต้องต่างกันตาม
+// environment — เดิมใช้ไฟล์ static ใน public/ ค่า dev (localhost:3000) แล้วให้ผู้
+// deploy rewrite มือเองทุกครั้ง (docs/WORDADDIN-DEV.md) ตอนนี้ serve ผ่าน route
+// แทน: อ่าน template (public/wordaddin/manifest.template.xml — ค่า dev) แล้ว
+// เขียนทับ origin ให้ตรงโฮสต์ที่ขอไฟล์ (dev/UAT/production ใช้ template
+// เดียวกัน — โหลดจาก environment ไหน manifest ก็ชี้ environment นั้น)
+//
+// อ่านจาก public/ เพราะเป็นที่เดียวที่การันตีว่ามีใน standalone ของ Docker
+// (runner stage COPY public — ไฟล์ app/ ต้นฉบับไม่ถูกก๊อปเข้า image)
+
+/** origin dev ที่ฝังใน template — สตริงเดียวที่ถูกแทนที่ทั้งไฟล์ (6 จุด) */
+const DEV_ORIGIN = "https://localhost:3000";
+
+const TEMPLATE = path.join(process.cwd(), "public", "wordaddin", "manifest.template.xml");
+
+export function GET(req: Request): Response {
+ const template = fs.readFileSync(TEMPLATE, "utf8");
+ const manifest = template.replaceAll(DEV_ORIGIN, requestOrigin(req));
+ return new Response(manifest, {
+ headers: {
+ "content-type": "application/xml; charset=utf-8",
+ // origin ขึ้นกับ header ของผู้ขอ — ห้ามแคกลามผู้ใช้เกินครั้งเดียวต่อ download
+ "cache-control": "no-store",
+ },
+ });
+}
diff --git a/app/wordaddin/page.tsx b/app/wordaddin/page.tsx
new file mode 100644
index 0000000..b3509a3
--- /dev/null
+++ b/app/wordaddin/page.tsx
@@ -0,0 +1,7 @@
+import WordAddinGate from "@/components/wordaddin/WordAddinGate";
+
+/** Taskpane ของ Word add-in (URL /docedit/wordaddin) — server component บาง ๆ ทั้งหมดอยู่ฝั่ง client
+ * auth/API เป็น mock ของ wordaddin เอง (ไม่ใช้ cookie oacCase — middleware ยกเว้น path นี้) */
+export default function WordAddinPage() {
+ return task pane ทำงานผิดพลาด
++ เกิดข้อผิดพลาดฝั่งหน้าเว็บ — แจ้งข้อความด้านล่าง (ถ่ายภาพหน้าจอนี้มาด้วย) แล้วกดลองใหม่ +
+
+ {error.message}
+ {error.digest ? `\n[digest ${error.digest}]` : ""}
+ {error.stack ? `\n\n${error.stack}` : ""}
+
+
+
+ {/* Dropdown ที่ 1 */}
+
+ );
+}
diff --git a/components/wordaddin/ConfirmVersionDialog.tsx b/components/wordaddin/ConfirmVersionDialog.tsx
new file mode 100644
index 0000000..e22e905
--- /dev/null
+++ b/components/wordaddin/ConfirmVersionDialog.tsx
@@ -0,0 +1,166 @@
+"use client";
+
+import { useEffect, useRef, useState, type ReactNode } from "react";
+import { createPortal } from "react-dom";
+
+import { Spinner } from "./Spinner";
+
+/**
+ * FR-2 ขั้นตอนที่ 1 — dialog ยืนยัน "สร้าง version ใหม่ของเอกสารนี้หรือไม่?" พร้อมชื่อ commit
+ * message ทางเลือก (FR-13) — ใช้ร่วมกับทั้ง Save & Version และ Start Versioning
+ * FR-18 — มี onConfirmClose = มีปุ่มที่สอง [บันทึกเวอร์ชันและปิดเอกสาร] เป็น primary ตัวเดียว
+ * (ปุ่มยืนยันหลักกลายเป็น secondary) ส่งเฉพาะ platform ที่ปิดเอกสารได้
+ * พอร์ตจาก ConfirmVersionDialog.tsx ต้นฉบับ — แทน Dialog ของ Fluent ด้วย portal + Genesis
+ * (pattern overlay เดียวกับ AnnotationSidebar)
+ */
+
+const DEFAULT_TITLE = "สร้าง version ใหม่?";
+const DEFAULT_DESCRIPTION = "ระบบจะบันทึกไฟล์ปัจจุบันและอัปโหลดเป็น version ถัดไปของเอกสารนี้";
+const DEFAULT_CONFIRM_LABEL = "สร้าง version";
+
+const BTN_SECONDARY =
+ "focus-ring 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";
+const BTN_PRIMARY =
+ "focus-ring rounded-md bg-primary px-3 py-1.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";
+
+export function ConfirmVersionDialog({
+ open,
+ busy,
+ title,
+ description,
+ confirmLabel,
+ onConfirm,
+ onConfirmClose,
+ onDismiss,
+}: {
+ open: boolean;
+ /** กำลังอยู่ระหว่าง flow หลังกดยืนยันแล้ว — ปุ่มทั้งหมด disable + แสดง spinner + ปิดไม่ได้ */
+ busy: boolean;
+ /** ปรับข้อความตอน reuse กับ flow อื่น (FR-13 — Start Versioning ใช้ dialog ตัวเดียวกัน) */
+ title?: string;
+ description?: ReactNode;
+ confirmLabel?: string;
+ /** ได้รับ commit message ที่ผู้ใช้พิมพ์ (FR-13) — ว่างได้ */
+ onConfirm: (message: string) => void;
+ /** FR-18 — submit ที่สอง "บันทึกเวอร์ชันและปิดเอกสาร" */
+ onConfirmClose?: (message: string) => void;
+ onDismiss: () => void;
+}) {
+ const [message, setMessage] = useState("");
+ const dialogRef = useRef
+
+
+
+
+ {/* Dropdown ที่ 2 */}
+
+
+
+
+ !busy && onDismiss()}
+ >
+
event.stopPropagation()}
+ >
+
{title ?? DEFAULT_TITLE}
+{description ?? DEFAULT_DESCRIPTION}
+ +