Phase 11: version PDF (FR-15)

- เลข version ใหม่: เว็บ-generate = v0 ฉบับตั้งต้น (ไม่มี PDF), add-in save (Start Versioning + Save & Version) = v1+ มี PDF เสมอ
- PDF ผลิตจาก Word จริงผ่าน task pane เท่านั้น (getFileAsync Pdf + runtime guard, manifest ไม่เพิ่ม requirement); capture/upload เป็น best-effort — docx ผ่านแม้ PDF ล้ม + MessageBar เตือนตาม hasPdf
- Backend: DocumentVersion.PdfObjectKey (nullable, migration AddVersionPdf) + sibling .pdf ใน bucket docx-versions · multipart part pdf (ผิด type → 400) · /download + /download-link รับ ?format=pdf (ไม่มี → 404) · presigned ฝังชื่อไฟล์ไทย + _vN (RFC 5987)
- Web: เปิดไฟล์แทน blob-download — PDF แท็บใหม่, docx ผ่าน ms-word:ofe|u| พร้อม heuristic fallback ลิงก์สำรอง (useVersionOpen, versionDownload) · ปุ่ม "เปิดใน Word" ที่หน้า success ของฟอร์มสร้างเอกสาร
- Spec v7 + CONTEXT.md + ADR 0001 + แผน docs/plans/version-pdf.md
- Automated QA: backend 68 / add-in 63 / web 55 ผ่าน · manual acceptance ผ่านบน Word for Mac (2026-09-08) รวม fidelity + track changes — ค้างเฉพาะ Windows / Word on the web

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

backend/WordVersioning.Api.IntegrationTests/GenerateTests.cs

@@ -6,12 +6,12 @@ using WordVersioning.Api.Services;
 namespace WordVersioning.Api.IntegrationTests;
 
 /// <summary>FR-10 — generate เอกสารจาก template: ค่าครบ + formatting รักษาไว้ + stamp custom properties
-/// + Document/v1/field values ใน flow เดียว (AC-12 ส่วน backend) + FR-12 (detail / รายการเอกสารต่อ template)</summary>
+/// + Document/v0/field values ใน flow เดียว (AC-12 ส่วน backend) + FR-12 (detail / รายการเอกสารต่อ template)</summary>
 [Collection(IntegrationTestCollection.Name)]
 public sealed class GenerateTests(IntegrationTestFixture fixture)
 {
     [Fact]
-    public async Task Generate_FillsAllFields_PreservesFormatting_StampsProperties_AndCreatesV1()
+    public async Task Generate_FillsAllFields_PreservesFormatting_StampsProperties_AndCreatesV0()
     {
         using var client = fixture.CreateClient();
         var (templateId, _) = await TestFlow.CreateConfiguredTemplateAsync(client, "generate หลัก");
@@ -19,7 +19,7 @@ public sealed class GenerateTests(IntegrationTestFixture fixture)
         var doc = await TestFlow.GenerateDocumentAsync(client, templateId);
 
         // response ครบตาม FR-10 + downloadUrl ใช้ได้ทันที
-        Assert.Equal(1, doc.VersionNumber);
+        Assert.Equal(0, doc.VersionNumber);
         Assert.Equal($"/api/documents/{doc.DocumentId}/versions/{doc.VersionId}/download", doc.DownloadUrl);
         using var download = await client.GetAsync(doc.DownloadUrl);
         Assert.Equal(HttpStatusCode.OK, download.StatusCode);
@@ -43,7 +43,7 @@ public sealed class GenerateTests(IntegrationTestFixture fixture)
         Assert.Equal(AddInMetadata.AddInSignatureGuid, TestDocx.ReadCustomProperty(fileBytes, "SavedByAddIn"));
         Assert.Equal(doc.DocumentId.ToString(), TestDocx.ReadCustomProperty(fileBytes, "DocumentTrackingId"));
 
-        // (4) สถานะใน Postgres: Document ผูก template + v1 + field values ครบ
+        // (4) สถานะใน Postgres: Document ผูก template + v0 + field values ครบ
         await using var db = fixture.CreateDb();
         var document = await db.Documents.AsNoTracking()
             .Include(d => d.Versions)
@@ -53,7 +53,7 @@ public sealed class GenerateTests(IntegrationTestFixture fixture)
         Assert.EndsWith(".docx", document.FileName);
 
         var version = Assert.Single(document.Versions);
-        Assert.Equal(1, version.VersionNumber);
+        Assert.Equal(0, version.VersionNumber);
         Assert.Equal(fixture.TestUserId, version.CreatedByUserId); // จาก claim sub เท่านั้น
 
         var fieldValues = await db.DocumentFieldValues.AsNoTracking()
@@ -109,7 +109,7 @@ public sealed class GenerateTests(IntegrationTestFixture fixture)
         };
 
         var doc = await TestFlow.GenerateDocumentAsync(client, templateId, values);
-        Assert.Equal(1, doc.VersionNumber);
+        Assert.Equal(0, doc.VersionNumber);
 
         await using var db = fixture.CreateDb();
         Assert.False(await db.DocumentFieldValues.AsNoTracking()
@@ -158,7 +158,7 @@ public sealed class GenerateTests(IntegrationTestFixture fixture)
         Assert.Null(byKey["note"].SourceVersionId);
         Assert.Equal("note", byKey["note"].Label);
 
-        // def เดิมที่ยังอยู่ (employee_name) — ค่า v1 ยังอยู่ครบ
+        // def เดิมที่ยังอยู่ (employee_name) — ค่า v0 ยังอยู่ครบ
         Assert.Equal("สมหญิง รักงาน", byKey["employee_name"].Value);
         Assert.Equal(doc.VersionId, byKey["employee_name"].SourceVersionId);
 
@@ -192,7 +192,7 @@ public sealed class GenerateTests(IntegrationTestFixture fixture)
         Assert.Equal(2, items!.Count);
         Assert.Equal(firstDoc.DocumentId, items[0].DocumentId); // ล่าสุดก่อน
         Assert.Equal(2, items[0].VersionCount);
-        Assert.Equal(2, items[0].LatestVersionNumber);
+        Assert.Equal(1, items[0].LatestVersionNumber);
         Assert.Equal(secondDoc.DocumentId, items[1].DocumentId);
         Assert.Equal(1, items[1].VersionCount);
     }