動作
Feature #231
進行中
SC
SC
ARES 決策科技樹建立（Rollback 推演工具）
Feature #231:
ARES 決策科技樹建立（Rollback 推演工具）
開始日期:
2026-06-03
完成日期:
2026-06-03 (逾期 59 天)
完成比例:
100%
預估工時:
1:00 小時
概述
Summary¶
為 ARES 專案建立業主決策、ADR、研究問題的「依賴關係視圖」，
作為日後 rollback 決策時的影響範圍推演工具。
Background / Motivation¶
業主 2026-06-03 提案：
這個專案開始會有許多業主決策，有沒有可能將所有決策問題、業主選項
及選擇、以及最終這個決策會導致哪些後續的樹狀結果/後續問題與決策
展開記錄下來，之後可以回顧成科技樹。我其實目的是之後如果需要
rollback 一些決策可以用科技樹輔助。
ARES Phase 1 + Phase 2 前置累積大量決策節點，散落於：
-
docs/decisions/ADR-*.md（15 個 ADR） -
docs/research/open-questions.md（40 個研究問題） -
docs/research/2026-04-26_owner-decision-package.md（22 項業主決策） -
docs/research/2026-05-02_owner-nr-q-decisions.md（9 項 NR-Q） -
docs/research/2026-06-03_owner-decisions-d1-d2-d3.md（3 項 D 系列）
缺乏跨節點「依賴 + rollback 影響」統一視圖。
Scope¶
建立 docs/decisions/tree/ 目錄，提供：
- 全樹文字索引（含 prefix 對照表 + rollback 範例）
- 每個節點獨立 detail 檔（9 欄位模板）
- Mermaid 視覺化圖檔（12 張）
Deliverables¶
| 路徑 | 內容 | 數量 |
|---|---|---|
docs/decisions/tree/00-index.md |
全樹索引 + prefix 對照 + Rollback 範例 | 1 |
docs/decisions/tree/_template.md |
節點模板 | 1 |
docs/decisions/tree/owner/ |
業主決策節點（A-S + 複核 1-6 + NRQ1-8 + NRX + D-1/D-2/D-3） | 37 |
docs/decisions/tree/adr/ |
ADR 摘要節點（ADR-101 ~ 116，跳過 113 保留編號） | 15 |
docs/decisions/tree/research/ |
研究問題節點（Q1-Q31 + NRQD-1-9） | 40 |
docs/decisions/tree/delayed/ |
延後追蹤節點（S-1 / E-1 / P-1） | 3 |
docs/decisions/tree/diagrams.md |
Mermaid 視覺化（12 張圖） | 1 |
| 合計 | 98 |
Node Detail Schema¶
每個業主決策 / ADR / 研究問題節點檔包含 9 個區塊：
- 元資料表格 — 類型 / 狀態 / 日期 / 文件來源 / 對應 ADR
- 問題 — 一句話
- 選項表格 — 含業主取捨欄
- 業主選擇 — 結論 + 業主原話引用
-
上游依賴 —
[[link]]雙向標註 - 衍生節點 — 含 觸發時點
- Rollback 影響 — 分情境列文件 / 下游節點 / 工作量估計
- 跨參照 — 完整脈絡 / 相關 ADR / 規格 / 主協調者責任
- （索引層）Rollback 範例 — 深度優先展開示範
Mermaid Visualization¶
diagrams.md 包含 12 張圖：
| # | 圖名 | 用途 |
|---|---|---|
| 1 | 全樹高階總覽 | 一頁看 8 sections 全貌 |
| 2 | Phase 1 主決策鏈 | OW-A/B/C + 複核 1-6 + 核心 ADR |
| 3 | NR-Q 系列鏈 | NRQ1-8 + NRX + NRQD 衍生 |
| 4 | 2026-06-03 D 系列補完鏈 | D-1/D-2/D-3 上下游 |
| 5 | 法規合規鏈 | Q07 → ADR-106 → 9 個法規決策 |
| 6 | CRDT / 資料模型鏈 | Q08 → ADR-107 → recheck-4 → D-3 → ADR-116 |
| 7 | 定位 / 通訊鏈 | Q1/2/6 → 五層定位 ADR |
| 8 | 硬體 BOM 鏈 | Q3/4/5 → 三 Tier 硬體選型 |
| 9 | Rollback 範例：OW-A | 完整深度展開 |
| 10 | Rollback 範例：OW-recheck-4 | 兩階段補完（4 月 + 6 月） |
| 11 | 延後追蹤時間軸 | Gantt 圖 S-1 / E-1 / P-1 |
| 12 | 跨 ADR 矛盾關係 | ADR-106 × ADR-107 自動升級爭議 |
統一配色：橘 業主決策 / 藍 ADR / 綠 研究問題 / 黃 延後 / 紅 跨 ADR 矛盾
Identifier Prefix Convention¶
| Prefix | 意義 | 範例 |
|---|---|---|
OW-A ~ OW-S
|
業主決策（Phase 1 字母編號） | OW-A 顯示器 |
OW-recheck-N |
業主歷史決策複核 | OW-recheck-1 48h 續航 |
OW-NRQ-N |
NR-Q 系列決策 | OW-NRQ2 Tier 1.5 補電 |
OW-NRX |
業主新增需求 | OW-NRX Android IMU |
OW-D-N |
2026-06-03 D 系列 | OW-D-1 TFDA 時程 |
ADR-NNN |
架構決策 | ADR-103 顯示器方案 E |
Q-NN |
研究問題 | Q20 Mesh 路由 |
NRQD-N |
NR-Q 衍生問題 | NRQD-1 Tier 1.5 干擾 |
S-1 / E-1 / P-1
|
延後追蹤 | P-1 MM6108 採購 |
Acceptance Criteria¶
-
98 檔全部落地於
docs/decisions/tree/ -
00-index.md含 prefix 對照表 + OW-A rollback 深度展開範例 - 每個業主決策節點檔含完整 9 區塊
-
diagrams.md在 GitHub / VS Code Mermaid 預覽下可正確渲染（語法已驗證） -
業主審視 3 個範例（
00-index.md+ow-A-display.md+ow-recheck-4-triagerecord.md）已通過
Not in Scope¶
- 不取代既有
docs/decisions/ADR-*.md（保留為完整脈絡來源） - 不取代
docs/research/open-questions.md（保留為研究團隊輸入清單） - 不更新
CLAUDE.md（業主未要求） - 未建立自動化 lint 工具確保跨節點
[[link]]引用一致性（手工維護）
Maintenance Rules¶
- 新增決策 → 同步在
00-index.md加一行 +tree/owner/加 detail 檔 +diagrams.md補節點 - 業主撤回 / ADR 降級 → 標記 Superseded，保留歷史
- 跨 ADR 矛盾 →
diagrams.md用 紅框（warn classDef）標註 - Rollback 範例 → 限定深度 ≤ 3 層
Files (98 total)¶
docs/decisions/tree/
├── 00-index.md
├── _template.md
├── diagrams.md
├── owner/ 37 files (ow-A through ow-S + recheck-1-6 + NRQ1-8 + NRX + D-1/2/3)
├── adr/ 15 files (adr-101 through adr-116, excluding 113)
├── research/ 40 files (q01-q31 + nrqd-1-9)
└── delayed/ 3 files (s-1, e-1, p-1)
Notes¶
- 上次 session 累積的
docs/research/2026-06-03_session-state-snapshot.md
不在本 ticket 範圍（業主 2026-06-03 明示拒絕 commit）。
沒有任何資料可供顯示
動作