Phase 12: draft generation (FR-16)

ไฟล์ร่าง (draft) — generate docx จาก template แบบ stateless ไม่สร้าง
Document/version; stamp เฉพาะ custom property TemplateId เพื่อให้ add-in
เห็นเป็น untracked; Start Versioning ส่ง form field templateId ให้ backend
ผูก template ตอน auto-create — เอกสารเริ่มที่ v1 (ไม่มี v0) + field sync เต็มระบบ

- Backend: POST /api/templates/{id}/generate-draft (200 คืนไฟล์) +
  DocxGenerationService.GenerateDraft + แยก TemplateFieldValidation ใช้ร่วมกับ
  generate + UploadVersion รับ templateId (non-GUID/unknown → 400,
  deactivated → ผูกได้, document เดิม → เฉย) + CORS expose Content-Disposition
- Add-in: readTrackedProperties อ่าน TemplateId + ส่ง templateId เฉพาะ
  startVersioning + hint ไฟล์ร่างใน task pane
- Web: ปุ่ม "สร้างไฟล์ร่าง" บนฟอร์มเดิม + downloadFile รับ init (POST → blob)
- Docs: spec v8 (FR-16, AC-19) + Phase 12 + CONTEXT.md + ADR 0002 +
  acceptance-review AC-19
- Tests: backend 82 / add-in 66 / web 59 + build ครบ; QA reviewer PASS
  (2 rounds); ค้าง manual บน Word จริง

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

backend/WordVersioning.Api/Controllers/TemplatesController.cs

@@ -305,6 +305,74 @@ public class TemplatesController(
         return Ok(new ReplaceTemplateFileResponse(template.Id, FieldDtos(template), addedTags, removedTags));
     }
 
+    /// <summary>FR-16 — ไฟล์ร่าง (draft): generate docx จาก template แบบ stateless — ไม่สร้าง
+    /// Document/DocumentVersion/DocumentFieldValue และไม่เขียน MinIO; คืนไฟล์ทันที
+    /// (ผู้ใช้เปิดใน Word แล้วกด Start Versioning เพื่อเริ่ม track เป็น v1 พร้อมผูกกลับมาที่ template นี้)</summary>
+    [HttpPost("{id:guid}/generate-draft")]
+    [ProducesResponseType(typeof(FileContentResult), StatusCodes.Status200OK)]
+    [ProducesResponseType(StatusCodes.Status400BadRequest)]
+    [ProducesResponseType(StatusCodes.Status404NotFound)]
+    [ProducesResponseType(StatusCodes.Status502BadGateway)]
+    public async Task<IActionResult> GenerateDraft(Guid id, [FromBody] GenerateDraftRequest request, CancellationToken ct)
+    {
+        var template = await db.Templates.AsNoTracking()
+            .FirstOrDefaultAsync(t => t.Id == id, ct);
+        if (template is null)
+            return NotFound($"ไม่พบ template {id}");
+        if (!template.IsActive)
+            return BadRequest("template นี้ถูก deactivate แล้ว — สร้างเอกสารใหม่ไม่ได้ (เอกสารที่สร้างไว้แล้วยังใช้ได้)");
+
+        var fieldDefs = await db.TemplateFields.AsNoTracking()
+            .Where(f => f.TemplateId == template.Id)
+            .OrderBy(f => f.SortOrder)
+            .ToListAsync(ct);
+
+        if (!FieldMapJson.TryNormalize(request.Values, out var values, out var valuesError))
+            return BadRequest($"`values` ผิด format: {valuesError}");
+
+        // validate required + type ชุดเดียวกับ generate (FR-10) — ไฟล์ร่างไม่มี message เพราะไม่เกิด version
+        var validationError = TemplateFieldValidation.Validate(fieldDefs, values);
+        if (validationError is not null)
+            return BadRequest(validationError);
+
+        Stream templateStream;
+        try
+        {
+            templateStream = await storage.GetStreamAsync(minioOptions.Value.TemplatesBucket, template.ObjectKey, ct);
+        }
+        catch (KeyNotFoundException)
+        {
+            logger.LogError("Template object missing in storage templateId={TemplateId} key={ObjectKey}",
+                template.Id, template.ObjectKey);
+            return StatusCode(StatusCodes.Status502BadGateway, "ไฟล์ template ไม่พบใน storage");
+        }
+
+        byte[] fileBytes;
+        try
+        {
+            await using (templateStream)
+            {
+                // null (JSON null) มองเป็นค่าว่าง — field "หาย" คือไม่มี key ใน map เท่านั้น (เหมือน Generate)
+                fileBytes = docxGeneration.GenerateDraft(
+                    templateStream,
+                    values.ToDictionary(kv => kv.Key, kv => kv.Value ?? string.Empty),
+                    template.Id);
+            }
+        }
+        catch (OpenXmlPackageException ex)
+        {
+            logger.LogError(ex, "Template file corrupt templateId={TemplateId} key={ObjectKey}",
+                template.Id, template.ObjectKey);
+            return StatusCode(StatusCodes.Status502BadGateway, "ไฟล์ template เสียหาย (เปิดด้วย OpenXML ไม่ได้)");
+        }
+
+        logger.LogInformation("Draft generated templateId={TemplateId} userId={UserId} bytes={Size}",
+            template.Id, currentUser.UserId, fileBytes.Length);
+
+        return File(fileBytes, DocxUploadValidation.DocxContentType,
+            DocxGenerationService.BuildGeneratedFileName(template.Name, DateTimeOffset.UtcNow));
+    }
+
     /// <summary>deactivate (soft-delete) — document เก่าที่อ้างอยู่ยังใช้ได้ต่อ แต่สร้างเอกสารใหม่ไม่ได้</summary>
     [HttpDelete("{id:guid}")]
     [ProducesResponseType(StatusCodes.Status204NoContent)]