咻揪趣 MVP · v0.19.0
進度追蹤 · 文件 里程碑待辦看板 · 產生於 2026-09-22 15:45

里程碑待辦看板

看板更新：2026-09-21 · 版本 v0.13.0 · 狀態欄位：完成 等待使用者決定 待辦

一句話結論： M0–M3 與 M4a（上線前收尾）已完成並驗收，產品已具備上線條件；只剩 M4b（申請主機與網域）需要你決定，那一步不涉及任何程式修改。

1. 里程碑

M0
範圍收斂與技術取捨 完成
把規格書五大模組切成 P0/P1/P2，決定用 Web App＋規則引擎＋SQLite 換取可上線速度。產出：MVP 範圍定義。
M1
資料層與解析核心 完成
10 張資料表、地標辭典、解析引擎（含錯誤態與候選）、結構化日誌。
M2
可操作產品本體 完成
地圖／清單／行程／我的四個檢視、匯入流程、評價、地圖切換、首次引導，全部接上真實 API。
M3
後台、監控與驗收 完成
管理後台、健康檢查、30 項端到端測試、資料落地驗證、上線文件。
M4a
上線前收尾 完成
preflight 上線前檢查工具、示範資料開關與清空腳本、四頁實機驗收（修掉分頁點不到的阻斷級缺陷）、生產啟動驗證、上線前完成報告與 Go 判定。
M4b
正式雲端部署與網域 等待使用者決定
產品端已全部就緒；此步純粹是申請主機、購買網域、填入權杖與外部監控，不涉及任何程式修改。

2. 待辦看板

已完成 Done
  • MVP 範圍定義與凍結
  • 資料庫 schema（10 表）與種子資料機制
  • 解析引擎 heuristic-v1（ok / ambiguous / failed）
  • 匯入 → 確認 → 入圖 完整流程
  • 圖釘雙重狀態、親友實測評價
  • 清單搜尋／篩選、區域雷達、夜間模式
  • 庫存轉行程（最近鄰排序＋移動時間）
  • 管理後台（資料表／事件／日誌／指標）
  • 健康檢查、就緒探針、版本端點、結構化日誌
  • LLM 解析引擎（可插拔，含降級）
  • Google Places 打點補強（含座標投影與降級）
  • PWA（manifest／Service Worker／自製圖示）與 Android Web Share Target
  • 遠端備份（Drive API／rclone）
  • L1 平台底層：版本化遷移、帳號系統、權限模型、API v1
  • T2 KOL 專屬地圖公開頁與一鍵匯入
  • T3 圖釘照片上傳與相簿
  • T4 SSE 即時多人協作
  • T5 站內通知
  • 30 項端到端、21 項 AI 鏈路、9 項遠端備份、5 項生產啟動驗證
  • 部署包：Dockerfile／compose／Caddy／env 範本／systemd 服務單元／Windows 啟動腳本
  • 生產強化：安全標頭、寫入限流、請求大小上限、埠佔用明確退出
  • 冒煙測試（16 項）與可用性監控腳本（含告警路徑驗證）
  • 回滾演練（停機→還原→重啟，10→9 筆複驗通過）
  • 上線前檢查工具（preflight，17 項；0 擋上線）
  • 示範資料開關與 npm run wipe
  • 版本錨點：v0.9.0／v0.10.0／v0.10.1／v0.10.2／v0.11.0
  • 修正 BUG-001／BUG-002／BUG-003
  • 七份交付文件（範圍、上線前完成報告、待辦清單、部署、驗收、看板、交接）
    • 等待使用者（不影響產品完成）
  • M4b 主機平台與網域（需你的帳號與 DNS）
  • 管理權杖改由環境變數固定
  • 接第三方 uptime 監控（腳本已就緒，需決定通知管道）
  • 備份上傳目的地（Drive 權杖或 rclone remote）
    • 待辦 Backlog（依優先序）
  • 以真實金鑰跑 LLM／Places 的準確度抽樣比對
  • 補齊清單頁／夜間模式／區域雷達／切換地圖彈窗／手動新增的實機截圖複檢
  • KOL 專屬地圖公開頁與一鍵匯入（Phase 2）
  • 多人即時同步（輪詢 → 推播）
  • 照片上傳與圖釘照片牆
  • 行程匯出（日曆格式、分享連結）
  • 導購模組（需先確認金流與分潤）

    • 3. 負責與狀態

    項目負責狀態驗收證據
    MVP 範圍定義產品（葉小喨）<span class="rich-badge ok">完成</span>MVP 範圍定義文件
    前端 App工程<span class="rich-badge ok">完成</span>驗收清單 §B、§4 實機紀錄
    後端 API 與資料層工程<span class="rich-badge ok">完成</span>驗收清單 §B–§G
    管理後台工程<span class="rich-badge ok">完成</span>驗收清單 §F
    測試與驗收工程<span class="rich-badge ok">完成</span>65 項自動化測試全綠
    上線前收尾工程<span class="rich-badge ok">完成</span>上線前完成報告（Go）
    上線文件與部署包工程<span class="rich-badge ok">完成</span>上線檢查清單、冒煙 16/16、監控實跑
    雲端部署與網域產品 + 工程<span class="rich-badge warn">等待決定</span>待主機與網域；部署包與回滾演練已就緒
    交接與維運工程<span class="rich-badge ok">完成</span>交接與維運手冊
    「負責」欄目前皆為單人專案；專案規模擴大時，建議拆成「產品／前端／後端／維運」四個角色。

    4. 風險登記簿

    風險影響機率因應
    規則引擎對沒見過的文案判斷失準中中已內建「低信心度 → 候選清單 + 手動修正」出口；取得 API 金鑰後切 LLM
    地標辭典覆蓋率不足中高低信心度圖釘標記 <code>geo_confidence=low</code> 並提示校正；上線後接 Places
    單一 SQLite 的並發寫入上限低低MVP 規模足夠；已開 WAL、具備備份／還原腳本
    後台權杖外洩高低權杖不由程式碼寫死，未設定時自動產生並存檔；上線務必用環境變數
    無外部監控導致故障無人知中中已有 <code>/api/health</code> 與監控腳本；M4b 需接外部 uptime
    上線第一天帶著示範資料中低已修正：production 預設不寫入示範資料，並提供 <code>npm run wipe</code>

    5. 變更紀錄

    日期變更類型是否動到範圍
    2026-09-21加入生產強化（安全標頭、限流、就緒探針）非功能性<span class="rich-badge ok">否</span>
    2026-09-21加入冒煙測試與可用性監控腳本工具<span class="rich-badge ok">否</span>
    2026-09-21修正 Linux 檔名大小寫（Dockerfile／Caddyfile／README.md）缺陷修正<span class="rich-badge ok">否</span>
    2026-09-21修正浮動按鈕被面板遮擋（BUG-001）缺陷修正<span class="rich-badge ok">否</span>
    2026-09-21使用者指示提前納入：LLM 解析引擎功能新增（P1-7）<span class="rich-badge warn">是（經使用者指示）</span>
    2026-09-21使用者指示提前納入：Google Places 打點補強功能新增（P1-8）<span class="rich-badge warn">是（經使用者指示）</span>
    2026-09-21使用者指示提前納入：PWA 與 Android Web Share Target功能新增（P1-9）<span class="rich-badge warn">是（經使用者指示）</span>
    2026-09-21使用者指示納入：遠端備份（Drive API／rclone）功能新增（P1-10）<span class="rich-badge warn">是（經使用者指示）</span>
    2026-09-21修正分頁被收合面板遮住（BUG-003，阻斷級）缺陷修正<span class="rich-badge ok">否</span>
    2026-09-21正式環境首次啟動不再寫入示範資料缺陷修正（上線風險）<span class="rich-badge ok">否</span>
    2026-09-21使用者決定：先完成到上線前，部署另議里程碑調整（M4 拆為 M4a／M4b）<span class="rich-badge ok">否</span>
    2026-09-21使用者決定：續做完整架構，上線部署再延里程碑調整（新增 L1–L4 分層，見架構藍圖）<span class="rich-badge ok">否</span>
    2026-09-21L1 平台底層：版本化遷移、帳號系統、權限模型、API v1功能新增（P2-1）<span class="rich-badge warn">是（經使用者指示）</span>
    2026-09-21T2–T5：KOL 公開頁、一鍵匯入、照片相簿、SSE 即時協作、站內通知功能新增（P2-2）<span class="rich-badge warn">是（經使用者指示）</span>
    2026-09-21修正：大檔案上傳直接斷線（未回 413）缺陷修正<span class="rich-badge ok">否</span>
    2026-09-21修正：照片 id 不一致導致無法刪除缺陷修正<span class="rich-badge ok">否</span>
    非功能性強化與缺陷修正不動範圍；四項功能新增皆經使用者明確指示，並已同步更新 MVP 範圍定義（P1-7～P1-10）。原有 P0 完成標準一條都沒有降低。

    6. 完成定義（Definition of Done）

  • 功能可用：以真實使用者身分在正式環境操作一次不中斷。
  • 資料落地：操作後能在後台查到對應紀錄與時間。
  • 測試通過：該功能對應的端到端測試為綠燈。
  • 文件更新：上線檢查清單與交接手冊同步更新。
  • 可回復：若上線出錯，能用備份還原並說明步驟。
  • 上線前乾淨：正式環境首次啟動不含示範資料（已由自動化測試把關）。