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 修復。