スモークテストチェックリスト

Tracker Smoke Test Checklist

版本 v1.1 | 2026-04-04 | 新增 RFC #100 項目 + 語系驗證

三個層級,依情境選用。測試前一律 hard refresh(CDN max-age=3600)。


Level 1:部署後快速驗證(每次 deploy,2 分鐘)

只驗「這次改動有碰到的功能」。Code session 部署完後立刻跑,結果寫進 worklog。

區塊 驗證項目
進入流程 密碼解鎖正常、頁面能載入
GPS banner 出現、打卡按鈕可按
公仔 圖片大小正常(120×120px)、等級名稱有顯示
問卷 卡片能翻頁、進度條更新
獎勵卡 公仔大小正常(150×150px)、統計有帶入
碳足跡 展開/收合正常、欄位可填
足跡頁 /my/ 能載入、地圖有渲染
隱私聲明 版本號有顯示(v0.2)
語系驗證 至少抽查一個非中文語系頁面能載入

規則:只勾這次改到的區塊。 例如改了 CSS → 驗公仔 + 獎勵卡。改了 GPS 邏輯 → 驗 GPS + 足跡頁。


Level 2:每週回歸測試(4/12 前每週一次,10 分鐘)

全部項目跑一遍,抓「改 A 壞 B」的隱性 bug。

  • 密碼頁能正常輸入、解鎖
  • LINE Login 按鈕有出現(LIFF 環境下)
  • 測試模式 banner 有顯示(非正式活動期間)
  • GPS banner 出現「定位中」或「追蹤中」
  • GPS 記錄次數有在累加
  • 打卡按鈕可點擊,點擊後有成功動畫
  • 打卡模式:公仔圖片大小正常,不會撐滿螢幕
  • 公仔下方有等級名稱 badge
  • 10 題卡片能正常前後翻頁
  • 進度條有跟著更新
  • 照片拍攝 / 選取按鈕可用
  • 確認提交按鈕能送出
  • 提交後獎勵卡有顯示
  • 獎勵卡上的公仔圖片大小正常
  • 等級名稱、統計數據有正確帶入
  • 分享按鈕可用
  • 「今日善足跡回報」區塊可展開 / 收合
  • 輸入欄位可正常填寫數字
  • /my/ 足跡頁能正常載入
  • 地圖有渲染、統計數據有顯示
  • Safari(iPhone)正常
  • LINE in-app browser 正常
  • Chrome(Android)正常
  • 隱私聲明頁面載入正常,版本號 v0.2 有顯示
  • 隱私聲明:KV TTL 3 天說明有出現(第七條安全措施第 5 項)
  • 隱私聲明:Geofence 範圍比對說明有出現(第三條特別說明第 3 項)
  • 隱私聲明:EXIF 措辭為「瀏覽器端提取」(第三條照片欄位)
  • 英文版 /en/ 隱私聲明能載入,標題含 "Privacy Policy"
  • 日文版 /ja/ 隱私聲明能載入,標題含「プライバシー」
  • 簡中版 /zh-cn/ 隱私聲明能載入
  • /health 端點回傳 d1: ok, kv: ok
  • Service Worker 已註冊(DevTools → Application → Service Workers)
  • 離線時顯示友善中文提示頁(斷網後重新整理)

Level 3:上線前驗收(4/11,30 分鐘)

Level 2 全部項目 + 以下壓力情境:

  • 快速連按打卡 5 次,不會重複計數或報錯
  • GPS 斷線後重連,追蹤能恢復
  • 問卷填到一半跳出,再進來能從上次位置繼續
  • 成就卡分享到 LINE / FB 連結正常、OG 圖正確
  • 清除 localStorage 後重進,密碼頁有出現(不會跳過)
  • Dashboard 地圖熱力圖 / 聚類 / 前鋒尾巴三模式切換正常
  • 同時開兩個瀏覽器 tab,打卡不會互相干擾
  • 等級從 Lv.1 打到 Lv.2 的升級動畫有觸發
  • 測試模式 banner 在活動日期到了之後會自動隱藏
  • 4 語系隱私聲明頁內容一致性抽驗(隨機選 2 段落比對)
  • /health 的 lastFlush 時間在 30 分鐘內
  • LINE Bot 傳「幫助」有回覆使用說明
  • LINE Bot 傳「排行」有回覆排行榜
  • 成就卡達標條件驗證:打卡 ≥3 + 問卷完成 + 有留電話
  • Geofence 在進香路線外打卡,不產生路徑記錄
  • Admin PUT /api/formosa/admin/status 可切換 active/paused
  • 活動結束流程:POST /api/formosa/admin/end-activity 正常執行

使用方式

時機 層級 誰跑 結果記在哪
每次 wrangler deploy Level 1 Code session worklog 當日條目
每週固定一次 Level 2 Cowork 或 Paul handoffs/ 裡的驗證紀錄
4/11 上線前一天 Level 3 Paul + Cowork 協作 獨立驗收報告

任何一項 fail → 截圖 + 裝置型號 → 寫進 handoff → 交 Code session 修復。

隱私權聲明問題回報
EN