↑ 需求首頁 ⌂ 需求中心

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

一、做了什麼（六大塊）

  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 功能。
§2

二、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
§3

三、行為差異（對 user）

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

四、規範文件

文件 狀態
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 待做）
§5

五、部署 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
§6

六、已知 follow-up

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