本卡為 FR-163 母案:專案總覽頁加「證據視圖」,兩棒(BE 補欄位 → FE 畫面),實作。子卡清單在末段(由 patch 腳本 append)。
這系列在做什麼(白話)
現在要看某條評估目標交了哪些檔,得在專案總覽點群組 → 展開控制項 → 展開評估目標 → 展開任務 → 開抽屜,四層才看到檔名。PM/顧問要盤「這個控制項證據齊不齊」「哪些評估目標一份都沒有」,只能一條條點。
做完後:專案總覽頁右上多一組「控制項視圖|證據視圖」。切到證據視圖,左邊還是那棵樹但多一層到評估目標、每個節點後面寫有幾份;右邊永遠是一張平的表,一列一份證據:型別、檔名(可預覽/下載)或連結(直接開)、掛在哪些評估目標(編號+完整名稱)、來源、上傳者、時間、所屬任務(點了開現有抽屜)。要分段再從工具列開。只看不改。
為什麼要做
- 決策者 2026-10-25 口述痛點:「我要一層一層點到 AO 才看得到檔案」。
- 雛形迭代兩輪:第一版右邊是「依控制項分段卡片、再依評估目標分段卡片」,決策者退回「分類很難看、不友善」;查業界(Drata/Vanta 證據庫、Finder/SharePoint)一致是平鋪清單+歸屬欄位,表格 UX 共識「巢狀上限兩層、不准手風琴包手風琴」,改成 D2 版(永遠一張表+「位置」欄)後核可。
關鍵設計決策(全文在 design.md)
- D1 入口在專案總覽頁本身,右上切換,不另開頁。
- D2 右邊永遠一張表、一組表頭;左樹只縮範圍。
- D3 「位置」欄:每份證據掛在哪些評估目標,編號標籤+完整名稱一個 AO 一行(決策者明示只有 obj.N 看不懂),超過三個收成「還有 N 個…」。一個檔對五個 AO 只出一列。
- D5 沒有狀態欄(不顯示已採納/待審/退回)——查過
compliance.job_evidences 沒有審核欄,FR-142 的「採用」記在稽核結果側且明寫不改任務端資料。雛形早期假資料的「缺 9 月資料,請補齊」是編的,已刪。
- D6 連結型證據(
evidence_type=LINK)當正式證據列出,標題+網址,點了開新分頁。這是既有能力,不是新東西。
- D8 左右分隔用 PrimeVue
Splitter,不自寫(決策者明示)。
- D9 不開新端點:專案總覽頁本來就一次載入整棵 control-tree(
GET /ssp/<ssp_uid>/control-tree),每個任務底下已帶 evidences[],只缺上傳者/時間/檔案 uid/大小/連結標題。BE 只補欄位。
- D10 問卷型證據第一版不列。
怎麼拆
- 批 1 / FR-163.1(BE):control-tree 每筆證據補七個欄位+nickname enrich。一支 SQL 加欄、一處 dict 加鍵、一行 enrich。小。
- 批 2 / FR-163.2(FE):切換鈕、左樹加評估目標層與份數、右欄平表(型別 chip、分段、位置欄)、Splitter、預覽/下載/開啟、所屬任務開抽屜、i18n。新子元件一支,總覽頁只掛載。中。FE 可在 .1 之前先用既有欄位開工(名稱、型別、來源、連結都已在 tree),只有上傳者/時間/預覽下載等 .1。
共同設定