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>

backend/WordVersioning.Api/Controllers/DocumentsController.cs

@@ -34,6 +34,7 @@ public class DocumentsController(
 
     private const long MaxUploadBytes = 100L * 1024 * 1024; // 100MB ตาม spec
     private const int MaxVersionInsertRetries = 5;
+    private const int MaxVersionMessageLength = 2048; // FR-13 — ตรงกับ HasMaxLength ใน AppDbContext
 
     /// <summary>FR-5 — อัปโหลด version ใหม่ (auto-create Document ถ้ายังไม่มี)
     /// + FR-11: แนบ `fields` (map tag→text) → sync latest values + snapshot ต่อ version</summary>
@@ -59,6 +60,11 @@ public class DocumentsController(
         if (!FieldMapJson.TryParse(request.Fields, out var fieldMap, out var fieldsError))
             return BadRequest(fieldsError);
 
+        // FR-13 — commit message ทางเลือก (เช็คก่อนแตะ DB/storage กัน 500 จากข้อจำกัดความยาว)
+        var message = NormalizeMessage(request.Message);
+        if (message is { Length: > MaxVersionMessageLength })
+            return BadRequest($"`message` ยาวเกิน {MaxVersionMessageLength} อักขระ");
+
         var now = DateTimeOffset.UtcNow;
         var fileName = request.File.FileName;
 
@@ -131,6 +137,7 @@ public class DocumentsController(
                 CreatedByUserId = currentUser.UserId, // จาก claim `sub` เท่านั้น
                 CreatedAt = now,
                 FieldsSnapshotJson = fieldsSnapshotJson,
+                Message = message, // FR-13
             };
             db.DocumentVersions.Add(version);
 
@@ -212,6 +219,11 @@ public class DocumentsController(
         if (!FieldMapJson.TryNormalize(request.Values, out var values, out var valuesError))
             return BadRequest($"`values` ผิด format: {valuesError}");
 
+        // FR-13 — เช็คก่อนทำ MinIO/template IO ใดๆ (กัน 500 + orphan object ใน bucket เมื่อ DB reject ทีหลัง)
+        var message = NormalizeMessage(request.Message);
+        if (message is { Length: > MaxVersionMessageLength })
+            return BadRequest($"`message` ยาวเกิน {MaxVersionMessageLength} อักขระ");
+
         // validate required + type (FR-10) — field ที่ส่งเกินนิยาม ignore ตาม policy เดียวกับ FR-11
         var missingRequired = fieldDefs
             .Where(f => f.IsRequired && (!values.TryGetValue(f.Key, out var v) || string.IsNullOrWhiteSpace(v ?? string.Empty)))
@@ -297,6 +309,7 @@ public class DocumentsController(
                 ContentHash = contentHash,
                 CreatedByUserId = currentUser.UserId,
                 CreatedAt = now,
+                Message = message, // FR-13
             };
             db.DocumentVersions.Add(version);
 
@@ -420,12 +433,13 @@ public class DocumentsController(
                 v.CreatedByUserId,
                 v.ContentHash,
                 v.FieldsSnapshotJson,
+                v.Message,
             })
             .ToListAsync(ct);
 
         return Ok(rows.Select(r => new VersionListItem(
             r.Id, r.VersionNumber, r.CreatedAt, r.CreatedByUserId, r.ContentHash,
-            ParseSnapshot(r.FieldsSnapshotJson))).ToList());
+            ParseSnapshot(r.FieldsSnapshotJson), r.Message)).ToList());
     }
 
     /// <summary>FR-7 — ดาวน์โหลด version ที่ระบุ (proxy stream จาก MinIO — ไม่ expose MinIO ตรงๆ)</summary>
@@ -535,4 +549,9 @@ public class DocumentsController(
 
     private static bool IsUniqueViolation(DbUpdateException ex) =>
         ex.InnerException is PostgresException { SqlState: PostgresErrorCodes.UniqueViolation };
+
+    /// <summary>FR-13 — normalize commit message: ว่าง/whitespace ล้วน → null, ไม่เช่นนั้น trim
+    /// (นโยบายเดียวกับ Template.Description ใน TemplatesController)</summary>
+    private static string? NormalizeMessage(string? message) =>
+        string.IsNullOrWhiteSpace(message) ? null : message.Trim();
 }