專案

一般

配置概況

動作

Feature #257

進行中
SC SC

Q4-5(併 Q11)治安資料源 + 時效更新策略:primary→verifier→synthesizer→devil-advocate→architect 全管線落地

Feature #257: Q4-5(併 Q11)治安資料源 + 時效更新策略:primary→verifier→synthesizer→devil-advocate→architect 全管線落地

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

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

100%

預估工時:
1:00 小時

概述

背景

Q4 拆解六子題的最後一塊收口(Q4-1/2/3/4/6 已 ✅)。治安為 CLAUDE.md 明列核心功能(「當地治安注意事項」)。本批完成資料源選型 + Q11
時效更新策略合併處理。

完成內容(全鏈五階段 + QA)

┌──────┬──────────────────────┬───────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ 階段 │ 角色 │ 產出 │
├──────┼──────────────────────┼───────────────────────────────────────────────────────────────────────────────────────────────────────────────┤
│ 1 │ research-primary │ docs/research/reports/2026-06-05_Q4-5-Q11_safety-data-sources_report.md(10 URL 全實抓) │
│ 調研 │ │ │
├──────┼──────────────────────┼───────────────────────────────────────────────────────────────────────────────────────────────────────────────┤
│ 2 │ research-verifier │ docs/research/verifications/2026-06-05_Q4-5-Q11_safety-data-sources_verification.md(4 │
│ 查證 │ │ 處【低信心/假設】升【已驗證】+ 1 處管道修正 + 港澳陸破口複雜度下修) │
├──────┼──────────────────────┼───────────────────────────────────────────────────────────────────────────────────────────────────────────────┤
│ 3 │ research-synthesizer │ docs/research/conclusions/2026-06-05_Q4-5-Q11_safety-data-sources_conclusion.md + tree 節點 │
│ 整合 │ │ docs/decisions/tree/research/q-4-5-safety-data-sources.md │
├──────┼──────────────────────┼───────────────────────────────────────────────────────────────────────────────────────────────────────────────┤
│ 4 │ devil-advocate │ docs/research/devil-advocate/2026-06-05_Q4-5-Q11_safety-data-sources-challenge.md(4 加固成立 + 1 │
│ 挑戰 │ │ 保留,不推翻) │
├──────┼──────────────────────┼───────────────────────────────────────────────────────────────────────────────────────────────────────────────┤
│ 5 │ system-architect │ docs/specs/architecture.md / constraints.md / glossary.md(無新 ADR/constraint/降級) │
│ 落地 │ │ │
├──────┼──────────────────────┼───────────────────────────────────────────────────────────────────────────────────────────────────────────────┤
│ QA │ qa-engineer │ docs/specs/test-plan-Q4-5-Q11.md(43 條:正 17/負 20/邊界 6) │
└──────┴──────────────────────┴───────────────────────────────────────────────────────────────────────────────────────────────────────────────┘

結論摘要

  • Tier 1 官方旅警交叉源聯集:台 BOCA 官網/RSS 直連第一視角主源(data.gov.tw #3302 dataset 回 500、REST API 404 確不可達→僅留授權依據)+ 美 State
    Dept(public domain·attribution 自願)/英 FCDO(GOV.UK Content API·結構化最高·含 change_history·OGL 顯名)/澳 Smartraveller(free JSON·CC-BY
    顯名強制·禁官方 logo)。等級不可機械換算 → 取警示聯集(union)讀全文不只看級數。
  • Numbeo 排除:API 全付費(260 USD/月起·無 free-tier)+ ToS 明文禁爬(Serbia 法)→ 程式化路徑無免費選項 + 自動化禁爬,由既有 C-4 + P-1
    涵蓋,不新增 constraint。
  • 破口顯性化:①港澳陸不在 BOCA feed 須另接 MAC 陸委會(同 4 級燈號制·結構化 feed 形態待
    followup-a)②無城市/街區粒度(直擊核心賣點最常見情境)③無免費跨國可比犯罪指數 ④東南亞稀薄 ⑤時效張力。
  • 時效(Q11):3/4 級即時發布、1/2 級月更 → 查詢時即時拉取或 ≤24h 短 TTL + 標查詢時間(沿用 C-7 精神,非改本體)·不訂閱推播·規劃日 vs
    出發日落差顯性化 + 出發前重查(落 C-2,不動 ADR-002/OW-3)。

specs 變更

  • ARCH-2 治安 adapter 子面向(新建 漏斗):多源聯集 + 取得管道 + 破口顯性標 + 呈現排序/衝突顯性化 + 時效策略 + Numbeo 不納主幹 +
    半自動貼回負向界定。
  • ARCH-5 治安四源 attribution 子規格(❓):觸發條件分流(BOCA OGDL 利用即須/FCDO OGL + Smartraveller CC-BY 散布觸發保守一律主動標/State Dept
    自願)+ 每筆粒度邊界聲明 + 港澳陸降級語 + 負向驗證(禁徽記/不得暗示官方背書)。
  • C-1:擴充治安五標識 boca_mofa/us_state_dept/fcdo_govuk/smartraveller/mac_taiwan(✅ 不變)。
  • C-2:治安不確定性 + 時效字樣延伸(✅ 不變)。
  • glossary:新增「官方旅警警示 / 粒度邊界聲明 / MAC(陸委會)」。

衍生 open-questions(已登錄)

  • Q4-5-followup-a(P1,交 research-primary):MAC 港澳陸結構化 feed 形態 + 失敗分支預案(verifier 唯一無法查證項)。
  • Q4-5-followup-b(P2):城市/街區級治安粒度免費合規源(直擊核心賣點)。
  • Q4-5-followup-c:Numbeo 代爬中間商定性(已由 P-1 程序門接管)。
  • Q4-5-followup-d(P2,交 travel-planning-specialist):跨機關等級不可換算呈現規範 + 安全目的地全文過載必測。
  • Q11-followup-a(P2,交 data-integration-engineer):≤24h/即時拉取 TTL 實作確認。

待辦(非阻擋)

  • project-manager 開 Q4-5-followup-a 任務單(明文化失敗分支預案 + 排除硬編燈號)。
  • system-architect 留意 qa 提請的 Q45-ATT-B-01(程式化 attribution_trigger: on_use/on_distribution/voluntary 標註,可降為設計建議)。
  • qa 治安測試項俟 ARCH-5 升 漏斗/✅ 正式納入驗收矩陣。

影響檔案

M docs/decisions/tree/00-index.md
M docs/research/open-questions.md
M docs/specs/architecture.md
M docs/specs/constraints.md
M docs/specs/glossary.md
A docs/decisions/tree/research/q-4-5-safety-data-sources.md
A docs/research/conclusions/2026-06-05_Q4-5-Q11_safety-data-sources_conclusion.md
A docs/research/devil-advocate/2026-06-05_Q4-5-Q11_safety-data-sources-challenge.md
A docs/research/reports/2026-06-05_Q4-5-Q11_safety-data-sources_report.md
A docs/research/verifications/2026-06-05_Q4-5-Q11_safety-data-sources_verification.md
A docs/specs/test-plan-Q4-5-Q11.md

沒有任何資料可供顯示

動作

匯出至 PDF Atom