FR-047 W1(拆分重整)完成 — commit 協調交接(2026-07-06)

狀態:W1 全部檔案工作完成且驗證通過,但刻意未 commit。working tree 同時有 planning arc 與 W2 wireframe量產 的未 commit WIP,render_html.py(NAV)與 tracker.md 物理上把三方變更混在同檔,無法只 commit W1 而不掃到別人 WIP。由 W2-side / 協調 session 統一 commit。

1. W1 產出(全部已在 working tree、已驗證)

A 級拆分(4 頁 → hub+子頁 / 平級雙頁)

新增檔 改寫為 hub(tracked M) wireframe(新 SVG)
user-manage system-admin/user-form.mdsystem-admin/user-import.md system-admin/user-manage.md system-admin/assets/wireframes/{user-manage-hub,user-form,user-import}-wireframe.svg
audit-review audit-execution/audit-verdict.mdaudit-execution/audit-risk.md audit-execution/audit-review.md audit-execution/assets/wireframes/{audit-review-hub,audit-verdict,audit-risk}-wireframe.svg
module-frame compliance-framework/module-frame-detail.mdcompliance-framework/module-frame-defaults.md compliance-framework/module-frame.md compliance-framework/assets/wireframes/{module-frame-hub,module-frame-detail,module-frame-defaults}-wireframe.svg
notify(平級雙頁、無 hub) system-admin/notify-channels.mdsystem-admin/smtp-config.md system-admin/assets/wireframes/{notify-channels,smtp-config}-wireframe.svg
  • 退役system-admin/notify-smtp-config.mdgit rm(staged deletion D)。
  • 退役檔站內連結修正(tracked M,這三檔在我動之前是 clean):README.mdsystem-admin/_overview.mdsystem-admin/issue-integrate-config.mdnotify-smtp-config.mdnotify-channels.md / smtp-config.md)。
  • module-frame-defaults 五 tab 交叉引用 ../project-management/project-ssp-*.md(不複製欄位定義);control-defaults / reference-documents 兩個 MF-unique tab 自述於本頁。

B 級判定(記錄於 FR-047 tracker)

  • ap-authoring不拆(Tab1/Tab2 是 _backfill_scope_from_tasks 唯讀投影;新增稽核人員 / DOCX 匯入是 modal,非獨立畫面)。歸 W2 補 wireframe。
  • evidence-classification-reports → 判準指向拆(兩條獨立 route -validation/-adjudication + 兩 Vue view),但本 W1 未執行:①user W1 只點名 4 個 A 級頁、B 級為「判定」;②concurrent W2 arc 正把此頁當單頁做 wireframe量產。拆分草稿已撤回、原檔完整。→ 待 user 決定是否日後另排拆分。

驗證(在 working tree 上)

  • python3 scripts/deliverables/render_html.py "docs/specs/v1.8.0" 綠、無 error(僅 planning/shared-components 的「nav 未涵蓋」警告屬別 arc)。
  • 11 頁 wireframe 內嵌 SVG 的 in-page 錨點 + hub 跨頁 .md→.html 連結全部解析(含修掉 notify 子代理的 3 個錯 slug:實際 id 帶數字前綴、--)。
  • 敏感資訊 grep = 0;「GRC 系統」= 0。

2. 為什麼未 commit — 檔案糾纏地圖

共用檔 誰的變更混在裡面
scripts/deliverables/render_html.py planning arc(未 commit):GROUP_NAMES 加 shared-components、planning 4 子頁 NAV、共用元件 群——都指向未追蹤檔 project-management/planning-{status,batch-ops,basic-info}.mdshared-components/flow-phase-banner.md+W1:user-manage/audit-review/module-frame 三 hub 加子頁縮排、notify 換兩平級 entry。→ 單 commit render_html.py 必須同時 stage planning 子頁檔,否則 fresh clone build 斷 NAV。
docs/features/FR-047-2607-feature-spec-handbook/tracker.md planning arc 的「規劃頁 hub 拆分(未 commit)」整段 + W1 的「W1 拆分重整」段+Session 紀錄一行。
audit-execution/assets/*.dot(未追蹤) 前波次/W2 WIP:ap-uc-04-stagear-uc-04-import(我的 audit-review 有引用!)mytasks-uc-03/04/05poam-uc-03-delete-remediation
compliance-framework/assets/*.dot(未追蹤/改) uc-mf-02-clone(我的 module-frame 有引用!)uc-cfi-02uc-cfm-02/03uc-mfi-02uc-ssi-02;改:uc-mfi-01uc-ssi-01
各群 assets/wireframes/*.svg+多頁 spec(my-tasks/poam/ap-authoring/my-audits/evidence-classification-review/module-frame-import…) W2 wireframe量產 的 WIP。

→ user-manage 群與 notify 群其實可乾淨獨立 commit(只引用已 committed 的 .dot + 我新增的 wireframe);audit-review / module-frame 群因引用未追蹤 .dot、render_html.py / tracker.md 因 planning WIP,都不能只 commit W1 部分

3. 建議 commit 順序(給協調 session,避免任何 commit 斷 ref)

規則:①一頁的 .dot/.svg/NAV entry 要跟該頁 .md 同 commit 或更早;②render_html.py NAV 提到的檔都要先/同時進版。建議分:

  1. planning arcproject-management/planning-{status,batch-ops,basic-info}.md + project-planning.md + project-task-edit.md + shared-components/flow-phase-banner.md + 其 .dot/.svg。
  2. W1 user-manageuser-manage.md(M)+ user-form.md + user-import.md + 3 wireframe。
  3. W1 notifynotify-channels.md + smtp-config.md + 2 wireframe + git rm notify-smtp-config.md + 連結修正(README.md/_overview.md/issue-integrate-config.md)。
  4. W1 audit-reviewaudit-review.md(M)+ audit-verdict.md + audit-risk.md + 3 wireframe + 該頁 .dot(ar-uc-04-import.dot 等)。
  5. W1 module-framemodule-frame.md(M)+ module-frame-detail.md + module-frame-defaults.md + 3 wireframe + 該頁 .dot(uc-mf-02-clone.dot 等)。
  6. W2 wireframe量產:各群 wireframe SVG + 對應改的 spec + 其 .dot。
  7. 最後一次 commit render_html.py(planning+W1 NAV 全含)+ tracker.md(planning+W1 段全含)——此時所有被引用檔都已進版。

顯式 git add <檔名>、禁 -am/add -A;push 全部等 user 明示。 docs/features/FR-046-.../tracker.md 的 M 不是本 arc、勿一起 commit。

4. 一頁清單(W1 需進版的檔,複製用)

# 新增
docs/specs/v1.8.0/system-admin/user-form.md
docs/specs/v1.8.0/system-admin/user-import.md
docs/specs/v1.8.0/system-admin/notify-channels.md
docs/specs/v1.8.0/system-admin/smtp-config.md
docs/specs/v1.8.0/audit-execution/audit-verdict.md
docs/specs/v1.8.0/audit-execution/audit-risk.md
docs/specs/v1.8.0/compliance-framework/module-frame-detail.md
docs/specs/v1.8.0/compliance-framework/module-frame-defaults.md
docs/specs/v1.8.0/system-admin/assets/wireframes/user-manage-hub-wireframe.svg
docs/specs/v1.8.0/system-admin/assets/wireframes/user-form-wireframe.svg
docs/specs/v1.8.0/system-admin/assets/wireframes/user-import-wireframe.svg
docs/specs/v1.8.0/system-admin/assets/wireframes/notify-channels-wireframe.svg
docs/specs/v1.8.0/system-admin/assets/wireframes/smtp-config-wireframe.svg
docs/specs/v1.8.0/audit-execution/assets/wireframes/audit-review-hub-wireframe.svg
docs/specs/v1.8.0/audit-execution/assets/wireframes/audit-verdict-wireframe.svg
docs/specs/v1.8.0/audit-execution/assets/wireframes/audit-risk-wireframe.svg
docs/specs/v1.8.0/compliance-framework/assets/wireframes/module-frame-hub-wireframe.svg
docs/specs/v1.8.0/compliance-framework/assets/wireframes/module-frame-detail-wireframe.svg
docs/specs/v1.8.0/compliance-framework/assets/wireframes/module-frame-defaults-wireframe.svg
# 改寫(tracked M)
docs/specs/v1.8.0/system-admin/user-manage.md
docs/specs/v1.8.0/audit-execution/audit-review.md
docs/specs/v1.8.0/compliance-framework/module-frame.md
# 連結修正(tracked M,動前 clean)
docs/specs/v1.8.0/README.md
docs/specs/v1.8.0/system-admin/_overview.md
docs/specs/v1.8.0/system-admin/issue-integrate-config.md
# 刪除(staged D)
docs/specs/v1.8.0/system-admin/notify-smtp-config.md
# 共用檔(含 planning WIP,最後一起處理)
scripts/deliverables/render_html.py
docs/features/FR-047-2607-feature-spec-handbook/tracker.md