# Taiwan World Model 開發進度追蹤

最後更新：2026-07-20 00:10 CST

公開頁面：`/progress`
公開 Markdown 檔：`/progress.md`

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

## Milestone Priority

- **Level 1 Demo：完成** (100%) — 可展示版本：首頁可直接免 API key 試用固定 demo，看到人話 answer card、來源/時間/限制與進度頁。 Level 1 已完成；目前進入 Level 2 MVP。
- **Level 2 MVP：完成** (100%) — 小群使用者測試版：15 個 demo query、首頁一鍵分享、可分享結果頁、友善錯誤提示、/verify 驗證頁。 Level 2 MVP 已完成；Level 3 Beta 等使用者確認後再啟動。
- **Level 3 Beta：完成** (100%) — 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

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

## Level 3 Sprint 1：Beta Verification Foundation

公開狀態頁：`/beta`

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

## Sprint 2：Runtime Trust Foundation

**Level 3 Sprint 2：完成**

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

### Runtime Trust Contract Markers

- `source_health_status`、`freshness_seconds`、`staleness`、`reliability_score`、`confidence_factors`
- stability 影響 confidence；stale / degraded source 會降低 confidence
- audit log JSONL persistence、usage event JSONL persistence、source health history JSONL persistence

## Level 3 Beta Overall Completion Gate

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

### Level 3 Beta Contract Markers

- source health / freshness / confidence factors contract：`source_health_status`、`freshness_seconds`、`staleness`、`reliability_score`、`confidence_factors`
- Persistence / Audit Contract：audit log 持久化、usage event 持久化、source health history 持久化、service restart 後仍可查
- Live Verification Script：`scripts/verify_level3_beta.py`

## 總覽

- 整體進度：約 **64%**
- 已完成：**11**
- 進行中：**4**
- 下一步：**2**
- 尚未開始：**3**
- 受阻：**0**

## 目前已完成

- ✅ **首頁產品化** (Product, 90%) — / 已從 API 文件頁改成 Reality Search Taiwan 搜尋入口，/api 保留 API guide。 下一步：再補手機版細節與首頁預設結果。
- ✅ **免 API key demo** (Product, 100%) — /v1/reality/demo-check 已可讓首頁固定 demo 不需 API key 試用。 下一步：維持 allowlist，避免公開任意查詢造成成本與安全風險。
- ✅ **CWA 即時天氣 / 雨量** (Data Runtime, 90%) — 中央氣象署觀測與雨量 runtime 已接入，可回答阿里山等地即時降雨與天氣問題。 下一步：擴充更多地點解析與資料新鮮度顯示。
- ✅ **地震資訊 runtime** (Data Runtime, 75%) — 近期地震 demo 已可用，並修正台灣地名解析避免誤判成其他機構名稱。 下一步：補完整災害訊息格式與更清楚的安全建議。
- ✅ **攝影機 registry / snapshot metadata** (Evidence, 70%) — 已建立攝影機 registry 與 snapshot metadata endpoint，不公開 raw feed URL。 下一步：等待第一手授權/來源，避免經第三方串流平台造成資料鏈風險。
- ✅ **API governance / key / audit foundation** (Platform, 80%) — 已有 API key、基本 policy、audit、rate limit 與 public demo endpoint gating。 下一步：Beta 前補 persistent audit、quota、key revoke 與成本上限。
- ✅ **TrueSight 實際整合 / E2E dry-run integration：完成** (Integration, 100%) — TWM repo 內 TrueSight dry-run adapter 已可把 Reality API response 映射成 reality_check，並保留 source health、freshness、confidence_factors 與 trust_contract。 下一步：Production 前再把相同 contract merge 到外部 TrueSight repo。
- ✅ **分享結果頁** (Product, 100%) — 已新增 /result?query=... 可分享結果頁，固定 demo 查詢可用網址直接展示。 下一步：Level 3 前再評估快取/永久結果 ID。
- ✅ **Sprint 1：Beta Verification Foundation** (Level 3 Beta, 100%) — Level 3 Beta 基礎驗證已完成：/beta 頁、Level 3 Done checklist、source health / freshness / confidence factors contract、persistence audit 與 live verification script。 下一步：已進入 Sprint 2：Runtime Trust Foundation。
- ✅ **Sprint 2：Runtime Trust Foundation** (Level 3 Beta, 100%) — Level 3 Sprint 2：完成；Weather/Rain answer 已輸出 source_health_status、freshness_seconds、staleness、confidence_factors，並讓 stability 影響 confidence。 下一步：下一步進入 Sprint 3：TrueSight E2E Integration。
- ✅ **Level 3 Beta overall gate：完成** (Level 3 Beta, 100%) — 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。

## 正在進行

- 🟡 **Answer Card 人話化** (Product, 65%) — 已把部分 raw state 轉成人話，開始顯示結論、信心、來源、時間與建議。 下一步：把天氣、地震、預報各自整理成更穩定的答案模板。
- 🟡 **短時降雨預報** (Data Runtime, 55%) — 已能提供初版未來雨勢語境，但仍需明確標示它是預報，不是當下觀測。 下一步：加入預報可信度、時間窗與不確定性說明。
- 🟡 **攝影機 visual evidence** (Evidence, 35%) — 已做安全 preflight / fixture foundation，但尚未納入正式 Reality answer。 下一步：接入第一手來源後，才做下雨、能見度、人潮等現場證據交叉驗證。
- 🟡 **Source catalog / source health** (Platform, 60%) — 已有來源 catalog、source health 與 degraded mode foundation。 下一步：把更多來源的 live probe 與健康分數接上。
- 🔜 **海嘯 / 颱風 / 災害告警** (Disaster, 20%) — 地震已先做，海嘯與颱風仍需接官方告警 runtime。 下一步：以官方警報為唯一一等來源，做警示狀態與限制說明。
- 🔜 **衛星 / 雷達 runtime** (Evidence, 20%) — 已有 metadata/foundation endpoint，尚未做成正式回答依據。 下一步：先接 CWA 雷達/衛星圖資 metadata 與新鮮度，再談影像判讀。

## 尚未完成 / 後續

- ⬜ **交通 runtime** (Data Runtime, 10%) — TDX/高公局等交通資料列在 roadmap，但尚未成為可查 runtime。 下一步：先做國道壅塞、旅行時間與事件資訊的最小查詢能力。
- ⬜ **淹水 / 水位 / 水文** (Data Runtime, 10%) — 水利、防災相關來源尚未 runtime 化。 下一步：接官方水位/淹水/河川資料，建立 flooding_risk 的正式資料鏈。
- ⬜ **PostgreSQL / Redis / scheduler persistence** (Production, 10%) — 目前多數仍是 in-memory / foundation 階段，尚未到 production persistence。 下一步：MVP 穩定後再導入 PostgreSQL、Redis、worker/scheduler。

## 目前重點

1. Level 3 Beta 已啟動，但先做 Beta Verification Foundation，不先擴大到無限平台工程。
2. 固定 demo 可免 API key 試用，任意查詢仍需 API key。
3. 只展示已接上 live runtime 的能力，未完成能力清楚標示。
4. source health / freshness / confidence factors contract、persistence audit 與 live verification script 是 Level 3 的第一個完成邊界。