`, 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..07cd544
--- /dev/null
+++ b/app/api/documents/token/route.ts
@@ -0,0 +1,51 @@
+// 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" } },
+ );
+}
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/extract/route.ts b/app/api/template/extract/route.ts
index dc5b49c..e723f35 100644
--- a/app/api/template/extract/route.ts
+++ b/app/api/template/extract/route.ts
@@ -1,5 +1,6 @@
import { NextResponse } from "next/server";
-import { extractContentControls } from "../lib-tmpl";
+import { extractContentControls, extractBookmark, templateContentControls, setCustomDocProps, getDocProps,templateDynamicContents } from "@/lib/lib-tmpl";
+import { verifyDataEd25519, verifyHmacSha256 } from "@/lib/lib-utils";
export const runtime = "nodejs";
@@ -14,6 +15,9 @@ 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(
@@ -52,12 +56,35 @@ 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({
+ const cc = extractContentControls(buffer);
+ const bookmark = extractBookmark(buffer)
+ const properties = getDocProps(buffer)
+ let verify: Record ={}
+ 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 = {
success: true,
- data,
- });
+ cc,bookmark,properties,verify
+ }
+
+ return NextResponse.json(returnData);
} catch (error) {
console.error(error);
diff --git a/app/api/template/render/route.ts b/app/api/template/render/route.ts
index df6501c..8f04c9f 100644
--- a/app/api/template/render/route.ts
+++ b/app/api/template/render/route.ts
@@ -1,8 +1,6 @@
import { NextResponse } from "next/server";
-import {
- templateContentControls,
- type TemplateData,
-} from "../lib-tmpl";
+import { DocumentTemplate, templateContentControls, setCustomDocProps, getDocProps, templateDynamicContents } from "@/lib/lib-tmpl";
+import { generateHmacSha256, verifyHmacSha256, signDataEd25519, verifyDataEd25519, sortObjectKeys } from '@/lib/lib-utils';
export const runtime = "nodejs";
@@ -20,7 +18,13 @@ 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
// -----------------------------
@@ -62,14 +66,14 @@ export async function POST(request: Request) {
// อ่าน 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(
@@ -84,7 +88,7 @@ export async function POST(request: Request) {
// กรณี upload data.json
const text = await dataFile.text();
- data = JSON.parse(text) as TemplateData;
+ templateData = JSON.parse(text) as DocumentTemplate;
} else {
return NextResponse.json(
{
@@ -99,9 +103,8 @@ 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 },
);
@@ -109,9 +112,9 @@ export async function POST(request: Request) {
// JSON ต้องเป็น object
if (
- data === null ||
- typeof data !== "object" ||
- Array.isArray(data)
+ templateData === null ||
+ typeof templateData !== "object" ||
+ Array.isArray(templateData)
) {
return NextResponse.json(
{
@@ -126,18 +129,52 @@ export async function POST(request: Request) {
// Template File → Buffer
// -----------------------------
- const templateBuffer = Buffer.from(
+ let templateBuffer: Buffer = Buffer.from(
await template.arrayBuffer(),
);
- // -----------------------------
- // ใช้ lib-tmpl.ts เดิม
- // -----------------------------
+ //Calculate hash
+ const originalTicket_data = templateData?.info?.ticket_data //expect valid json string
+ // console.log("templateData",templateData?.info?.ticket_data)
+ if (originalTicket_data && typeof originalTicket_data === 'string') {
+ try {
- const output = templateContentControls(
- templateBuffer,
- data,
- );
+ const ttlSeconds: number = 300
+ const originalTicketObj = JSON.parse(originalTicket_data)//sort and add expire to ticket data
+ if (originalTicketObj && typeof originalTicketObj === 'object') {
+ 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 กลับ
diff --git a/app/api/template/test/Test.docx b/app/api/template/test/Test.docx
new file mode 100644
index 0000000..f078f00
Binary files /dev/null and b/app/api/template/test/Test.docx differ
diff --git a/app/page.tsx b/app/page.tsx
index cd22e59..5169a2d 100644
--- a/app/page.tsx
+++ b/app/page.tsx
@@ -1,23 +1,33 @@
import { redirect } from "next/navigation";
// หน้า root (/docedit) — แทน redirects() เดิมใน next.config.mjs (ถอดออกลด hop
-// ที่ Next สั่งเองตอน deploy หลัง IIS/proxy): พาเข้าหน้ารายการของ /note เสมอ
-// — redirect() ไม่แนบ searchParams ให้อัตโนมัติเหมือน redirects() จึงต้องส่งต่อ
-// เอง ไม่งั้นสัญญาลิงก์ e-Court /docedit/?fileUrl=&fileId=&typeId= (N8) พัง
+// ที่ Next สั่งเองตอน deploy หลัง IIS/proxy)
+// ตามคำขอผู้ใช้ 2026-10-14: เปิด /docedit เปล่า ๆ → เข้า taskpane ของ wordaddin
+// เลย (/wordaddin — middleware ไม่บังคับ login ที่ root) ยกเว้น**ลิงก์ e-Court**
+// /docedit/?fileUrl=&fileId=&typeId= (N8) ที่ยังส่งต่อให้ /note เหมือนเดิม —
+// redirect() ไม่แนบ searchParams ให้อัตโนมัติเหมือน redirects() จึงต้องส่งต่อเอง
// (redirect ของ next/navigation เติม basePath ให้เอง — invariant #12)
+const ECOURT_PARAM_KEYS = ["fileUrl", "fileId", "typeId"] as const;
+
export default function RootPage({
searchParams,
}: {
searchParams: Record;
}) {
+ 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 Object.entries(searchParams)) {
+ 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);
}
}
- const query = qs.toString();
- redirect(`/note${query ? `?${query}` : ""}`);
+ redirect(`/note?${qs.toString()}`);
}
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 (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(
+
!busy && onDismiss()}
+ >
+
event.stopPropagation()}
+ >
+
{title ?? DEFAULT_TITLE}
+{description ?? DEFAULT_DESCRIPTION}
+ +