動作
Feature #259
進行中
SC
SC
Q9 行程資料結構與儲存格式設計管線落地(ADR-005 + data-model.md)
Feature #259:
Q9 行程資料結構與儲存格式設計管線落地(ADR-005 + data-model.md)
開始日期:
2026-06-06
完成日期:
2026-06-06 (逾期 56 天)
完成比例:
100%
預估工時:
1:00 小時
概述
描述:
Q9(行程資料結構與多趟管理)走設計管線全鏈(領域模型→儲存裁決→
devil-advocate 挑戰→業主 E1/E2 拍板→architect 落地→qa),產出行程
資料模型與儲存格式架構決策。
核心決策(ADR-005):
- 儲存格式=每趟一檔 JSON(self-contained)+ manifest 索引;否決
SQLite/單檔巨 JSON/純文件作權威儲存。 - 混合 persist/transient,類別 V 拆 V-hard(Google Maps Content+
lat/lng,C-7 法律禁長存現值)/ V-soft(天氣/治安/Routes,Q11 時效
偏好,可存標過期歷史快照)/ N(照片/個資/key/徽記禁入)。 - DM-S1 可測試斷言:persist 檔不含 V-hard Google Content 現值。
- 純檢視 vs 重新生成兩動作 + revision 樂觀鎖 + 向後相容承諾 +
可分享完整 render snapshot(業主 E1)。
業主決策:
- E1:私下分享行程要含當時評分/天氣/治安的完整快照。
- E2:不需跨趟重用同目的地住宿候選名單。
落地內容:
- 新增 docs/decisions/ADR-005-itinerary-storage-format.md
- 新增 docs/specs/data-model.md(⏳,含 9 型節點 schema + V-hard/V-soft
- 多趟儲存 + 分享產物 + 純檢視 + 樂觀鎖 + 向後相容 + 90 條 qa 錨點)
- 新增 docs/specs/test-plan-Q9-data-model.md(90 條:正 38/負 39/邊界 13)
- 更新 architecture.md(ARCH-1/5/6 子規格,成熟度維持原狀)、glossary.md
- 更新 open-questions.md(Q9 ✅ + 新增 followup-a/b/c/d)
- 決策樹:adr-005/q-9 節點 + 00-index + diagrams 圖 4
- 不新增 constraint(C-5/C-7/C-8/C-9/C-10/C-11/C-2 已涵蓋)
- 3 份 research 文件(領域模型/裁決提案/devil-advocate 挑戰)
衍生 followup:
- Q9-followup-a:分享快照含 Google Content 的 C-7 定性(→ regulatory)
- Q9-followup-b:Streamlit 並發 + session_state 一致性實作確認(→ data-integration)
- Q9-followup-c:schema 遷移監控(條件觸發)
- Q9-followup-d:治安 reconfirm_strength 14 天門檻定案(暫定,三處須一致)
ARCH-1 行程規劃引擎(編排演算法)維持 ❓——Q9 只解資料結構面。
沒有任何資料可供顯示
動作