專案

一般

配置概況

動作

Feature #259

進行中
SC SC

Q9 行程資料結構與儲存格式設計管線落地(ADR-005 + data-model.md)

Feature #259: Q9 行程資料結構與儲存格式設計管線落地(ADR-005 + data-model.md)

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

狀態:
New
優先權:
Normal
被分派者:
開始日期:
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 只解資料結構面。

沒有任何資料可供顯示

動作

匯出至 PDF Atom