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>
This commit is contained in:
Suphonchai Phoonsawat
parent
618328ffa7
commit
39d610a781
39 changed files with 1387 additions and 212 deletions
|
|
@ -10,8 +10,8 @@ namespace WordVersioning.Api.IntegrationTests;
|
|||
[Collection(IntegrationTestCollection.Name)]
|
||||
public sealed class FieldSyncTests(IntegrationTestFixture fixture)
|
||||
{
|
||||
/// <summary>สร้างเอกสารจาก template ที่ตั้งค่าแล้ว (v1 ค่า DefaultValues) — จุดตั้งต้นของทุก test ในคลาสนี้</summary>
|
||||
private async Task<(HttpClient Client, Guid DocumentId, Guid V1VersionId)> CreateTrackedDocumentAsync()
|
||||
/// <summary>สร้างเอกสารจาก template ที่ตั้งค่าแล้ว (v0 ค่า DefaultValues) — จุดตั้งต้นของทุก test ในคลาสนี้</summary>
|
||||
private async Task<(HttpClient Client, Guid DocumentId, Guid V0VersionId)> CreateTrackedDocumentAsync()
|
||||
{
|
||||
var client = fixture.CreateClient();
|
||||
var (templateId, _) = await TestFlow.CreateConfiguredTemplateAsync(client, "field sync");
|
||||
|
|
@ -20,13 +20,13 @@ public sealed class FieldSyncTests(IntegrationTestFixture fixture)
|
|||
}
|
||||
|
||||
/// <summary>AC-13 — แก้ค่าใน content control แล้ว Save & Version → latest values เปลี่ยนตาม
|
||||
/// + snapshot ของ version นั้นเก็บค่าใหม่ และ v1 snapshot ยังเก็บค่าเก่าไว้ (diff ได้)</summary>
|
||||
/// + snapshot ของ version นั้นเก็บค่าใหม่ และ v0 snapshot ยังเก็บค่าเก่าไว้ (diff ได้)</summary>
|
||||
[Fact]
|
||||
public async Task UploadWithChangedFields_UpdatesLatestValues_AndSnapshotsPerVersion()
|
||||
{
|
||||
var (client, documentId, v1VersionId) = await CreateTrackedDocumentAsync();
|
||||
var (client, documentId, v0VersionId) = await CreateTrackedDocumentAsync();
|
||||
|
||||
var v2Fields = new Dictionary<string, string>
|
||||
var v1Fields = new Dictionary<string, string>
|
||||
{
|
||||
["employee_name"] = "สมหญิง เปลี่ยนชื่อแล้ว",
|
||||
["position"] = "วิศวกรซอฟต์แวร์", // ไม่เปลี่ยน
|
||||
|
|
@ -37,37 +37,37 @@ public sealed class FieldSyncTests(IntegrationTestFixture fixture)
|
|||
$"api/documents/{documentId}/versions",
|
||||
ApiExtensions.VersionForm(
|
||||
TestDocx.BuildPlainDocx("แก้ไขใน Word"), "doc.docx", Guid.NewGuid().ToString(),
|
||||
JsonSerializer.Serialize(v2Fields)));
|
||||
JsonSerializer.Serialize(v1Fields)));
|
||||
Assert.Equal(HttpStatusCode.Created, upload.StatusCode);
|
||||
var v2 = await upload.Content.ReadFromJsonAsync<UploadVersionResult>(IntegrationTestFixture.Json);
|
||||
var v1 = await upload.Content.ReadFromJsonAsync<UploadVersionResult>(IntegrationTestFixture.Json);
|
||||
|
||||
// latest values: field ที่ "ส่งมา" ถูก update ทุกตัว (แม้ค่าเดิมไม่เปลี่ยน — ไม่มี dirty check)
|
||||
// จึงชี้ SourceVersionId = v2 ทั้งหมด; ตัวที่ "ไม่ได้ส่ง" เท่านั้นที่คง v1 (ดู test AC-14)
|
||||
// จึงชี้ SourceVersionId = v1 ทั้งหมด; ตัวที่ "ไม่ได้ส่ง" เท่านั้นที่คง v0 (ดู test AC-14)
|
||||
await using var db = fixture.CreateDb();
|
||||
var values = await db.DocumentFieldValues.AsNoTracking()
|
||||
.Where(v => v.DocumentId == documentId)
|
||||
.ToDictionaryAsync(v => v.FieldKey);
|
||||
Assert.Equal("สมหญิง เปลี่ยนชื่อแล้ว", values["employee_name"].Value);
|
||||
Assert.Equal(v2!.VersionId, values["employee_name"].SourceVersionId);
|
||||
Assert.Equal(v1!.VersionId, values["employee_name"].SourceVersionId);
|
||||
Assert.Equal("99000", values["salary"].Value);
|
||||
Assert.Equal(v2.VersionId, values["salary"].SourceVersionId);
|
||||
Assert.Equal("วิศวกรซอฟต์แวร์", values["position"].Value); // ค่าเดิมส่งมาเท่าเดิม → คงเดิมแต่ source ขยับตาม v2
|
||||
Assert.Equal(v2.VersionId, values["position"].SourceVersionId);
|
||||
Assert.Equal(v1.VersionId, values["salary"].SourceVersionId);
|
||||
Assert.Equal("วิศวกรซอฟต์แวร์", values["position"].Value); // ค่าเดิมส่งมาเท่าเดิม → คงเดิมแต่ source ขยับตาม v1
|
||||
Assert.Equal(v1.VersionId, values["position"].SourceVersionId);
|
||||
Assert.Equal(fixture.TestUserId, values["employee_name"].UpdatedByUserId);
|
||||
|
||||
// snapshot ต่อ version ผ่าน history API: v2 = ค่าใหม่, v1 = ค่าเดิม (missing=false ทั้งคู่)
|
||||
// snapshot ต่อ version ผ่าน history API: v1 = ค่าใหม่, v0 = ค่าเดิม (missing=false ทั้งคู่)
|
||||
using var history = await client.GetAsync($"api/documents/{documentId}/versions");
|
||||
var items = (await history.Content.ReadFromJsonAsync<List<VersionItem>>(IntegrationTestFixture.Json))!
|
||||
.OrderBy(i => i.VersionNumber)
|
||||
.ToList();
|
||||
|
||||
var v1Snapshot = Snapshot(items[0].Fields!.Value);
|
||||
var v2Snapshot = Snapshot(items[1].Fields!.Value);
|
||||
Assert.Equal("สมหญิง รักงาน", v1Snapshot["employee_name"].Value);
|
||||
Assert.Equal("สมหญิง เปลี่ยนชื่อแล้ว", v2Snapshot["employee_name"].Value);
|
||||
Assert.Equal("99000", v2Snapshot["salary"].Value);
|
||||
var v0Snapshot = Snapshot(items[0].Fields!.Value);
|
||||
var v1Snapshot = Snapshot(items[1].Fields!.Value);
|
||||
Assert.Equal("สมหญิง รักงาน", v0Snapshot["employee_name"].Value);
|
||||
Assert.Equal("สมหญิง เปลี่ยนชื่อแล้ว", v1Snapshot["employee_name"].Value);
|
||||
Assert.Equal("99000", v1Snapshot["salary"].Value);
|
||||
Assert.All(v0Snapshot.Values, e => Assert.False(e.Missing));
|
||||
Assert.All(v1Snapshot.Values, e => Assert.False(e.Missing));
|
||||
Assert.All(v2Snapshot.Values, e => Assert.False(e.Missing));
|
||||
}
|
||||
|
||||
/// <summary>AC-14 — ลบ content control แล้ว Save & Version: request สำเร็จ, ค่าเดิมคงอยู่ + mark missing
|
||||
|
|
@ -75,7 +75,7 @@ public sealed class FieldSyncTests(IntegrationTestFixture fixture)
|
|||
[Fact]
|
||||
public async Task UploadWithMissingFields_KeepsOldValues_MarksMissing_DoesNotFail()
|
||||
{
|
||||
var (client, documentId, v1VersionId) = await CreateTrackedDocumentAsync();
|
||||
var (client, documentId, v0VersionId) = await CreateTrackedDocumentAsync();
|
||||
|
||||
// ผู้ใช้ลบ control ของ position/salary/start_date — เหลือส่ง employee_name เท่านั้น + ส่งเกิน 1 field
|
||||
using var upload = await client.PostAsync(
|
||||
|
|
@ -87,22 +87,22 @@ public sealed class FieldSyncTests(IntegrationTestFixture fixture)
|
|||
// policy FR-11: ไม่ fail request
|
||||
Assert.Equal(HttpStatusCode.Created, upload.StatusCode);
|
||||
|
||||
// latest values ของ field ที่หาย: คงค่า v1 เดิมไว้ทั้งหมด (รวม SourceVersionId ที่ยังชี้ v1)
|
||||
// latest values ของ field ที่หาย: คงค่า v0 เดิมไว้ทั้งหมด (รวม SourceVersionId ที่ยังชี้ v0)
|
||||
await using var db = fixture.CreateDb();
|
||||
var values = await db.DocumentFieldValues.AsNoTracking()
|
||||
.Where(v => v.DocumentId == documentId)
|
||||
.ToDictionaryAsync(v => v.FieldKey);
|
||||
Assert.Equal("สมหญิง ยังอยู่", values["employee_name"].Value);
|
||||
Assert.Equal("วิศวกรซอฟต์แวร์", values["position"].Value);
|
||||
Assert.Equal(v1VersionId, values["position"].SourceVersionId); // ไม่ถูกแตะเพราะไม่ได้ส่งมา
|
||||
Assert.Equal(v0VersionId, values["position"].SourceVersionId); // ไม่ถูกแตะเพราะไม่ได้ส่งมา
|
||||
Assert.Equal("75000", values["salary"].Value);
|
||||
Assert.Equal("2026-08-01", values["start_date"].Value);
|
||||
Assert.Equal(4, values.Count); // field เกินไม่ถูกเก็บ
|
||||
|
||||
// snapshot v2: field ที่หาย missing=true พร้อมค่าเดิม, ไม่มี key ของ field เกิน
|
||||
// snapshot v1: field ที่หาย missing=true พร้อมค่าเดิม, ไม่มี key ของ field เกิน
|
||||
using var history = await client.GetAsync($"api/documents/{documentId}/versions");
|
||||
var items = await history.Content.ReadFromJsonAsync<List<VersionItem>>(IntegrationTestFixture.Json);
|
||||
var snapshot = Snapshot(items!.Single(i => i.VersionNumber == 2).Fields!.Value);
|
||||
var snapshot = Snapshot(items!.Single(i => i.VersionNumber == 1).Fields!.Value);
|
||||
|
||||
Assert.False(snapshot["employee_name"].Missing);
|
||||
Assert.True(snapshot["position"].Missing);
|
||||
|
|
@ -112,7 +112,7 @@ public sealed class FieldSyncTests(IntegrationTestFixture fixture)
|
|||
Assert.Equal(4, snapshot.Count); // ไม่มี "อะไรที่ไม่มีในนิยาม"
|
||||
}
|
||||
|
||||
/// <summary>FR-12 ผ่าน detail — หลัง sync แล้วหน้า detail ต้องเห็นค่าล่าสุด (ไม่ใช่ของ v1)</summary>
|
||||
/// <summary>FR-12 ผ่าน detail — หลัง sync แล้วหน้า detail ต้องเห็นค่าล่าสุด (ไม่ใช่ของ v0)</summary>
|
||||
[Fact]
|
||||
public async Task DetailReflectsLatestSyncedValues()
|
||||
{
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue