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 2026-09-08 14:01:13 +07:00
parent 618328ffa7
commit 39d610a781
39 changed files with 1387 additions and 212 deletions

View file

@ -16,11 +16,13 @@ export async function uploadVersion(
clientVersionId: string,
fields?: Record<string, string>,
fileName?: string,
message?: string
message?: string,
pdf?: Blob
): Promise<UploadVersionResult> {
const form = new FormData();
form.append("file", file, fileName || `${documentId}.docx`);
form.append("clientVersionId", clientVersionId);
if (pdf) form.append("pdf", pdf, `${documentId}.pdf`);
if (fields && Object.keys(fields).length > 0) {
form.append("fields", JSON.stringify(fields));
}
@ -44,8 +46,12 @@ export async function getVersions(documentId: string): Promise<VersionRecord[]>
}
/** FR-7 — URL ของ download endpoint (ผ่าน backend proxy เท่านั้น — MinIO ไม่ถูก expose) */
export function buildDownloadUrl(documentId: string, versionId: string): string {
return `${config.apiBaseUrl}/api/documents/${documentId}/versions/${versionId}/download`;
export function buildDownloadUrl(
documentId: string,
versionId: string,
format?: "docx" | "pdf"
): string {
return `${config.apiBaseUrl}/api/documents/${documentId}/versions/${versionId}/download${format === "pdf" ? "?format=pdf" : ""}`;
}
export interface VersionDownloadLink {
@ -60,17 +66,22 @@ export interface VersionDownloadLink {
*/
export async function getDownloadLink(
documentId: string,
versionId: string
versionId: string,
format?: "docx" | "pdf"
): Promise<VersionDownloadLink> {
return apiGetJson<VersionDownloadLink>(
`/api/documents/${documentId}/versions/${versionId}/download-link`,
`/api/documents/${documentId}/versions/${versionId}/download-link${format === "pdf" ? "?format=pdf" : ""}`,
"ขอลิงก์ดาวน์โหลดไม่สำเร็จ"
);
}
/** FR-7 — ดาวน์โหลดไฟล์ของ version หนึ่งเป็น Blob (ต้องแนบ Bearer จึงต้อง fetch แทน link ตรง) */
export async function downloadVersion(documentId: string, versionId: string): Promise<Blob> {
const response = await apiFetch(buildDownloadUrl(documentId, versionId));
export async function downloadVersion(
documentId: string,
versionId: string,
format?: "docx" | "pdf"
): Promise<Blob> {
const response = await apiFetch(buildDownloadUrl(documentId, versionId, format));
if (!response.ok) {
throw new ApiError(
response.status,