refactor(auth): consolidate auth under /api/auth/* endpoints

- ยุบ route auth ที่เคย copy กันจน drift (flow N11 หายจาก /api/auth/session)
  เหลือโค้ด inline สองเส้นเดียว: POST /api/auth/token (ทางเข้า 3: x-api-key
  docver / x-api-key purpose:"login" mint ลิงก์ note / ticket ของ add-in)
  + POST /api/auth/session (แลก credential + register N8 + N11 fid-only)
- POST /api/documents/token คงไว้เป็น alias re-export (กลุ่ม docver/e-Court
  เดิม — contract เดิมเป๊ะ, มี test toBe กัน copy แยกชุดกลับมา)
- ถอดเส้นฝั่ง note ทั้งสอบ: /api/note/auth/token + /api/note/auth/session
  (e-Court ต้องย้ายมาทางเข้ารวม — แจ้งทีม e-Court ก่อน deploy)
- utils/auth-store.ts: primitives กลางฝั่ง client (jwtExp/isExpired/
  localStorage store + memory fallback) — lib/note-session ใช้ร่วม
  (expMs decode จาก JWT payload = นาฬิกา server) และวางไว้ให้ wordaddin
  ย้ายมาใช้รอบหน้าได้ (รอบนี้ไม่แต้ wordaddin ตามข้อตกลง)
- นโยบาย token หมดอายุกลาง session: PDFViewer reportActionError จับ
  auth-error ของ Server Action ทุกจุด → ล้าง session แล้วพาไป
  /note?sso=expired (จบที่ gate เดียวกับ bootstrap 401)
- openapi: ทางเข้า purpose:"login" + schema LoginTokenRequest + ลบ path
  เส้นที่ถอด + test กันเส้นตายหลุดค้างใน spec
- เอกสาร sync: PLAN-SSO §0.6, CLAUDE.md, PLAN-STAGED, .env.example, /note/dev
- tests: ย้าย/เพิ่มชุด auth (50 เคสกลุ่ม auth ผ่าน, ทั้งชุด 444 ผ่าน) +
  e2e ครบทั้ง API (mint/alias/ticket/404 เส้นเก่า/N11/D4) และ browser

Co-Authored-By: Claude Code <noreply@anthropic.com>

components/pdf/PDFViewer.tsx

@@ -58,6 +58,7 @@ import {
   useAnnotationRealtime,
 } from "@/hooks/useAnnotationRealtime";
 import { useHistory } from "@/hooks/useHistory";
+import { clearNoteSession, isNoteAuthExpiredError } from "@/lib/note-session";
 import {
   useCustomSelection,
   type CustomSelectionCommit,
@@ -2216,6 +2217,22 @@ export default function PDFViewer({
     }, 6000);
   }
 
+  /** ท้ายร่วมของ catch ของ Server Action ทุกตัว (2026-11-09): ล้มเพราะ token หมด
+   *  อายุ/ไม่ผ่าน (message sentinel ของ requireUser) = ล้าง session แล้วพากลับหน้า
+   *  แรก ?sso=expired — token ที่ตายแล้วไม่มีทางฟื้น (browser ไม่มี ticket ให้ renew
+   *  แบบ add-in) โชว์ toast ต่อก็กดอะไรไม่ได้อีก สู้จบที่ gate เดียวกับตอน bootstrap
+   *  401 ของ AnnotateView · คืน true เมื่อจัดการแล้ว กรณีอื่น log (เดิม) แล้วคืน false
+   *  ให้ caller โชว์ error ของตัวเองต่อ */
+  function reportActionError(err: unknown, logLabel: string): boolean {
+    console.error(logLabel, err);
+    if (!isNoteAuthExpiredError(err)) return false;
+    clearNoteSession();
+    // withBasePath("") = /docedit/note — แบนเนอร์ ?sso=expired ของ NoteHome ต่อ (D11:
+    // ห้ามส่ง "/note" เข้า withBasePath)
+    window.location.replace(`${withBasePath("")}?sso=expired`);
+    return true;
+  }
+
   async function handleCreateAnnotation(
     pageIndex: number,
     type: AnnotationType,
@@ -2289,8 +2306,10 @@ export default function PDFViewer({
           },
         });
       } catch (err) {
-        console.error("บันทึก annotation ไม่สำเร็จ", err); // React rollback optimistic row ให้เอง
-        showActionError("บันทึกรายการไม่สำเร็จ — ตรวจสอบการเชื่อมต่อแล้วลองอีกครั้ง");
+        // React rollback optimistic row ให้เอง
+        if (!reportActionError(err, "บันทึก annotation ไม่สำเร็จ")) {
+          showActionError("บันทึกรายการไม่สำเร็จ — ตรวจสอบการเชื่อมต่อแล้วลองอีกครั้ง");
+        }
       } finally {
         pendingCreatesRef.current.delete(temp.id);
       }
@@ -2342,8 +2361,9 @@ export default function PDFViewer({
           });
         }
       } catch (err) {
-        console.error("ลบ annotation ไม่สำเร็จ", err);
-        showActionError("ลบรายการไม่สำเร็จ — ตรวจสอบการเชื่อมต่อแล้วลองอีกครั้ง");
+        if (!reportActionError(err, "ลบ annotation ไม่สำเร็จ")) {
+          showActionError("ลบรายการไม่สำเร็จ — ตรวจสอบการเชื่อมต่อแล้วลองอีกครั้ง");
+        }
       }
     });
   }
@@ -2386,8 +2406,10 @@ export default function PDFViewer({
             },
           });
         } catch (err) {
-          console.error("แก้ไข annotation ไม่สำเร็จ", err); // React rollback optimistic row ให้เอง
-          showActionError("แก้ไขรายการไม่สำเร็จ — ตรวจสอบการเชื่อมต่อแล้วลองอีกครั้ง");
+          // React rollback optimistic row ให้เอง
+          if (!reportActionError(err, "แก้ไข annotation ไม่สำเร็จ")) {
+            showActionError("แก้ไขรายการไม่สำเร็จ — ตรวจสอบการเชื่อมต่อแล้วลองอีกครั้ง");
+          }
           // ทิ้ง base ที่คิวเก็บไว้ — เป็น data ที่ action นี้ตั้งใจเขียนแต่ไม่เคยติด DB
           // ถ้าคงไว้ update ถัดไปจะผสานจน commit การเปลี่ยนที่ล้มไปด้วย และ undo
           // history กู้สถานะที่ไม่มีอยู่จริง (code review 2026-09-29) — รอบหน้าเริ่ม
@@ -2458,8 +2480,10 @@ export default function PDFViewer({
         const saved = await setAnnotationResolved(token, id, resolved);
         setAnnotations((prev) => prev.map((a) => (a.id === saved.id ? saved : a)));
       } catch (err) {
-        console.error("ตั้งสถานะไม่สำเร็จ", err); // React rollback optimistic ให้เอง
-        showActionError("ตั้งสถานะไม่สำเร็จ — ตรวจสอบการเชื่อมต่อแล้วลองอีกครั้ง");
+        // React rollback optimistic ให้เอง
+        if (!reportActionError(err, "ตั้งสถานะไม่สำเร็จ")) {
+          showActionError("ตั้งสถานะไม่สำเร็จ — ตรวจสอบการเชื่อมต่อแล้วลองอีกครั้ง");
+        }
       }
     });
   }
@@ -2481,8 +2505,9 @@ export default function PDFViewer({
       );
       return true;
     } catch (err) {
-      console.error("ตอบ comment ไม่สำเร็จ", err);
-      showActionError("ตอบ comment ไม่สำเร็จ — ตรวจสอบการเชื่อมต่อแล้วลองอีกครั้ง");
+      if (!reportActionError(err, "ตอบ comment ไม่สำเร็จ")) {
+        showActionError("ตอบ comment ไม่สำเร็จ — ตรวจสอบการเชื่อมต่อแล้วลองอีกครั้ง");
+      }
       return false;
     }
   }
@@ -2493,8 +2518,9 @@ export default function PDFViewer({
       await deleteReply(token, id);
       setReplies((prev) => prev.filter((r) => r.id !== id));
     } catch (err) {
-      console.error("ลบคำตอบไม่สำเร็จ", err);
-      showActionError("ลบคำตอบไม่สำเร็จ — ตรวจสอบการเชื่อมต่อแล้วลองอีกครั้ง");
+      if (!reportActionError(err, "ลบคำตอบไม่สำเร็จ")) {
+        showActionError("ลบคำตอบไม่สำเร็จ — ตรวจสอบการเชื่อมต่อแล้วลองอีกครั้ง");
+      }
     }
   }
 
@@ -2650,8 +2676,9 @@ export default function PDFViewer({
       );
       flashBookmarkSaved();
     } catch (err) {
-      console.error("บันทึก bookmark ไม่สำเร็จ", err);
-      setBookmarkError(err instanceof Error ? err.message : "บันทึกไม่สำเร็จ ลองอีกครั้ง");
+      if (!reportActionError(err, "บันทึก bookmark ไม่สำเร็จ")) {
+        setBookmarkError(err instanceof Error ? err.message : "บันทึกไม่สำเร็จ ลองอีกครั้ง");
+      }
     } finally {
       bookmarkPendingRef.current = false;
       setBookmarkSaving(false);
@@ -2676,7 +2703,7 @@ export default function PDFViewer({
         prev.some((b) => b.id === saved.id) ? prev : [...prev, saved],
       );
     } catch (err) {
-      console.error("เพิ่ม sub-bookmark ไม่สำเร็จ", err);
+      reportActionError(err, "เพิ่ม sub-bookmark ไม่สำเร็จ");
     } finally {
       bookmarkPendingRef.current = false;
     }
@@ -2692,7 +2719,7 @@ export default function PDFViewer({
       const saved = await updateBookmark(token, { id, ...patch });
       setBookmarks((prev) => prev.map((b) => (b.id === saved.id ? saved : b)));
     } catch (err) {
-      console.error("แก้ไข bookmark ไม่สำเร็จ", err);
+      reportActionError(err, "แก้ไข bookmark ไม่สำเร็จ");
     }
   }
 
@@ -2704,7 +2731,7 @@ export default function PDFViewer({
         await deleteBookmark(token, id);
         setBookmarks((prev) => prev.filter((b) => b.id !== id));
       } catch (err) {
-        console.error("ลบ bookmark ไม่สำเร็จ", err);
+        reportActionError(err, "ลบ bookmark ไม่สำเร็จ");
       }
     });
   }