Taiwan World Model 開發進度追蹤

TWM Progress Heatmap：這個頁面用來追蹤我們已經做了什麼、哪些正在進行、哪些還沒完成。它不是 API 文件，而是產品/工程狀態看板。

開發順序：Level 1 Demo、Level 2 MVP 與 Level 3 Beta：完成；下一階段才進 Production hardening / external TrueSight repo merge / partner pilot。

目前策略：先公開進度頁，方便直接查看開發狀況；OAuth 登入保護保留為後續工作。

最後更新：2026-07-20 00:10 CST · 下載/查看 Markdown 追蹤檔

整體64%

已完成11

進行中4

下一步2

尚未開始3

受阻0

Milestone Priority

Level 1 DemoLevel 1 Demo：完成

可展示版本：首頁可直接免 API key 試用固定 demo，看到人話 answer card、來源/時間/限制與進度頁。

開發政策：Level 1 已完成；目前進入 Level 2 MVP。

Level 2 MVPLevel 2 MVP：完成

小群使用者測試版：15 個 demo query、首頁一鍵分享、可分享結果頁、友善錯誤提示、/verify 驗證頁。

開發政策：Level 2 MVP 已完成；Level 3 Beta 等使用者確認後再啟動。

Level 3 BetaLevel 3 Beta：完成

TrueSight / partner Beta：TrueSight E2E dry-run integration、3 個 beta-ready runtime、runtime trust contract、JSONL persistence contracts 與 final live verification 均已完成。

開發政策：Level 3 Beta：完成；下一階段才進 Production hardening / external TrueSight repo merge / partner pilot。

Level 2 MVP Done checklist

✅ 15 個 demo queries
✅ 首頁一鍵分享
✅ 可分享結果頁 /result?query=...
✅ 非 allowlist 友善提示
✅ /verify 驗證頁
✅ Secret leak check

Level 3 Sprint 1：Beta Verification Foundation

✅ /beta 頁
✅ Level 3 Done checklist
✅ source health / freshness / confidence factors contract
✅ persistence audit foundation checklist
✅ live verification script scripts/verify_level3_beta.py
✅ progress page 顯示 Level 3 started

Contract markers：source_health_status、freshness_seconds、staleness、reliability_score、confidence_factors、audit log 持久化、usage event 持久化、source health history 持久化。

開啟 /beta Level 3 Beta status

Sprint 2：Runtime Trust Foundation

✅ Weather / Rain answer 加入 confidence_factors
✅ Weather / Rain answer 加入 source_health_status
✅ Weather / Rain answer 加入 freshness_seconds / staleness
✅ stale / degraded source 會降低 confidence
✅ stability 影響 confidence / stability affects confidence
✅ audit log JSONL persistence contract
✅ usage event JSONL persistence contract
✅ source health history JSONL persistence contract

Level 3 Sprint 2：完成 — Sprint 2：Runtime Trust Foundation。

Level 3 Beta Overall Completion Gate

✅ Level 3 Beta：完成
✅ TrueSight E2E dry-run integration：完成
✅ Weather / Rain beta-ready
✅ Earthquake / Disaster beta-ready
✅ Forecast Reality beta-ready
✅ audit log JSONL persistence：完成
✅ usage event JSONL persistence：完成
✅ source health history JSONL persistence：完成
✅ final Level 3 live verification：PASSED

TWM Progress Heatmap

已完成進行中下一步尚未開始受阻

100

目前做了什麼 / 正在進行 / 還沒完成

✅ 已完成90%

首頁產品化

Product

/ 已從 API 文件頁改成 Reality Search Taiwan 搜尋入口，/api 保留 API guide。

下一步：再補手機版細節與首頁預設結果。

✅ 已完成100%

免 API key demo

Product

/v1/reality/demo-check 已可讓首頁固定 demo 不需 API key 試用。

下一步：維持 allowlist，避免公開任意查詢造成成本與安全風險。

🟡 進行中65%

Answer Card 人話化

Product

已把部分 raw state 轉成人話，開始顯示結論、信心、來源、時間與建議。

下一步：把天氣、地震、預報各自整理成更穩定的答案模板。

✅ 已完成90%

CWA 即時天氣 / 雨量

Data Runtime

中央氣象署觀測與雨量 runtime 已接入，可回答阿里山等地即時降雨與天氣問題。

下一步：擴充更多地點解析與資料新鮮度顯示。

✅ 已完成75%

地震資訊 runtime

Data Runtime

近期地震 demo 已可用，並修正台灣地名解析避免誤判成其他機構名稱。

下一步：補完整災害訊息格式與更清楚的安全建議。

🟡 進行中55%

短時降雨預報

Data Runtime

已能提供初版未來雨勢語境，但仍需明確標示它是預報，不是當下觀測。

下一步：加入預報可信度、時間窗與不確定性說明。

✅ 已完成70%

攝影機 registry / snapshot metadata

Evidence

已建立攝影機 registry 與 snapshot metadata endpoint，不公開 raw feed URL。

下一步：等待第一手授權/來源，避免經第三方串流平台造成資料鏈風險。

🟡 進行中35%

攝影機 visual evidence

Evidence

已做安全 preflight / fixture foundation，但尚未納入正式 Reality answer。

下一步：接入第一手來源後，才做下雨、能見度、人潮等現場證據交叉驗證。

✅ 已完成80%

API governance / key / audit foundation

Platform

已有 API key、基本 policy、audit、rate limit 與 public demo endpoint gating。

下一步：Beta 前補 persistent audit、quota、key revoke 與成本上限。

🟡 進行中60%

Source catalog / source health

Platform

已有來源 catalog、source health 與 degraded mode foundation。

下一步：把更多來源的 live probe 與健康分數接上。

✅ 已完成100%

TrueSight 實際整合 / E2E dry-run integration：完成

Integration

TWM repo 內 TrueSight dry-run adapter 已可把 Reality API response 映射成 reality_check，並保留 source health、freshness、confidence_factors 與 trust_contract。

下一步：Production 前再把相同 contract merge 到外部 TrueSight repo。

⬜ 尚未開始10%

交通 runtime

Data Runtime

TDX/高公局等交通資料列在 roadmap，但尚未成為可查 runtime。

下一步：先做國道壅塞、旅行時間與事件資訊的最小查詢能力。

⬜ 尚未開始10%

淹水 / 水位 / 水文

Data Runtime

水利、防災相關來源尚未 runtime 化。

下一步：接官方水位/淹水/河川資料，建立 flooding_risk 的正式資料鏈。

🔜 下一步20%

海嘯 / 颱風 / 災害告警

Disaster

地震已先做，海嘯與颱風仍需接官方告警 runtime。

下一步：以官方警報為唯一一等來源，做警示狀態與限制說明。

🔜 下一步20%

衛星 / 雷達 runtime

Evidence

已有 metadata/foundation endpoint，尚未做成正式回答依據。

下一步：先接 CWA 雷達/衛星圖資 metadata 與新鮮度，再談影像判讀。

✅ 已完成100%

分享結果頁

Product

已新增 /result?query=... 可分享結果頁，固定 demo 查詢可用網址直接展示。

下一步：Level 3 前再評估快取/永久結果 ID。

⬜ 尚未開始10%

PostgreSQL / Redis / scheduler persistence

Production

目前多數仍是 in-memory / foundation 階段，尚未到 production persistence。

下一步：MVP 穩定後再導入 PostgreSQL、Redis、worker/scheduler。

✅ 已完成100%

Sprint 1：Beta Verification Foundation

Level 3 Beta

Level 3 Beta 基礎驗證已完成：/beta 頁、Level 3 Done checklist、source health / freshness / confidence factors contract、persistence audit 與 live verification script。

下一步：已進入 Sprint 2：Runtime Trust Foundation。

✅ 已完成100%

Sprint 2：Runtime Trust Foundation

Level 3 Beta

Level 3 Sprint 2：完成；Weather/Rain answer 已輸出 source_health_status、freshness_seconds、staleness、confidence_factors，並讓 stability 影響 confidence。

下一步：下一步進入 Sprint 3：TrueSight E2E Integration。

✅ 已完成100%

Level 3 Beta overall gate：完成

Level 3 Beta

Level 3 Beta：完成；TrueSight E2E dry-run integration、Weather / Rain beta-ready、Earthquake / Disaster beta-ready、Forecast Reality beta-ready、JSONL persistence contracts 與 final Level 3 live verification：PASSED。

下一步：下一階段改走 Production hardening、外部 TrueSight repo merge 與 partner pilot。