feat(docver): derive docId from fid claim and drop [docId] URL segment

- docId of every docver operation now comes from the Bearer token: the fid
  claim (e-Court fileId) is used directly as docId; segment [docId] removed
  from URLs — POST/GET /api/documents/versions and
  GET /api/documents/versions/{versionId}/download-link
- fid is required and must be a string (trim 1-200): token issuance rejects
  missing/blank/non-string fid with 400, verify rejects fid-less tokens with 401
- parseDocId removed from lib/document-versioning.ts (dead code, no callers)
- openapi spec: paths renamed, docId path params removed, fid required + string
- PLAN-DOCVER.md / CLAUDE.md / wordaddin versioningService comment updated
- tests: fid required/string cases added, parseDocId describe removed (256 pass)

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

lib/openapi.ts

@@ -42,7 +42,8 @@ export const openApiSpec = {
         "version เก็บ .docx + .pdf ใน MinIO พร้อมผู้อัปโหลด — auth ด้วย access_token " +
         "ของกลุ่มนี้: ขอที่ POST /api/documents/token (ยืนยัน x-api-key กับ env " +
         "DOCVER_API_KEY) แล้วแนบ Authorization: Bearer ทุก request — identity/template " +
-        "แกะจาก claims ของ token ไม่รับใน multipart form อีก",
+        "และ docId (= fid — fileId ของ e-Court, string) แกะจาก claims ของ token ทั้งหมด " +
+        "ไม่รับจาก URL/multipart form อีก",
     },
     {
       name: "Judge's Note",
@@ -262,8 +263,9 @@ export const openApiSpec = {
         description:
           "ออก access_token ใช้กับ endpoint อื่นของกลุ่ม documents เท่านั้น — token เป็น " +
           "JWT HS256 ฝัง claims {userid, username, fid, template} ตามที่ส่งมา อายุตาม env " +
-          "DOCVER_TOKEN_TTL_SECONDS (default 3600 วินาที) · identity (userId/userName) " +
-          "และ templateId ตอนอัปโหลด version แกะจาก claims ของ token นี้",
+          "DOCVER_TOKEN_TTL_SECONDS (default 3600 วินาที) · identity (userId/userName), " +
+          "templateId และ docId (= fid) ตอนทำงานแกะจาก claims ของ token นี้ — " +
+          "fid จึงบังคับ",
         security: [{ ApiKeyAuth: [] }],
         requestBody: {
           required: true,
@@ -275,12 +277,12 @@ export const openApiSpec = {
                   value: {
                     userid: "123",
                     username: "Sorawit Bholsithi",
-                    fid: 3,
+                    fid: "3",
                     template: "T12",
                   },
                 },
-                "ขั้นต่ำ (fid/template เป็นทางเลือก)": {
-                  value: { userid: "123", username: "Sorawit Bholsithi" },
+                "ขั้นต่ำ (template เป็นทางเลือก)": {
+                  value: { userid: "123", username: "Sorawit Bholsithi", fid: "3" },
                 },
               },
             },
@@ -308,27 +310,18 @@ export const openApiSpec = {
         },
       },
     },
-    "/api/documents/{docId}/versions": {
+    "/api/documents/versions": {
       post: {
         tags: ["documents"],
         summary: "อัปโหลด version ใหม่ของเอกสาร (docx + pdf)",
         description:
-          "สร้างเอกสารอัตโนมัติเมื่อ docId ยังไม่เคยมี (docId ห้ามซ้ำ) แล้วเก็บไฟล์ " +
-          ".docx (+ .pdf ถ้าแนบมา) ลง MinIO พร้อมผู้อัปโหลด — versionNumber ที่ server จ่าย " +
-          "คือค่าจริงเสมอ (client ที่เลขไม่ตรงต้องแก้ XML part ของตัวเอง) · pdf เป็น " +
-          "optional: ไม่แนบ/ไฟล์เปล่า = version นี้ไม่มีสำเนา PDF (ดู hasPdf ใน response) · " +
-          "ผู้อัปโหลด (userId/userName) และ templateId แกะจาก Bearer token ไม่รับใน form " +
-          "(ส่ง field เหล่านั้นมา = 400)",
+          "เอกสารถูกระบุด้วย fid ใน Bearer token (docId = fid) — สร้างเอกสาร " +
+          "อัตโนมัติเมื่อ docId ยังไม่เคยมี แล้วเก็บไฟล์ .docx (+ .pdf ถ้าแนบมา) ลง MinIO " +
+          "พร้อมผู้อัปโหลด — versionNumber ที่ server จ่ายคือค่าจริงเสมอ (client ที่เลขไม่ตรง " +
+          "ต้องแก้ XML part ของตัวเอง) · pdf เป็น optional: ไม่แนบ/ไฟล์เปล่า = version นี้ไม่มี " +
+          "สำเนา PDF (ดู hasPdf ใน response) · ผู้อัปโหลด (userId/userName) และ templateId " +
+          "แกะจาก Bearer token ไม่รับใน form (ส่ง field เหล่านั้นมา = 400)",
         security: [{ DocverBearer: [] }],
-        parameters: [
-          {
-            name: "docId",
-            in: "path",
-            required: true,
-            schema: { type: "string" },
-            description: "รหัสเอกสารจากผู้เรียก (add-in GUID / รหัส e-Court) — [A-Za-z0-9._:-]",
-          },
-        ],
         requestBody: {
           required: true,
           content: {
@@ -397,18 +390,10 @@ export const openApiSpec = {
         tags: ["documents"],
         summary: "รายการ version ทั้งหมดของเอกสาร (ใหม่ → เก่า)",
         description:
-          "version ทุกตัวของ docId นี้ พร้อมผู้อัปโหลด (userId/userName), เวลา, commit " +
-          "message, ค่า fields และ hasPdf — ใช้เขียน UI version history ของ add-in",
+          "เอกสารถูกระบุด้วย fid ใน Bearer token (docId = fid) — version ทุกตัว " +
+          "ของเอกสารนั้น พร้อมผู้อัปโหลด (userId/userName), เวลา, commit message, ค่า fields " +
+          "และ hasPdf — ใช้เขียน UI version history ของ add-in",
         security: [{ DocverBearer: [] }],
-        parameters: [
-          {
-            name: "docId",
-            in: "path",
-            required: true,
-            schema: { type: "string" },
-            description: "รหัสเอกสารจากผู้เรียก — [A-Za-z0-9._:-]",
-          },
-        ],
         responses: {
           200: {
             description: "รายการ version เรียงใหม่ → เก่า",
@@ -435,23 +420,17 @@ export const openApiSpec = {
         },
       },
     },
-    "/api/documents/{docId}/versions/{versionId}/download-link": {
+    "/api/documents/versions/{versionId}/download-link": {
       get: {
         tags: ["documents"],
         summary: "ขอ presigned URL ดาวน์โหลดไฟล์ของ version (docx/pdf)",
         description:
-          "คืน URL อายุสั้น (env DOCVER_LINK_TTL_SECONDS, default 900 วินาที) ให้เปิดใน " +
-          "เบราว์เซอร์/Word ของผู้ใช้ — URL อ้าง endpoint MinIO ตรง ๆ จึงต้องเป็นโฮสต์ที่ " +
-          "ผู้ใช้เข้าถึงได้ · ขอ pdf ใน version ที่ไม่มีสำเนา = 404",
+          "เอกสารถูกระบุด้วย fid ใน Bearer token (docId = fid) · คืน URL อายุสั้น " +
+          "(env DOCVER_LINK_TTL_SECONDS, default 900 วินาที) ให้เปิดในเบราว์เซอร์/Word ของ " +
+          "ผู้ใช้ — URL อ้าง endpoint MinIO ตรง ๆ จึงต้องเป็นโฮสต์ที่ผู้ใช้เข้าถึงได้ · ขอ pdf " +
+          "ใน version ที่ไม่มีสำเนา = 404",
         security: [{ DocverBearer: [] }],
         parameters: [
-          {
-            name: "docId",
-            in: "path",
-            required: true,
-            schema: { type: "string" },
-            description: "รหัสเอกสาร (ต้องตรงกับ version นี้ — โยน id ข้ามเอกสารไม่ได้)",
-          },
           {
             name: "versionId",
             in: "path",
@@ -552,15 +531,14 @@ export const openApiSpec = {
       TokenRequest: {
         type: "object",
         description: "claims ที่จะฝังใน access_token ของกลุ่ม documents — key อื่น = 400",
-        required: ["userid", "username"],
+        required: ["userid", "username", "fid"],
         properties: {
           userid: { type: "string", description: "รหัสผู้ใช้ (บังคับ, ≤ 100 ตัวอักษร)" },
           username: { type: "string", description: "ชื่อผู้ใช้ (บังคับ, ≤ 200 ตัวอักษร)" },
           fid: {
-            type: "integer",
-            nullable: true,
+            type: "string",
             description:
-              "fileId ของ e-Court — เก็บเป็น claim ไว้ก่อน ยังไม่ถูก operation ของ docver อ่าน",
+              "fileId ของ e-Court (บังคับ, ≤ 200 ตัวอักษร) — เป็น docId ของทุก operation ตรง ๆ",
           },
           template: {
             type: "string",