專案

一般

配置概況

動作
複製連結

Feature #237

進行中
SC SC

T2-05 Session 2：補完 Tier 間 + 重置 + 安全介面 + Phase 2b/3 stub + Mermaid 圖 2 張

Feature #237: T2-05 Session 2：補完 Tier 間 + 重置 + 安全介面 + Phase 2b/3 stub + Mermaid 圖 2 張

是由 Sashiba Chou 於 約 2 個月 前加入.

狀態:
New
優先權:
Normal
被分派者:
Sashiba Chou
開始日期:
2026-06-03
完成日期:
2026-06-03 (逾期 59 天)
完成比例:

100%

預估工時:
1:00 小時

概述

Parent / Related

  • Feature #228（Phase 1 結項 + Phase 2 前置系列）
  • Feature #231（決策科技樹建立）
  • Feature #236（T2-05 Session 1 介面骨架）
  • Phase 2 任務分解 T2-05（docs/research/2026-06-03_phase2-task-decomposition.md）

Summary

T2-05 介面層 Session 2 落地（7 檔），補完 Session 1 留下的 Tier 間訊息 / 重置 / 安全 / Phase 2b/3 stub。同步在 tree/diagrams.md 新增 2 張 Mermaid 圖（介面層架構 + Tier 訊息流）+ 反向標註至 4 個 ADR + 3
個業主決策。

至此 docs/interfaces/ 17 檔完備，Phase 2a PoC 三條並行線（T2-06/07/08）+ Phase 2a 後續任務（T2-09/10/17）的契約依據齊全。

Background / Motivation

Session 1（Feature #236）完成 10 檔基底 + CRDT + 定位介面，留 7 檔 stub 為 Session 2 範圍：

  • Tier 間訊息（tier0-tier2 / tier0-tier3 / tier2-pairing-ble）
  • 重置（reset-boundary）
  • 安全（security-crypto）
  • Phase 2b/3 stub

PM 報告 §E 已標明 T2-05 是 T2-06/07/08 的共同前置；T2-05 Session 2 完成後三條 PoC 線可並行啟動。

Scope

7 個新介面檔

檔案 阻塞任務 行數
docs/interfaces/tier0-tier2-etag.md T2-08 ~110
docs/interfaces/tier0-tier3-relay.md T2-09 ~130
docs/interfaces/tier2-pairing-ble.md T2-10/17 ~180
docs/interfaces/reset-boundary.md T2-10 ~170
docs/interfaces/security-crypto.md T2-06/07/08 + T2-12 ~190
docs/interfaces/phase2b-anchor-beacon.md（stub） T2-16 / 待補 ~60
docs/interfaces/phase3-deferred.md（stub） Phase 3 / 待補 ~70

設計亮點

  1. reset-boundary.md：兩階段 atomic 重置 + 6 狀態機 + 無主 e-Tag 撿到完整流程（落地 OW-I）+ NVS atomic transaction 保證
  2. security-crypto.md：三層架構（AES-128 CCM / Ed25519 / TSA RFC 3161）+ PDPA 合規對照表 + 金鑰生命週期表 + 「TSA ≠ MEDI-CA」明示
  3. tier2-pairing-ble.md：NR-1 7 階段 + 5 狀態機 + ESP32-S3 HW RNG 6 位數字 + LED RGB 基-3 後援編碼 + Chain A/B 互斥
  4. tier0-tier2-etag.md：e-Tag 上線 10 步流程 + 心跳 pending_sync_n > 80 警示 + ctrl_etag_shutdown flush 契約
  5. tier0-tier3-relay.md：Bootstrap 完整時間軸（T+0 → T+180s Level 3 啟動）+ Anchor 失聯降級處理
  6. stub 檔：明示「不可在 Phase 2 隨意實作」+ 標 P3 / NRQD 連動

tree/ 反向標註（8 檔修改）

檔案 修改
00-index.md I.4 / I.5 → 完成（含對應表）+ 新增 I.7 視覺化
diagrams.md 新增第 13 圖（介面層架構 17 檔層次）+ 第 14 圖（Tier 訊息流）
adr/adr-106-regulatory-baseline.md 加 3 個衍生介面（envelope/merge-strategy/security-crypto）
adr/adr-108-frequency-band-920-925.md 加 4 個衍生介面（envelope/edca-tdma/tier0-tier2/tier0-tier3）
adr/adr-110-etag-screen-pairing.md 加 tier2-pairing-ble.md
adr/adr-114-etag-reset-and-crdt-cross-task-isolation.md 加 reset-boundary.md
owner/ow-recheck-3-ed25519.md 加 security-crypto.md
owner/ow-recheck-5-ble-pairing.md 加 tier2-pairing-ble.md
owner/ow-I-etag-detached.md 加 reset-boundary.md

Mermaid 圖（diagrams.md 第 13 / 14 圖）

第 13 圖：介面層架構

17 檔分 6 大類（基底 / CRDT / 定位 / Tier 間 / 重置安全 / Stub）的依賴拓樸。配色對應 SLO：

  • 藍 基底 / 綠 CRDT / 紫 定位 / 橘 Tier 間 / 紅 重置 + 安全 / 白 Stub

第 14 圖：Tier 間訊息流

五 Tier 對話路徑與對應介面檔。實線 = Phase 2a PoC 範圍（Tier 0/2/3）；虛線 = Phase 2b 範圍（Tier 1/1.5）。

Acceptance Criteria

  • 7 介面檔全部落地於 docs/interfaces/
  • 每個 Tier 間介面含完整 schema + 狀態機 + 訊息流 + 不變式
  • reset-boundary.md 含兩階段 atomic 流程 + NVS commit 保證
  • security-crypto.md 含三層架構 + PDPA 合規對照表
  • Stub 檔明示「不可在 Phase 2 隨意實作」+ 列出待補項目
  • 00-index.md I.4 / I.5 升為完成 + 新增 I.7 視覺化 section
  • diagrams.md 新增第 13 + 第 14 圖（17 節點 + Tier 對話路徑）
  • 4 個關鍵 ADR + 3 個業主決策節點檔加「衍生介面」段落

待後續 ADR 解的設計分岔（介面內已 surface）

介面 分岔
tier0-tier2 triage_update 批次上限 / shutdown flush 超時
tier0-tier3 Mesh 路由（Q20 阻塞）/ 自動 Anchor 化（工會議題）
tier2-pairing-ble QR 編碼方式 / LED 後援最終映射 / Chain 切換 UX
reset-boundary 孤兒資料 UI / Phase 1 失敗時強制重置授權 / 同時重置互斥
security-crypto TSA provider 選型 / MEDI-CA 升級路徑 / Group Key 輪換邊界

合計 Session 1 + 2 共 surface ~30 項分岔，均標 ❓ 待後續 ADR / PoC 階段解。

Not in Scope（Phase 2b 後補完）

  • phase2b-anchor-beacon.md 完整內容（Tier 1.5 信標 154 bytes 細節 / TDMA 同步精度 / 雙 PDR 融合演算法）
  • phase3-deferred.md 完整內容（戰場靜默協議 / e-Tag IMU schema / BYOD 認證流程）
  • ADR-113 戰場靜默撰寫

Maintenance Rules（已寫入 00-index.md §I.6 + diagrams.md §維護規則）

  1. 新增介面檔 → 00-index.md §I + 對應 source 節點檔的「衍生介面」段落 + diagrams.md 第 13 圖補節點
  2. 涉及新 Tier 對話 → diagrams.md 第 14 圖補箭頭
  3. 介面 major version 升級 → 通過 NRQD-7 介面凍結審查

Related Tasks (T2-05 Session 2 解阻塞)

  • T2-08 e-Tag 韌體 PoC：依賴 tier0-tier2-etag + tier2-pairing-ble + reset-boundary + security-crypto（仍須先解 Q20 Mesh 路由）
  • T2-09 Relay 韌體 PoC：依賴 tier0-tier3-relay + network-edca-tdma
  • T2-10 e-Tag 重置流程：依賴 reset-boundary
  • T2-17 Tier 1 救難 Android App：依賴 tier2-pairing-ble Chain A

Files Changed (16)

新建 (7):
docs/interfaces/tier0-tier2-etag.md
docs/interfaces/tier0-tier3-relay.md
docs/interfaces/tier2-pairing-ble.md
docs/interfaces/reset-boundary.md
docs/interfaces/security-crypto.md
docs/interfaces/phase2b-anchor-beacon.md
docs/interfaces/phase3-deferred.md

修改 (9):
docs/decisions/tree/00-index.md
docs/decisions/tree/diagrams.md
docs/decisions/tree/adr/adr-106-regulatory-baseline.md
docs/decisions/tree/adr/adr-108-frequency-band-920-925.md
docs/decisions/tree/adr/adr-110-etag-screen-pairing.md
docs/decisions/tree/adr/adr-114-etag-reset-and-crdt-cross-task-isolation.md
docs/decisions/tree/owner/ow-recheck-3-ed25519.md
docs/decisions/tree/owner/ow-recheck-5-ble-pairing.md
docs/decisions/tree/owner/ow-I-etag-detached.md

Notes

  • docs/research/2026-06-03_session-state-snapshot.md 已刪除（過時 stale snapshot）
  • Memory files (project_phase2_prep_2026-06-03.md + project_next_session_prompt_2026-06-03.md) 已同步更新為當前狀態
  • T2-05 介面層 Session 1 + 2 至此完備（17 檔），下次任務建議 T2-06/07/08 PoC（fresh session + sub-agent）

沒有任何資料可供顯示

動作
複製連結

匯出至 PDF Atom