FR-161 事前資料區 — LOG

append-only。每棒一段：commits、決策、教訓、推翻了什麼。

commits：6481c94cf（討論稿＋三頁雛形）→ 8f4b417ef（收斂：不做審閱、四類全當附件）→ 02a8e07e0（公司＝租戶、附件照大類）→ c3eb83cd0（不多開 tab、大類進系統設定）→ 27905d986（大類表格）→ 47de0e291（拿掉「目前整理」）→ 8a31bdd77（頁首只留公司、同名詢問）→ abcb8b13b（design.md）→ 本次（開卡）。

決策者裁示的順序（每條都推翻了首腦前一版）：

1. 另開介面，客戶不進 SSP 畫面。
2. 掛資源庫，但同公司其他框架要能引用 → 檔案存公司層。
3. 「顧問再挑一次多一道工」→ 預設全部帶入，只有反向排除。
4. 四類都是附件，不分落點。
5. 進稽核才鎖，導入期間持續更新（首腦原寫「送審凍結」被讀成整區鎖，改白話重寫）。
6. 不做顧問審閱、留言、通知（首腦先建議全砍、被要求分析，提「輕量確認」，決策者仍裁不做）。
7. 大類跟著公司（不跟著系統）。
8. 不多開 tab，只重新設計程序書池；大類進系統設定、用表格。
9. 拿掉「目前整理」（會搞混）、頁首雛形註解、顧問、總數、提示條；改用上傳同名詢問。
10. 說明欄、zip 下載保留；同意 D9 動 jedi-compliance-audit。

探脈中查到、寫進 design 的事實：

• 送審凍結、存版、還原、複製資源庫四條複製路徑都只複製程序書池列 → D9 必須落列。
• common/authz/ssp.py 的 before_template_write 是空的：FR-139 D19 稽核中鎖資源庫沒落地 → 開 CM-3047。
• OSCAL 匯出 back-matter 只讀 resources 表，主專案沒有寫入端 → 開 CM-3048。
• 套件 ssp_diagrams 有表有 repo、主專案沒寫入端；ssp_clone_service 會連 diagrams 一起複製。
• DEV 能力點前綴沒有 governance，本案用 oscal.pre-engagement.*。

教訓：

• 雛形裡給決策者看的註解寫進了畫面（括號說明），被當成產品內容質疑。註解一律放頁首「這頁要你確認的事」。
• 「凍結」這類工程詞對決策者會被讀成比原意更大的範圍，第一次就要用「誰還能改、誰看到的不變」講。
• 決策者說「不要」時，要先分析利弊再給建議，不要直接照砍（審閱那題被點名）。
• 批次排序：工作坊同批依卡號執行，想讓卡號大的先做就要拆批，開卡時就要對照卡號排。

決策者裁示：oscal.pre-engagement.upload 除了持有資源庫編輯權的系統角色，還要給 IT執行人員；manage-category 不給它。DEV 實查 IT執行人員（id 37）沒有 oscal.resource-library.update。已 append 到 CM-3041 卡尾，當時卡片狀態為 Not started，所以 runner 開工時看得到。design.md 的權限表同步。

推翻了什麼：開卡時的批次規劃。我照 big-feature-workflow skill 裡「同批依卡號一張接一張做」的舊說法排，把有依賴的卡放在同一批（CM-3041／3042、CM-3045／3046）。但 CLAUDE.md 的工作坊規範寫的是「同一批＝可以同時做；有先後的放下一批」。之後 Stage 曾被改成 1～8 一張一批，不會出錯，但能平行的卡也被迫排隊。

重排後：五批。批 3 是 CM-3044＋CM-3043，批 4 是 CM-3045＋CM-3047＋CM-3048，批 5 是 CM-3046。判斷依據有兩個：①是否用到別張卡的產出；②是否跟同批的卡改到同一個檔。卡 7 跟卡 3 都改 common/authz/ssp.py，卡 6 跟卡 5 都改 DocumentPoolPanel.vue。

改了哪裡：Notion 七張 Not started 子卡的 Stage 欄位；母卡與子卡卡尾 append 說明，寫明以 Stage 欄位為準；STATE 批次表、README 進度表。另外修正 big-feature-workflow skill 裡 Stage 那條的錯誤說法，讓它跟 CLAUDE.md 一致。

教訓：skill 跟 CLAUDE.md 寫的不一樣時，以 CLAUDE.md 為準，並且當場修正 skill。

規格改動（CM-3047）成立：FR-139 D19「稽核中鎖住資源庫」早就做在 ModuleFrameAuditLock（只放行 planning），我開卡時看到空的 before_template_write 誤判成缺口。runner 刪掉空殼、文件改成現況，正確。

驗收時發現並處理

• 主專案 venv 裝的是 Nexus 的 jedi-compliance-audit 1.4.0，沒有 CM-3043 加的三欄；runner 是用 PYTHONPATH 驗的。已切 path dependency（不 commit）並重啟 8000。1.5.0 發版後要還原 pin。
• 大類預設值有帶入；「組織架構」被手測改成「組織與人員」，已改回。
• runner 手測留下的 5 份資料（含 3 份同名網路圖）已用 API 刪除，程序書池同步刪除正常。

決策者追加、已做（BE 08729dab7、FE f92fd7b1）

• 「事前資料」全面改名「事前準備資料」（含 DB 選單與能力點說明，新 seed migration 只套 DEV）。
• 事前準備資料頁每份檔案加預覽鈕（共用 FilePreviewDialog）。實打預覽端點：png／jpg／pdf 原樣、docx／xlsx 轉 PDF，全部 inline 不下載。

範例資料（DEV 租戶 102）：五個大類共 11 份，網路架構圖有 v1→v2，資產清冊日期設為 400 天前以顯示「可能過時」。已同步進 5 個可寫資源庫的程序書池（各 11 列），稽核中的 491 沒有。

未驗：畫面截圖（headless 注入登入被開機檢查清掉），請決策者在瀏覽器看。

推翻了什麼：D6「預設全部帶入，顧問只能反向的『這框架不用』」。這原本是決策者裁的，理由是「要顧問再挑一次就多一道工」。決策者打開專案 1619 的規劃頁，看到程序書管理從 9 份變成 22 份，多出來的 13 份是別家公司（宏碩範例）的檔案，就問：「不是說要用引用的嗎，為什麼變成全部載入？」

為什麼會這樣：DEV 一個租戶（102）底下有好幾家客戶的資源庫，自動帶入讓每一家都被塞滿。我在討論時講「引用」，指的是檔案本體只有一份、各處共用 file_id。決策者理解的「引用」，是「顧問選了哪些，才有哪些」。兩邊用同一個詞，講的卻是不同的事。我在 D9 改成「落列」時，沒有把這個差別講清楚。

新規則（寫在 CM-3050）：

• 預設不帶入，顧問在資源庫程序書池按「從事前準備資料選用」。
• 「移出」會刪掉那一列，連帶刪掉掛載。
• 已經引用的資料照舊同步：新版、搬大類、刪除、標過時。標過時只會讓那份變淡，不會被移出。
• is_excluded 只代表「客戶標過時」，顧問手動排除的端點拿掉。

也跟決策者說明：專案頁不能上傳，是 FR-139 原本的規則。來自資源庫的專案，SSP 內容一律唯讀，改版前就已經這樣。

同一輪也完成：

• 「事前資料」全面改名「事前準備資料」（BE 08729dab7、FE f92fd7b1）
• 每份檔案加預覽
• 點名稱就開最新版預覽（FE 6b0242d0）
• 範例資料重做：用虛構公司「宏碩精密」，13 份像真的的文件
• 同名比對要不要放寬：現行的完全比對，對不到「_v4.0_2026-09」這類真實檔名。已寫進 CM-3050，等決策者裁示。

教訓：

• 同一個詞（引用），工程師和決策者的理解可能不同。定案前要用「畫面上會看到什麼」確認一次，不能只用機制描述。
• DEV 一個租戶底下有多家客戶。驗收「跟著公司」這類設計，要先想到這種情況。

決策者同意放寬同名比對，跟 CM-3050 一起做；並要求「修正成正確的規格」，不要在卡尾一直補。

• CM-3050：當時還是 Not started，整份內文換成新版。同名比對規則與測試表直接寫進本文，卡尾的補充段與「要先問決策者」都拿掉。換完確認狀態仍是 Not started，決策者隨即派工。
• design.md：拿掉開頭的「改判」說明段。首屏、流程圖、分工概述、D8、同步規則表（改名為「引用與同步規則」）、API 表、畫面、端到端驗收都改寫成現況。名稱一律改成「事前準備資料」。拆分表屬於施工紀錄，保留原樣，加上卡 10。

• BE c6ad6e264 和 FE ec6b34ac 都已在 feature/FR-139 上。共用的 8000 已經重啟（新 PID 5093），現在跑的是新程式，不會再自動帶入。
• 重啟前查過 DEV，沒有被舊程式寫回：只剩 4959（481）的 6 列，以及凍結／快照的 5549～5552。
• 依決策者核可的表，481 改成引用 10 份，用新端點操作：移出組織圖、備份與還原管理程序書；新選用遠端存取 VPN 架構與設定說明、資訊安全組織與權責、密碼管理規範、機房管理規範、機房進出登記表、總部機房平面配置圖。不引用的 3 份是組織圖、備份與還原管理程序書、資訊安全事件通報與處理程序書（CMMC Level 1 沒有要求，或已有其他文件涵蓋）。
• 其他資源庫（480／485／486／491／492）都是 0 列。
• jedi-compliance-audit：本卡沒有改套件，1.5.0 只包 CM-3043 的三欄（套件 repo 6f26a58d）。