eCourt-note/hooks/useAnnotationRealtime.ts
Your Name 8cc15ea75d
All checks were successful
Deploy eCourt Note Web to Server / Validate Database Schema (Drizzle) (push) Successful in 3s
Deploy eCourt Note Web to Server / Build Web Docker Image (push) Successful in 52s
Deploy eCourt Note Web to Server / Deploy eCourt Note Web to Server (push) Successful in 13s
Deploy eCourt Note Web to Server / Notify Deployment Status (push) Successful in 1s
refactor(routes): move routes under /note, APIs under /api/note
เตรียม basePath /docedit เป็นพื้นที่กลางให้แอปพี่น้อง (wordaddin ใน
อนาคต) — เดิม basePath ครอบ /docedit/note ทั้งหมดจนแชร์ prefix ไม่ได้
(Next มี basePath ได้ทางเดียว) และจัด API แยกต้นไม้ตามที่ผู้ใช้ขอ

(1) โครงสร้างใหม่: basePath = /docedit + route หน้าทั้งหมดย้ายเข้า
app/note/** + API 4 เส้นย้ายเข้า app/api/note/** + statics ย้ายเข้า
public/note/** (samples, uploads, pdf.worker) — หน้า/statics URL ปลายทาง
คงเดิมเป๊ะ (/docedit/note/…) ส่วน URL API เปลี่ยนเป็น /docedit/api/note/…
ตามคำขอผู้ใช้ (N10 endpoint เปลี่ยน — ต้องแจ้ง backend e-Court ก่อนใช้)

(2) กลไก: withBasePath (utils/base-path.ts) เติม base + app path /note
ยกเว้น path ที่ขึ้นต้น /api/ เติมแค่ base (caller เขียน /api/note/… เต็ม);
resolvePublicPdfPath root ที่ public/note (traversal guard เดิม);
middleware matcher ยกเว้นใหม่ (note/login, api/note, note/uploads,
note/samples, note/pdf.worker, _next, fonts, favicon) + redirect
/note/login; next.config เพิ่ม redirects /docedit -> /docedit/note;
navigation ภายใน 19 จุด + revalidatePath 3 จุด ใส่ prefix /note;
pdf_url ใน DB เป็น logical path ไม่แก้แม้แต่ตัวเดียว (seed/upload
เขียนค่าเดิม, browser เติมผ่าน withBasePath, disk เติมผ่าน guard)

(3) ตามแก้: patch-pdf-worker (DEST public/note + mkdirSync ปลายทาง),
seed-samples (SAMPLES_DIR), uploadFile (UPLOAD_DIR), Dockerfile/
.dockerignore/.gitignore/docker-compose.test.yml, tests 2 ไฟล์ที่อ้าง
disk path จริง, sync เอกสารทั้งหมด (CLAUDE.md invariant #6/#12 + tree,
README, docs/API-DOCUMENTS.md, .claude/rules/*, sync-db skill)

(4) !! ตอน deploy ต้องย้าย volume ตาม: mount /app/public/uploads ->
/app/public/note/uploads + ย้ายไฟล์ใน volume ให้ตรงตำแหน่ง ไม่งั้นไฟล์
ที่เคยอัปโหลด (พร้อม annotation ที่ผูกอยู่) 404 ทันทีที่สลับ image

(5) verify: build ผ่าน (route table /api/note/** + /note/** ครบ), tsc,
vitest 215/215, curl ครบทุก endpoint (login/redirect chain, worker,
samples, uploads, SSE, api/pdf, export, N8 register, N10 bundle + deep
link), Playwright browser จริง (canvas + textLayer ไทย render, browser
ยิง URL ใหม่ทั้งหมดไม่มี request ไป URL เก่า), plan-reviewer +
code-reviewer 3 รายงาน 0 blocking

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-10-06 14:55:07 +07:00

84 lines
3.6 KiB
TypeScript

import { useEffect, useState } from "react";
import type { AnnotationDTO, BookmarkDTO, ReplyDTO } from "@/db/schema";
import type { AnnotateEvent } from "@/lib/annotate-events";
import { withBasePath } from "@/utils/base-path";
// SSE sync (PLAN.md §4, rules/realtime.md)
// - เปิด EventSource ไป /api/note/annotations/stream?fileId=<id> — reconnect อัตโนมัติเมื่อขาด (ห้ามทำ retry เอง)
// - event เป็น DTO (camelCase + ISO string) จาก server ตรง ๆ — ไม่มีการแปลง
// - dedupe ด้วย id เท่านั้น (คู่กับ useOptimistic ใน PDFViewer — PLAN.md §4)
export function useAnnotationRealtime(
fileId: string,
initialAnnotations: AnnotationDTO[],
initialBookmarks: BookmarkDTO[],
initialReplies: ReplyDTO[],
) {
const [annotations, setAnnotations] = useState(initialAnnotations);
const [bookmarks, setBookmarks] = useState(initialBookmarks);
const [replies, setReplies] = useState(initialReplies);
useEffect(() => {
const es = new EventSource(withBasePath(`/api/note/annotations/stream?fileId=${fileId}`));
es.onmessage = (e: MessageEvent<string>) => {
let ev: AnnotateEvent;
try {
ev = JSON.parse(e.data) as AnnotateEvent;
} catch {
return;
}
// กรอง message ที่ไม่ใช่ annotate event (เช่น { type: "connected" })
if (typeof ev.table !== "string" || typeof ev.action !== "string") return;
if (ev.table === "annotations") {
if (ev.action === "create") {
setAnnotations((prev) =>
prev.some((a) => a.id === ev.row.id) ? prev : [...prev, ev.row],
);
} else if (ev.action === "update") {
// replace ตาม id — idempotent: event มาก่อน/หลัง optimistic ก็ได้ผลเดียวกัน (PLAN-FEAT.md §5)
setAnnotations((prev) =>
prev.some((a) => a.id === ev.row.id)
? prev.map((a) => (a.id === ev.row.id ? ev.row : a))
: prev,
);
} else {
setAnnotations((prev) => prev.filter((a) => a.id !== ev.id));
// ลบแม่ → replies หายตาม CASCADE ของ DB — เก็บ state ให้เท่ากันด้วย (F9)
setReplies((prev) => prev.filter((r) => r.annotationId !== ev.id));
}
} else if (ev.table === "replies") {
if (ev.action === "create") {
setReplies((prev) =>
prev.some((r) => r.id === ev.row.id) ? prev : [...prev, ev.row],
);
} else {
setReplies((prev) => prev.filter((r) => r.id !== ev.id));
}
} else {
if (ev.action === "create") {
setBookmarks((prev) =>
prev.some((b) => b.id === ev.row.id) ? prev : [...prev, ev.row],
);
} else if (ev.action === "update") {
// N2: แก้ชื่อ/โน้ต/ย้ายหัวข้อ (รวมลูกที่ถูกยกขึ้น root ตอนแม่ถูกลบ) — replace by id
setBookmarks((prev) =>
prev.some((b) => b.id === ev.row.id)
? prev.map((b) => (b.id === ev.row.id ? ev.row : b))
: prev,
);
} else {
setBookmarks((prev) => prev.filter((b) => b.id !== ev.id));
}
}
};
return () => {
es.close();
};
}, [fileId]);
return { annotations, bookmarks, replies, setAnnotations, setBookmarks, setReplies };
}