--- title: FR-163 專案總覽證據視角——收口 SUMMARY date: 2026-10-25 --- # FR-163 專案總覽證據視角——收口 SUMMARY（2026-10-25） ## 一句話 專案總覽頁左側導航標題列多一組「控制項視角｜證據視角」；切到證據視角，左樹展到評估目標、右邊一張平的證據表，不用再點四層才看到檔名。從決策者口述到收口同一天完成。 ## 為何做 決策者 2026-10-25 口述：「我要一層一層點到 AO 才看得到檔案」。要盤「這個控制項證據齊不齊」「哪些評估目標一份都沒有」只能一條條點。 ## 做出來的行為（終局） - **入口**：左欄「控制項導航」標題列右側的 segmented 切換；選擇依專案記在瀏覽器 localStorage。 - **左樹**：同款標題列＋搜尋；群組→控制項→評估目標，排法對齊控制項視角（代號與份數一行、名稱另起一行最多兩行）；評估目標列 `obj.N` 編號＋完整名稱（換行不截斷）；每節點去重後的證據份數，0 份紅字。點任一層只縮右表範圍。 - **右表**：四欄——型別、證據（檔名＋大小；第二行來源 Tag · 上傳者 · 日期）、位置（第一行「N 個控制項 · N 個評估目標」，下面最多兩行 `obj.N`＋名稱，超過收「還有 N 個…」tooltip；評估目標範圍隱藏）、操作（檔案預覽／下載／開任務，連結開啟／開任務）。型別 chip 全部｜檔案｜連結；分段 不分段｜依控制項｜依評估目標，分段列浮在卡片上（控制項段淡主色、評估目標段浮層色；2026-10-26 隨 FR-164 追修，FE `a1e8bb43`），無證據的評估目標列「尚無證據」。 - **資料**：全部來自既有 `GET /ssp/{sspUid}/control-tree`，不另開端點。同一個檔掛多個評估目標以 `file_uid` 去重（連結以 `reference_url`）。切換時先畫讀取狀態再攤平；不分段時 DataTable 虛擬捲動。 - **只看不改**：加檔／改連結回任務抽屜。沒有採納／退回狀態欄（系統無此概念）。 ## Commits **BE `feature/FR-139`**（合回 `16ca9cb1d`，工作坊 17） | hash | 內容 | |---|---| | `7ed7de2bf` | design／D2 雛形／開卡 CM-3083～3085／登記表 | | `b39d4c70a` | 開卡腳本改 Repo 欄已存在；Notion 加「Repo」select、workshop.toml 加 `[repos]`（走 agent-workshop API） | | `8ded42389` | **FR-163.1**：control-tree 每筆證據補 `uid`／`description`／`file_uid`／`file_size`／`created_user`／`created_at`＋`created_user_name` enrich（3 檔 13+/3−） | | `c05983323` | 追加卡 CM-3087～3089 開卡腳本 | | `abf35224b` | 追加卡 CM-3090 開卡腳本 | **FE `feature/FR-139`**（合回 `a68ae07f` 工作坊 17、`781cb090` 工作坊 19） | hash | 內容 | |---|---| | `d0d48634`＋`41d73941` | **FR-163.2**：證據視角本體——`evidence-view/` 七支新檔，總覽頁 +10 行掛載；截圖 | | `4b998d0b` | **FR-163.3**：切換鈕從頁首動作列搬到 master-detail 區上方 | | `cb8d9f1c` | **FR-163.4**：攤平延後一格先畫讀取狀態；不分段時虛擬捲動（分段 rowGroupMode 不能並用） | | `a3835c52` | **FR-163.5**：八欄縮四欄、證據格兩行、位置欄數量優先、任務移進操作欄 | | `8b6e2594` | **FR-163.6**（首腦直改）：切換鈕併進左欄標題列，證據視角補同款標題列，`v-model:view-mode` 透傳；左 Splitter 24%→27% | | `f2561b64` | 直改：左樹箭頭點了沒反應——模板 `toggle(expandedControls, …)` 被 Vue 自動拆 ref 成 Set | | `100974a9` | 直改：評估目標列補 `obj.N` 編號 | | `080b1cc9` | 直改：評估目標名稱完整換行 | | `9380b670` | 直改：導航排法對齊控制項視角（名稱另起一行、字級一致） | | `189017cd` | 直改：分段列底色改 `--bg-base`＋細線；colspan 用 `:pt` 給實際欄數（PrimeVue 寫死欄數−1） | **未 push**（兩 repo 都在 `feature/FR-139`；BE ahead 17、FE ahead 23，含其他 FR 的 commit）。 ## 卡片 母卡 CM-3083 Done；子卡 CM-3084～3085、3087～3090 全 Done（工作坊 17、19 各 `finish` 合回並結案；3090 首腦直改後由決策者實看核可）。 ## 決策軌跡（含被推翻的） | 決策 | 結果 | |---|---| | D 版「右邊依控制項分段卡片再依評估目標分段卡片」 | **推翻**——決策者實看「很難看、不友善」；查業界（Drata／Vanta 證據庫平鋪＋歸屬欄位；表格 UX 巢狀上限兩層）改 D2「永遠一張表＋位置欄」 | | 雛形假資料「退回原因：缺 9 月資料」 | **刪除**——決策者問「這哪來的」；查證 `job_evidences` 無審核欄、FR-142「採用」在稽核結果側，畫面不設狀態欄 | | 分隔線雛形用純 JS | 產品一律 PrimeVue `Splitter`（決策者「有現成的就不要自己硬用」） | | 去重鍵用 `uid`（卡上寫的） | **runner 抓到卡片寫錯**：DEV 4,194 筆 uid 對 380 個實際檔案，改 `file_uid` | | 切換鈕放頁首動作列（.3 放 master-detail 上方） | 決策者兩度退回：「放到下面」→「跟導航合併，放那邊突兀」→ 併進標題列（.6） | | 「可以有讀取畫面嗎」 | 單加 spinner 沒用（同步攤平佔住主執行緒），改延後一格＋虛擬捲動 | | 「時間跟上傳者合併」 | 不只合併——右半四欄每列相同卻各佔固定寬，整列重排成四欄 | | 7 棵手刻導航樹收斂成共用元件 | **決策者裁「之後再做，現在改風險太大，不是主軸」**（見 follow-up） | ## 驗收後五筆直改的根因（給下次開卡） 1. **箭頭展不開**：`@click.stop="toggle(expandedControls, id)"`——`