# B1 開工 Prompt
> 日期：2026-05-22
> 用途：B1 session 開工時貼入

---

```
你正在接手 SSP 匯入匯出 Phase 2 — Track B，從 B1（Docx 樣板 + Generator 骨架）開始。

## 背景

Track A（Excel 匯入）全部完成，jedi-oscal 0.0.17 已發版。
請先讀：
1. docs/features/FR-011.2-2605-ssp-import-export-phase2/README.md（phase tracker）
2. docs/features/FR-011.2-2605-ssp-import-export-phase2/handoff/2026-05-21-b-phase-analysis.md（B 階段前置分析）

## 已確認的架構決策

- **D1 LibreOffice**：server 已安裝，現有 PDF 轉換在用 ✅
- **D2 中間層**：B2 使用 `SspExportDataModel` dataclass（主專案 domain layer）✅
- **D3 Generator**：使用 **docxtpl**（Jinja2-in-Word .docx 模板），不用純 python-docx code ✅
  - 原因：樣板會頻繁變動（樣式、章節、客製化），docxtpl 讓非工程師可直接在 Word 更新模板
  - 匯出 docx **不設計成 round-trip 匯入格式**，優先做可讀交付物
- **PDF/ODT**：LibreOffice headless subprocess（B4 phase）

## B1 目標（本 session）

1. **分析 CMMC reference docx 章節結構**
   - 用 python-docx 讀 `docs/features/FR-011.2-2605-ssp-import-export-phase2/reference/ASIA-CMMC-SSP-DRAFT-with-user-info-202604.docx`
   - dump 所有 Heading + 大標題，確認最終章節架構

2. **安裝 docxtpl 依賴**
   - `pyproject.toml` 加 `docxtpl`

3. **建立 SSP docxtpl 模板** (`app/oscal/templates/ssp/ssp_cmmc_template.docx`)
   - 從 reference docx 提取章節結構
   - 加入 Jinja2 變數標籤（`{{ system_name }}`、`{%tr for ctrl in controls %}`等）
   - 章節對應 OSCAL 區塊：metadata / parties / system-implementation / control-implementation / back-matter

4. **建 SspDocxGenerator 骨架**（`app/oscal/service/export/ssp_docx_generator.py`）
   - 接受 `SspExportDataModel`（B2 定義，B1 先用 stub dataclass）
   - 用 docxtpl render → 回傳 `BytesIO`
   - 驗收：可產出空殼 docx（有封面/章節框架，data 用假資料）

## 注意事項

- DDD 規範：Generator 放 app layer（`app/oscal/service/export/`）
- `SspExportDataModel` B1 先用簡單 stub（只有 title + system_name + controls=[]），B2 再補完整
- docxtpl 依賴要加到 pyproject.toml，讓使用者 `poetry update` 後生效
- jedi-oscal 本 phase 暫不動（docxtpl 是主專案 app layer 的事）

## 參考路徑

- Reference docx：`docs/features/FR-011.2-2605-ssp-import-export-phase2/reference/ASIA-CMMC-SSP-DRAFT-with-user-info-202604.docx`
- 同目錄還有 `ASIA-CMMC-SSP-DRAFT-202604.docx`（無 user-info 版本，可對照）
- 既有 system-design DOCX 生成參考（python-docx 模式）：`docs/system-design/scripts/generate_*.py`
- 現有 OSCAL service 路徑：`app/oscal/service/`
```