Phase 9: version message (FR-13)

- ใส่คำอธิบายแบบ commit message ได้ทุก flow ที่สร้าง version (Save & Version / Start Versioning / generate จากเว็บ) + แสดงใน version history ทุกหน้า
- backend: DocumentVersion.Message (varchar 2048) + migration AddVersionMessage + BadRequest ตรวจความยาวก่อนแตะ MinIO (กัน 500 + orphan object)
- add-in: ConfirmVersionDialog เพิ่ม textarea (Start Versioning ใช้ dialog ด้วย) + แสดง message ใน VersionHistoryPanel
- web: ฟอร์มสร้างเอกสาร + หน้า detail แสดง message (desktop truncate + tooltip, mobile เต็มบรรทัด)
- sync เอกสารทั้งหมด: spec v5 (FR-13/AC-16) + plan Phase 9 + acceptance-review 1–16 + README + CLAUDE.md + web/README
- tests: backend 52 / addin 50 / web 36 — เขียวทั้งชุด

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

addin/src/services/versionFlow.test.ts

@@ -117,6 +117,20 @@ describe("startVersioning (FR-1 / AC-5)", () => {
     const { form } = parseUploadCall(fetchMock.mock.calls[0] as [string, { body?: FormData }]);
     expect(String((form.get("file") as File).name)).toMatch(/\.docx$/);
   });
+
+  it("FR-13 — ส่ง message แนบไปกับ multipart form ของ v1", async () => {
+    installWordMock({});
+    installOfficeDocumentMock(undefined);
+    const fetchMock = installFetchMock();
+    fetchMock.mockImplementationOnce(async () =>
+      mockResponse({ status: 201, body: { versionId: "v", versionNumber: 1 } })
+    );
+
+    await startVersioning("เริ่มติดตามฉบับแรก");
+
+    const { form } = parseUploadCall(fetchMock.mock.calls[0] as [string, { body?: FormData }]);
+    expect(String(form.get("message"))).toBe("เริ่มติดตามฉบับแรก");
+  });
 });
 
 describe("saveAndVersion (FR-2 / AC-7, 13)", () => {
@@ -213,4 +227,42 @@ describe("saveAndVersion (FR-2 / AC-7, 13)", () => {
       versionNumber: 2,
     });
   });
+
+  it("FR-13 — ส่ง message แนบไปกับ multipart form", async () => {
+    installWordMock({
+      properties: {
+        SavedByAddIn: ADDIN_SIGNATURE_GUID,
+        DocumentTrackingId: "11111111-1111-1111-1111-111111111111",
+      },
+    });
+    installOfficeDocumentMock(undefined);
+    const fetchMock = installFetchMock();
+    fetchMock.mockImplementationOnce(async () =>
+      mockResponse({ status: 201, body: { versionId: "backend-version-2", versionNumber: 2 } })
+    );
+
+    await saveAndVersion("11111111-1111-1111-1111-111111111111", 1, "แก้ไขสัญญาข้อ 3");
+
+    const { form } = parseUploadCall(fetchMock.mock.calls[0] as [string, { body?: FormData }]);
+    expect(String(form.get("message"))).toBe("แก้ไขสัญญาข้อ 3");
+  });
+
+  it("FR-13 — message ว่าง/whitespace ล้วน → ไม่แนบฟิลด์ message เลย", async () => {
+    installWordMock({
+      properties: {
+        SavedByAddIn: ADDIN_SIGNATURE_GUID,
+        DocumentTrackingId: "11111111-1111-1111-1111-111111111111",
+      },
+    });
+    installOfficeDocumentMock(undefined);
+    const fetchMock = installFetchMock();
+    fetchMock.mockImplementationOnce(async () =>
+      mockResponse({ status: 201, body: { versionId: "backend-version-2", versionNumber: 2 } })
+    );
+
+    await saveAndVersion("11111111-1111-1111-1111-111111111111", 1, "   ");
+
+    const { form } = parseUploadCall(fetchMock.mock.calls[0] as [string, { body?: FormData }]);
+    expect(form.get("message")).toBeNull();
+  });
 });

addin/src/services/versionFlow.ts

@@ -70,15 +70,18 @@ async function saveDocument(): Promise<void> {
 async function uploadCurrentFile(
   documentId: string,
   clientVersionId: string,
-  fields: Record<string, string>
+  fields: Record<string, string>,
+  message?: string
 ): Promise<{ versionId: string; versionNumber: number }> {
   const file = await getCurrentDocumentFile();
-  return uploadVersion(documentId, file, clientVersionId, fields, guessDocumentFileName());
+  return uploadVersion(documentId, file, clientVersionId, fields, guessDocumentFileName(), message);
 }
 
-/** FR-1 — เริ่ม track เอกสารปัจจุบัน: stamp รอบแรก + upload เป็น version 1 */
+/** FR-1 — เริ่ม track เอกสารปัจจุบัน: stamp รอบแรก + upload เป็น version 1
+ *  (FR-13: message คือ commit message ทางเลือกจาก dialog ยืนยัน) */
 export async function startVersioning(
-  onProgress?: (message: string) => void
+  message?: string,
+  onProgress?: (progress: string) => void
 ): Promise<StartVersioningResult> {
   const documentId = generateGuid();
   const clientVersionId = generateGuid();
@@ -106,15 +109,17 @@ export async function startVersioning(
 
   // 4) upload version แรก
   onProgress?.("กำลังอัปโหลด version 1…");
-  const result = await uploadCurrentFile(documentId, clientVersionId, fields);
+  const result = await uploadCurrentFile(documentId, clientVersionId, fields, message);
   return { documentId, ...result };
 }
 
-/** FR-2 — Save & Version ของเอกสารที่ track อยู่แล้ว (เรียกหลังผู้ใช้กดยืนยันใน dialog แล้ว) */
+/** FR-2 — Save & Version ของเอกสารที่ track อยู่แล้ว (เรียกหลังผู้ใช้กดยืนยันใน dialog แล้ว)
+ *  (FR-13: message คือ commit message ทางเลือกจาก dialog ยืนยัน) */
 export async function saveAndVersion(
   documentId: string,
   latestVersionNumber: number,
-  onProgress?: (message: string) => void
+  message?: string,
+  onProgress?: (progress: string) => void
 ): Promise<SaveAndVersionResult> {
   const clientVersionId = generateGuid();
   const timestamp = new Date().toISOString();
@@ -142,7 +147,7 @@ export async function saveAndVersion(
 
   // 4) upload
   onProgress?.("กำลังอัปโหลด version ใหม่…");
-  const result = await uploadCurrentFile(documentId, clientVersionId, fields);
+  const result = await uploadCurrentFile(documentId, clientVersionId, fields, message);
 
   // 5) เลขจริงจาก backend ต่างจากที่เดา (มี client อื่นแทรก) → แก้ XML part ให้ตรง (best effort)
   if (result.versionNumber !== predictedNumber) {

addin/src/services/versioningService.ts

@@ -8,13 +8,15 @@ import { generateGuid } from "./metadataService";
  * `fields` = map จาก `readContentControlFields()` ตาม FR-11
  */
 
-/** FR-5 — อัปโหลดไฟล์ปัจจุบันเป็น version ใหม่ (แนบ fields map ถ้ามี) */
+/** FR-5 — อัปโหลดไฟล์ปัจจุบันเป็น version ใหม่ (แนบ fields map ถ้ามี)
+ *  + FR-13: แนบ commit message ทางเลือกของผู้ใช้ */
 export async function uploadVersion(
   documentId: string,
   file: Blob,
   clientVersionId: string,
   fields?: Record<string, string>,
-  fileName?: string
+  fileName?: string,
+  message?: string
 ): Promise<UploadVersionResult> {
   const form = new FormData();
   form.append("file", file, fileName || `${documentId}.docx`);
@@ -22,6 +24,10 @@ export async function uploadVersion(
   if (fields && Object.keys(fields).length > 0) {
     form.append("fields", JSON.stringify(fields));
   }
+  const trimmedMessage = message?.trim();
+  if (trimmedMessage) {
+    form.append("message", trimmedMessage);
+  }
   return apiSendExpectJson<UploadVersionResult>(
     `/api/documents/${documentId}/versions`,
     { method: "POST", body: form },