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>

app/actions/annotations.ts

@@ -445,8 +445,8 @@ function validateAnnotationData(type: AnnotationType, v: unknown): AnnotationDat
  * hard refresh ถึงเห็น (force-dynamic ปิดแค่ cache ฝั่ง server เท่านั้น)
  */
 function revalidateFilePages(fileId: string) {
-  revalidatePath(`/annotate/${fileId}`);
-  revalidatePath(`/annotate/${fileId}/summary`);
+  revalidatePath(`/note/annotate/${fileId}`);
+  revalidatePath(`/note/annotate/${fileId}/summary`);
 }
 
 export async function createAnnotation(input: CreateAnnotationInput): Promise<AnnotationDTO> {

app/actions/auth.ts

@@ -36,6 +36,6 @@ export async function logout(): Promise<void> {
   // ลบ cookie ด้วย path "/" เท่านั้น (ตรงกับตอน set) ไม่งั้น browser ไม่ลบให้
   cookies().set(OAC_CASE_COOKIE, "", { path: "/", maxAge: 0 });
   // redirect ใน action เอง — ให้ Next จัดการ navigation กลไกเดียว
-  // (ถ้าให้ client router.replace เอง จะชนกับ re-render ของหน้า "/" ที่เพิ่งเสีย session จน navigation ไม่เกิด)
-  redirect("/login");
+  // (ถ้าให้ client router.replace เอง จะชนกับ re-render ของหน้ารายการที่เพิ่งเสีย session จน navigation ไม่เกิด)
+  redirect("/note/login");
 }

app/actions/files.ts

@@ -1,8 +1,8 @@
 "use server";
 
 // N4 — อัปโหลดไฟล์เอกสารแบบง่าย (PDF/jpg/jpeg/png/tif/tiff) ผ่านหน้ารายการ
-// เขียนไฟล์**ใหม่**ที่ public/uploads/<uuid>.<ext> เท่านั้น (ชื่อจาก randomUUID — กันชนกัน/กัน path traversal)
-// ไม่มี SSE event: รายการไฟล์ไม่ได้ sync ผ่าน SSE — revalidatePath("/") พอ (สเปก PLAN-FEAT.md §7 N4)
+// เขียนไฟล์**ใหม่**ที่ public/note/uploads/<uuid>.<ext> เท่านั้น (ชื่อจาก randomUUID — กันชนกัน/กัน path traversal)
+// ไม่มี SSE event: รายการไฟล์ไม่ได้ sync ผ่าน SSE — revalidatePath("/note") พอ (สเปก PLAN-FEAT.md §7 N4)
 import { randomUUID } from "node:crypto";
 import { mkdir, unlink, writeFile } from "node:fs/promises";
 import path from "node:path";
@@ -16,7 +16,7 @@ import { SAMPLE_FILE_EXTENSIONS } from "@/utils/file-kind";
 import { decodeUploadFilename } from "@/utils/upload-name";
 
 const MAX_UPLOAD_BYTES = 100 * 1024 * 1024; // 100MB (ตาม bodySizeLimit ใน next.config.mjs)
-const UPLOAD_DIR = path.join(process.cwd(), "public", "uploads");
+const UPLOAD_DIR = path.join(process.cwd(), "public", "note", "uploads");
 
 export type UploadFileResult =
   | { ok: true; fileId: string; title: string }
@@ -108,6 +108,6 @@ export async function uploadFile(formData: FormData): Promise<UploadFileResult>
     throw err;
   }
 
-  revalidatePath("/");
+  revalidatePath("/note");
   return { ok: true, fileId: id, title };
 }

app/api/note/external/documents/route.ts

@@ -5,7 +5,7 @@ import { files } from "@/db/schema";
 import { externalApiError, requireExternalApiKey } from "@/lib/external-api-auth";
 import { loadDocumentBundles, parseQueryBody } from "@/lib/external-api";
 
-// N10 (PLAN-API.md D2) — POST /api/external/documents
+// N10 (PLAN-API.md D2) — POST /api/note/external/documents
 // (เดิมชื่อ /api/external/query ถึงรอบสาม — เปลี่ยนชื่อตาม resource ที่คืน 2026-09-25)
 // เส้นเดียวถามด้วย JSON body { fileId และ/หรือ typeId, filter } — response
 // รูปเดียวเสมอ { documents: [bundle…] } (bundle ยุบชั้น — field เอกสารอยู่

app/note/annotate/[id]/page.tsx

@@ -30,7 +30,7 @@ export default async function AnnotatePage({
 
   // defense ซ้อน middleware — identity จาก cookie oacCase ส่งเข้า viewer ตั้งแต่ first paint
   const user = getSessionUser();
-  if (!user) redirect("/login");
+  if (!user) redirect("/note/login");
 
   const [file] = await db.select().from(files).where(eq(files.id, id));
   if (!file) notFound();

app/note/annotate/[id]/summary/page.tsx

@@ -16,7 +16,7 @@ import {
 } from "@/db/schema";
 
 // หน้าสรุปหมายเหตุ (F15/D2) — server component รวม annotation (ทุกผู้ใช้) + bookmark
-// แต่ละแถวกระโดดเป็น deep link `/annotate/<id>?ann=` / `?page=` (F12)
+// แต่ละแถวกระโดดเป็น deep link `/note/annotate/<id>?ann=` / `?page=` (F12)
 // — design "แฟ้มสำนวน" 2026-09-17 (แถบหัวน้ำเงิน + การ์ดรายหน้าขอบ folio +
 // รายการตามหน้าจุดไข่ปลา) → redesign 2026-09-24 ตามคำขอผู้ใช้เป็น explorer
 // 2 คอลัมน์แบบหน้ากลุ่ม N9: ตัวกรองฝั่งซ้าย (หน้า/ชนิดรายการ/ชนิดของ
@@ -134,7 +134,7 @@ export default async function SummaryPage({
           — ระบบภายนอกดึงข้อมูลผ่าน N10 API แทนทั้งหมดแล้ว */}
       <div className="mt-3 flex flex-wrap items-center gap-x-2 gap-y-1 print:hidden">
         <Link
-          href={`/annotate/${id}`}
+          href={`/note/annotate/${id}`}
           className={`inline-flex items-center gap-1.5 rounded-md border border-line bg-white px-3 py-1.5 text-sm text-ink hover:border-ink-faint hover:bg-ink/[0.03] ${RING_CLS}`}
         >
           <ArrowLeft aria-hidden className="h-3.5 w-3.5" />
@@ -154,7 +154,7 @@ export default async function SummaryPage({
             เปิดหน้าอ่านเพื่อมาร์กข้อความ วาดเส้น ใส่คอมเมนต์ หรือคั่นหน้า
           </p>
           <Link
-            href={`/annotate/${id}`}
+            href={`/note/annotate/${id}`}
             className={`mt-4 inline-flex rounded-md bg-primary px-4 py-2 text-sm font-medium text-white transition hover:-translate-y-px hover:bg-primary-hover hover:shadow-btn-glow ${RING_CLS}`}
           >
             เปิดหน้าอ่าน

app/note/annotate/page.tsx

@@ -7,9 +7,9 @@ import { firstSearchParam } from "@/utils/external-file";
 export const dynamic = "force-dynamic";
 
 /**
- * N8 entry point ที่สอง (ตามคำขอผู้ใช้ 2026-09-22): เข้า `/annotate?fileUrl=&fileId=&typeId=`
- * โดยตรง — ลงทะเบียนเอกสารแล้ว redirect ต่อไป `/annotate/<id>` ของตัว viewer จริง
- * (entry เดิมที่หน้า "/" ยังใช้ได้คู่กัน — สัญญาลิงก์รับทั้ง /?fileUrl= และ /annotate?fileUrl=)
+ * N8 entry point ที่สอง (ตามคำขอผู้ใช้ 2026-09-22): เข้า `/note/annotate?fileUrl=&fileId=&typeId=`
+ * โดยตรง — ลงทะเบียนเอกสารแล้ว redirect ต่อไป `/note/annotate/<id>` ของตัว viewer จริง
+ * (entry เดิมที่หน้า "/note" ยังใช้ได้คู่กัน — สัญญาลิงก์รับทั้ง /note?fileUrl= และ /note/annotate?fileUrl=)
  */
 export default async function AnnotateEntryPage({
   searchParams,
@@ -24,7 +24,7 @@ export default async function AnnotateEntryPage({
       firstSearchParam(searchParams.typeId),
     );
     // redirect โยน NEXT_REDIRECT — เรียกนอก try/catch เสมอ
-    if (result.ok) redirect(`/annotate/${result.fileId}`);
+    if (result.ok) redirect(`/note/annotate/${result.fileId}`);
     return (
       <main className="mx-auto max-w-2xl px-4 py-10 sm:px-8">
         <div
@@ -34,7 +34,7 @@ export default async function AnnotateEntryPage({
           เปิดเอกสารจากลิงก์ไม่สำเร็จ: {result.error}
         </div>
         <Link
-          href="/"
+          href="/note"
           className="focus-ring mt-4 inline-block rounded-md bg-primary px-4 py-2 text-sm font-medium text-white transition hover:-translate-y-px hover:bg-primary-hover hover:shadow-btn-glow"
         >
           กลับหน้ารายการ
@@ -43,7 +43,7 @@ export default async function AnnotateEntryPage({
     );
   }
 
-  // ไม่มี fileUrl เลย — ไม่มีอะไรให้เปิด (route จริงของ viewer อยู่ที่ /annotate/[id])
+  // ไม่มี fileUrl เลย — ไม่มีอะไรให้เปิด (route จริงของ viewer อยู่ที่ /note/annotate/[id])
   return (
     <main className="mx-auto max-w-2xl px-4 py-10 sm:px-8">
       <div className="rounded-xl border border-line bg-white p-6 text-sm text-ink-soft">
@@ -53,7 +53,7 @@ export default async function AnnotateEntryPage({
         หรือเลือกไฟล์จากหน้ารายการ
       </div>
       <Link
-        href="/"
+        href="/note"
         className="focus-ring mt-4 inline-block rounded-md bg-primary px-4 py-2 text-sm font-medium text-white transition hover:-translate-y-px hover:bg-primary-hover hover:shadow-btn-glow"
       >
         กลับหน้ารายการ

app/note/groups/[typeId]/page.tsx

@@ -130,7 +130,7 @@ export default async function GroupPage({
     // listing-page: hook ของกฎ coarse 44px ใน globals.css (อย่าถอด)
     <main className="listing-page mx-auto max-w-3xl px-4 py-8 sm:px-6 lg:max-w-6xl lg:px-8">
       <Link
-        href="/"
+        href="/note"
         className="focus-ring inline-flex items-center gap-1.5 rounded-md text-sm text-ink-soft transition hover:text-ink"
       >
         <ArrowLeft aria-hidden className="h-4 w-4" />

app/note/login/page.tsx

@@ -22,7 +22,7 @@ export default function LoginPage({
 
   // เข้าสู่ระบบอยู่แล้ว (cookie ครบ) → ไม่ต้องเห็นฟอร์มอีก
   const user = getSessionUser();
-  if (user) redirect(next ?? "/");
+  if (user) redirect(next ?? "/note");
 
   return (
     // Genesis: กริดจุดอันตรกิริยา ( decorative element ชิ้นเดียวที่อนุญาต) เป็นพื้นหลัง

app/note/page.tsx

@@ -62,7 +62,7 @@ function FileCard({ file }: { file: FileRow }) {
           (หนึ่ง primary ต่อ section ตาม Genesis; การ์ดทั้งกริดคือ passive surface) */}
       <div className="mt-5 flex flex-1 items-end justify-end">
         <Link
-          href={`/annotate/${file.id}`}
+          href={`/note/annotate/${file.id}`}
           className="focus-ring inline-flex h-8 items-center rounded-md border border-line px-3 text-sm font-medium text-ink transition hover:-translate-y-px hover:border-ink-faint"
         >
           Annotate
@@ -79,12 +79,12 @@ export default async function HomePage({
 }) {
   // defense ซ้อน middleware — หน้านี้อ่าน cookie อยู่ดีจึงกันซ้ำไม่ให้ render รายการให้คนไม่มี session
   const user = getSessionUser();
-  if (!user) redirect("/login");
+  if (!user) redirect("/note/login");
 
   // N8: เข้าจากลิงก์ e-Court ?fileUrl=&fileId=&typeId= — ลงทะเบียนเอกสาร (metadata-only
   // dedupe ด้วย external_id) แล้วพาเข้า viewer เลย — redirect() โยน NEXT_REDIRECT
   // ต้องเรียกนอก try/catch เสมอ; หน้านี้ force-dynamic จึงไม่ต้อง revalidatePath
-  // (entry ที่สองอยู่ที่ /annotate?fileUrl=… — app/annotate/page.tsx)
+  // (entry ที่สองอยู่ที่ /note/annotate?fileUrl=… — app/note/annotate/page.tsx)
   let registerError: string | null = null;
   const fileUrl = firstSearchParam(searchParams.fileUrl);
   if (fileUrl) {
@@ -93,7 +93,7 @@ export default async function HomePage({
       firstSearchParam(searchParams.fileId),
       firstSearchParam(searchParams.typeId),
     );
-    if (result.ok) redirect(`/annotate/${result.fileId}`);
+    if (result.ok) redirect(`/note/annotate/${result.fileId}`);
     registerError = result.error;
   }
 
@@ -199,7 +199,7 @@ export default async function HomePage({
                     </span>
                     {/* Next Link เติม basePath ให้เอง (invariant #12) */}
                     <Link
-                      href={`/groups/${encodeURIComponent(typeId)}`}
+                      href={`/note/groups/${encodeURIComponent(typeId)}`}
                       className="focus-ring ml-auto shrink-0 rounded text-sm font-medium text-primary hover:underline"
                     >
                       เอกสารในกลุ่ม

app/note/uploads/[name]/route.ts

@@ -7,13 +7,13 @@ import {
 } from "@/utils/file-kind";
 import { PdfPathError, resolvePublicPdfPath } from "@/lib/server-pdf";
 
-// N4 — เสิร์ฟไฟล์ที่อัปโหลด (`public/uploads/<uuid>.<ext>`) ผ่าน route handler
+// N4 — เสิร์ฟไฟล์ที่อัปโหลด (`public/note/uploads/<uuid>.<ext>`) ผ่าน route handler
 // ไม่ใช่ static file ของ Next: production server (next start / standalone) จะไล่
 // รายชื่อไฟล์ใน public/ เก็บไว้ใน Set **ครั้งเดียวตอน startup** เท่านั้น
 // (next/dist/server/lib/router-utils/filesystem.js — setupFsCheck) ไฟล์ที่ action
-// เขียนลง public/uploads/ หลัง server รันแล้วจึง GET ตรง ๆ ไม่ได้ (404)
+// เขียนลง public/note/uploads/ หลัง server รันแล้วจึง GET ตรง ๆ ไม่ได้ (404)
 // ฝั่ง next dev ไม่ผ่าน branch นั้น เลยทำงานได้ — อาการคลาสสิก "local ได้ production พัง"
-// อ่านอย่างเดียว (invariant #1) + path guard ของ lib/server-pdf เหมือน /api/pdf (§5)
+// อ่านอย่างเดียว (invariant #1) + path guard ของ lib/server-pdf เหมือน /api/note/pdf (§5)
 
 // ชื่อไฟล์ต้องเป็น uuid + extension ใน whitelist เท่านั้น (ตรงรูปที่ uploadFile เขียน)
 // — ชื่ออื่น 404 กลับไป ไม่รู้จักก็ไม่เปิด (กัน path traversal โดยแบบชื่อเอง: อักขระ