# FR-043 稽核計畫 docx 匯入 — 實作收尾 SUMMARY

> Date: 2026-07-02 · Branch `feature/FR-043`（BE + FE，皆**未 push**）· 狀態：修正待驗證（user 已手測通過）

## 1. 一句話

上傳顧問稽核報告 docx → 解析章節預填成行程 → 預覽 / 修改 / 確認 → append 進 AP（走既有
`set_tasks` / `add_ap_party`），本期支援亞航 CMMC L1 v1 格式、架構以 adapter registry 可擴充。

## 2. Commits

### BE（`compliance-manager-be`，18 commits）
| commit | 內容 |
|---|---|
| `d3613fb` | 設計規格 + 前置研究分析 |
| `36386f61` | 執行交接 handoff prompt |
| `bb9e24f` | `ap_docx_parse_jobs` 表 migration（RLS + GRANT cm_app）|
| `d4eb611` | parse job entity/model/mapper/repo/domain service |
| `ee13bfc6` | DI wire parse-job + `upload_file_container` 進 GrcContainer |
| `42130222` | parser adapter registry + 亞航 CMMC L1 v1（TDD）|
| `ce374519` | error codes + gate helper 提 public（auditor/participant 兩版）|
| `4afce6f8` | `ApDocxImportAppService`（parse/preview/confirm，append + party 配對 + participants）|
| `126ed3c8` | route + app service DI wiring |
| `3c5ae596` | **fix** 補 `org_unit_id` 欄位（TenantScopedMixinModel 多租戶需要）|
| `45b129d3` / `5722bfef` | **refactor** 行程改 1..N 清單（`ParsedApTask[]` + `suggested_tasks`）|
| `53911111` / `fd92d197` | **fix** §6 逐子點分流（6.3 拆句進指引、6.1+6.2 進 methodology_text）|
| `eb4b728f` / `afaa82d3` | **fix** title 行程化 + timing 帶開始時間 + orphan 併入 methodology |
| `88a8bf51` / `a163e34c` | **feat** 查核控制項預設全選 |

### FE（`compliance-manager-fe`，4 commits）
| commit | 內容 |
|---|---|
| `22288c7` | ap-authoring 對話框 wizard（三步）|
| `529638d` | **refactor** 預覽改多筆行程卡清單（對齊 BE suggested_tasks）|
| `c854623` | 參考資訊新增稽核方法論區塊（對齊 BE methodology_text）|
| `2f95f34` | **fix** 匯入成功後全量重整 ap-authoring 清單（顯示 loading）|

## 3. 改動範圍

- **BE 新增**：`oscal.ap_docx_parse_jobs` 表 + DDD 資料層（grc 模組）；`app/grc/service/ap_report_parser/`
  （base/registry/亞航 adapter）；`app/grc/service/ap_docx_import_app_service.py`；
  `api/project/routes/ap_docx_import_route.py` + serializer；`GRC_400090/091` error code
- **BE 修改**：`AssessmentPlanAppService`（gate 提 public ×2 + `get_ap_tasks_as_task_items`）；
  grc / root DI container（parse-job + registry + app service + upload_file_container）
- **FE**：`ApDocxImportDialog.vue` + `useApDocxDraft.js` + `ApDocxImportService.js` + api.js；
  `RoundApAuthoringView.vue` 入口 + 重整；i18n

## 4. 行為差異

ap-authoring 頁（audit_planning + manager/auditor + AP 已存在）多「匯入稽核計畫」按鈕。上傳亞航樣本 →
預覽：標題「CMMC 2.0 Level 1內部稽核」/ 日期 `2026-06-02 10:00` / 方法 4 項各帶專屬指引 /
控制項預設全選 / 參考資訊三塊（依據/目的/方法論，附進備註預設勾）/ 稽核人員配對「鈊安資安顧問」→
確認 → 行程 append、參與人員入 parties、受評控制項/受評對象 tab 推導回填。既有手動流程不變。

## 5. 規範文件清單

- ✅ 設計規格 `design.md`（含 §3 五輪實測回饋更新規則）
- ✅ 前置研究 `docs/analysis/2026-07-02-ap-docx-import-oscal-mapping.md`
- ✅ 實作計畫 `implementation-plan.md`
- ✅ changelog `docs/changelog/2026-07-02-feat-fr043-ap-docx-import.md`
- ✅ 本 SUMMARY
- ✅ memory：`feedback_tenant_scoped_table_needs_org_unit_id`、`feedback_date_only_utc_midnight_display_bug`

## 6. 已知 follow-up

- **SQL migration STG / POC / PROD 待套**：`2026-07-02-ap-docx-parse-jobs.sql` +
  `2026-07-02-ap-docx-parse-jobs-add-org-unit-id.sql`（DEV 已套）
- **e2e 測試待補**（compliance-manager-test repo）：上傳→預覽改欄位→確認→行程出現在列表
- **BE + FE 皆未 push**：等 user 明示
- 既有 bug `GRC_DOCX_FILE_TOO_LARGE`（GRC_400006）訊息寫 10MB 與常數 20MB 不符 —— 非本 FR、另記

## 7. 部署 handover

- BE 無 hot reload → 部署重啟；FE 重新 build。
- 完成定義已達：BE pytest 49 綠 + 手動 smoke 通過（user 已驗 title/timing/指引/控制項全選/重整）。