# FR-031 證據分類分析結果報表 — 收尾 SUMMARY

| 項目 | 內容 |
|------|------|
| 日期 | 2026-05-31 |
| Branch | `feature/ai-analysis-result-landing`（BE + FE 同名）|
| 範圍 | BE（DDD 持久層 + 報表計算 + API）+ FE（2 報表頁 + 跨批總表 + DEV_MODE），跨 2 repo；jedi-* 不動 |
| 狀態 | 全數 commit，working tree 乾淨；**尚未 push、未 merge main**（等 user）|

## 一、做了什麼（六大塊）
1. **run 落 DB**：`compliance.evidence_classification_runs`（JSONB 鏡像 report_original/state + container_log）；既有 service 旁路寫 DB、舊 run lazy 回填。
2. **報告①驗證報表**（量化）+ **報告②各AO誰對誰錯**（CANON 質化）：純函式 builder 移植 `validate.py`/`gen_ao_adjudication.py`，砍 crosswalk。
3. **正解匯入 (Option B)**：`..._ground_truth` 表 + `POST /classification-ground-truth`；報告①②③ 都用匯入正解當 User 側（亞航 63 檔 seed tenant 102）。
4. **跨批總表**（歷史分類紀錄分析）：`summary_builder` + `get_runs_summary` + Dialog。
5. **FE 2 報表頁照外部 script HTML 1:1 重刻** + 字級放大兩階 + 文案/預設調整（拿掉「產生 JSON」、信心預設 0.7）。
6. **DEV_MODE 開關**：`VITE_DEV_MODE` gate 5 個 dev/admin-only 功能。

## 二、Commits

**BE（`compliance-manager-be`）**
```
b1646021 migration  8003b5ff Phase1持久層  ac7be2fc Phase2旁路寫DB  d60c30d5 Phase3共用工具
d4551c73 Phase4報告①  128b986f Phase5報告②  efe344b3 Phase6 API  b4ad91e7 正解匯入
791ef3bb 報告①對齊  9d49b949 報告②同源修正  a645962a 跨批總表  21c7e720 規格對齊
+ 本次收尾 commit（changelog ×3 / memory / frontend-overview / SUMMARY）
```

**FE（`compliance-manager-fe`）**
```
8e0622d flag  b72e513 Phase7 2頁+入口  2686a8c 需關注段  a45b84b 對齊完整度
df1b7a2 驗證頁版面  66cb875 報告②版面+字級  efe9413 字級再放大  b93172b 跨批總表
caa77e8 修ＵＩ build  dec3d73 DEV_MODE  e9c8f3c 文案/預設0.7
```

## 三、行為差異（對 user）
- 跑完分類 → 結果自動進 DB；審閱頁 + Dialog 多「驗證報表 / 各AO誰對誰錯 / 歷史分類紀錄分析」入口（DEV_MODE 開時）。
- 報表用匯入正解當基準 → 即使未審閱也是完整版；報告② 抓出 User 自己誤放（亞航 30 格）。
- STG/PRD build 這些功能自動隱藏。

## 四、規範文件
| 文件 | 狀態 |
|------|------|
| `docs/changelog/2026-05-31-feat-evidence-classify-{analysis-reports,ground-truth-import,dev-mode}.md` | ✅ ×3 |
| `design.md §13 Reconciliation` | ✅ |
| `api-spec.md §8-10 + error codes + v0 註` | ✅ |
| `implementation-plan.md` 追加註 | ✅ |
| `frontend-overview.md` 報表頁 + DEV_MODE | ✅ |
| memory `feedback_*` ×3 + `project_evidence_classify_reports_shipped` | ✅ |
| conversation-history | ⏳（extract 待做）|

## 五、部署 handover
| 改動 | 動作 |
|------|------|
| DB（runs + ground_truth 兩表） | **套 migration**（DEV 已套；STG/POC 待套）+ 灌各 tenant 正解 |
| BE（持久層 + 報表 API + summary） | **重啟 BE** |
| FE（報表頁 + Dialog + DEV_MODE） | **rebuild**；STG/PRD 確認 `VITE_DEV_MODE=false` |

## 六、已知 follow-up
1. FE 正解上傳 UI（目前只 API + 手動 seed）。
2. 動態正解（user 審閱後自動成正解）。
3. 報表頁 router guard（DEV off 直接打 URL redirect）。
4. E2E 測試（compliance-manager-test）。
5. 多框架（這階段只 cmmc-l1）。