# 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.md`、`system-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.md`、`audit-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.md`、`compliance-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.md`、`system-admin/smtp-config.md` | — | `system-admin/assets/wireframes/{notify-channels,smtp-config}-wireframe.svg` |

- **退役**：`system-admin/notify-smtp-config.md` 已 `git rm`（staged deletion `D`）。
- **退役檔站內連結修正**（tracked M，這三檔在我動之前是 clean）：`README.md`、`system-admin/_overview.md`、`system-admin/issue-integrate-config.md`（`notify-smtp-config.md` → `notify-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}.md`、`shared-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-stage`、**`ar-uc-04-import`（我的 audit-review 有引用！）**、`mytasks-uc-03/04/05`、`poam-uc-03-delete-remediation`。 |
| `compliance-framework/assets/*.dot`（未追蹤/改） | **`uc-mf-02-clone`（我的 module-frame 有引用！）**、`uc-cfi-02`、`uc-cfm-02/03`、`uc-mfi-02`、`uc-ssi-02`；改：`uc-mfi-01`、`uc-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 arc**：`project-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-manage**：`user-manage.md`（M）+ `user-form.md` + `user-import.md` + 3 wireframe。
3. **W1 notify**：`notify-channels.md` + `smtp-config.md` + 2 wireframe + `git rm notify-smtp-config.md` + 連結修正（`README.md`/`_overview.md`/`issue-integrate-config.md`）。
4. **W1 audit-review**：`audit-review.md`（M）+ `audit-verdict.md` + `audit-risk.md` + 3 wireframe + 該頁 .dot（`ar-uc-04-import.dot` 等）。
5. **W1 module-frame**：`module-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
```