咻揪趣 MVP · v0.19.0
Go 判定 · 文件 上線前完成報告 · 產生於 2026-09-22 15:45

上線前完成報告

版本:v0.11.0 · 狀態:Go — 上線前工作完成 · 產出時間:2026-09-21

一句話結論: 可以,而且已經做完了。這一輪把「上線前」該完成的事全部收斂到位——包含修掉一個會讓三個分頁完全不能用、以及一個會讓正式環境第一天就帶著假資料的兩個真實缺陷。剩下的只有「上線部署」這一件需要你決定的事,其他都不必再動。

1. 邊界定義:什麼算「上線前」,什麼算「上線部署」

上線前(本次已全部完成)
上線部署(待你決定後才動)
產品功能、資料層、後台、錯誤監控、備份與回滾能力
申請主機、購買網域、DNS 指向
全部自動化驗收與上線前檢查工具
在雲端執行部署、簽 TLS、設定環境變數
部署腳本與設定檔(Dockerfile/compose/Caddy/systemd)
填入真實的管理權杖、外部網域
文件:範圍、驗收、部署、交接、待辦
接第三方監控與正式金鑰(可選加速)

分界線很清楚:只要還沒申請主機與網域,就不需要動上面右欄任何一項;而左欄全部已完成並可驗證。

2. Go / No-Go 檢查表

擋上線項目
0
preflight 判定
自動化測試
65 / 65
四套合計
阻斷級缺陷
3 → 0
已修復並複驗
版本錨點
v0.11.0
可回滾
檢查項狀態依據
需求範圍凍結、P0 全數實作<span class="rich-badge ok">通過</span>MVP 範圍定義
核心流程端到端可走通<span class="rich-badge ok">通過</span>瀏覽器實機:匯入→確認→入圖;分享→預填→解析
資料落地與後台可追蹤<span class="rich-badge ok">通過</span>10 張表、事件稽核、系統日誌
驗收測試全綠<span class="rich-badge ok">通過</span>端到端 30/AI 鏈路 21/遠端備份 9/生產啟動 5
阻斷級缺陷全數關閉<span class="rich-badge ok">通過</span>BUG-001、BUG-002、BUG-003 皆已修復複驗
監控與回復能力<span class="rich-badge ok">通過</span>健康/就緒探針、可用率監控(含告警路徑)、回滾演練 10→9
版本可回滾<span class="rich-badge ok">通過</span>git 標籤 v0.9.0/v0.10.0/v0.10.1/v0.10.2/v0.11.0
交接文件完備<span class="rich-badge ok">通過</span>五份文件+README+待辦清單
上線前檢查工具<span class="rich-badge ok">通過</span>npm run preflight(0 擋上線)

3. 本輪新增與修復

1
BUG-003(阻斷級):底部導覽列被關閉狀態的面板蓋住
現象:只有地圖頁能用,「清單/行程/我的」三個分頁完全點不到。原因:收合的匯入面板仍佔據底部區域並攔截點擊。修法:關閉時加上 visibility:hiddenpointer-events:none,並讓內容區裁切溢出。複驗:分頁可正常切換,行程頁與我的頁皆正常載入。這個缺陷只有真的用滑鼠點才會發現——正是上線前實機驗收的價值。
2
正式環境的第一次啟動不再帶示範資料
原本任何環境首次啟動都會寫入 6 筆示範圖釘。現在 NODE_ENV=production 預設不寫入(要展示再設 MAPSYNC_SEED_DEMO=1),並新增 npm run wipe 清空既有示範資料。實測:production 啟動為 0 筆、明確開啟為 6 筆、wipe 後為 0 筆。
3
新增生產啟動驗證(5 項)與 preflight 資料內容檢查
把「正式環境必須是乾淨的」變成自動化斷言;preflight 也會在偵測到正式環境仍有示範資料時提出警告。

4. 實機驗證紀錄(真實瀏覽器)

流程結果
匯入連結 → 解析 → 確認 → 加入地圖<span class="rich-badge ok">通過</span> 圖釘數 6→7,後台同步出現紀錄
Android 分享 → /share 預填 → 解析<span class="rich-badge ok">通過</span> 連結與文字自動預填,解析完成並留痕
分頁切換(修復後)<span class="rich-badge ok">通過</span> 清單/行程/我的皆可切換
行程頁生成行程<span class="rich-badge ok">通過</span> 3 站、移動 16 分、距離 1.07 km,與 API 測試一致
我的頁<span class="rich-badge ok">通過</span> 13 收藏/8 已踩點/2 共同地圖、成員列、三個操作按鈕

尚未逐一實機檢視的 UI 路徑(低風險,已列入複檢清單): 清單頁的骨架與列表外觀、夜間模式、區域雷達、切換地圖彈窗、手動新增地點。這些與已驗證項目共用同一套 switchViewrenderAll 機制,但依「不以程式碼看起來正確為準」的原則,仍標記為待複檢。

5. 延後清單(等你決定時再看)

項目需要你提供恢復步驟
上線部署平台名稱、網域、平台登入或 API Token照「上線檢查清單與部署說明」執行,完成後跑 npm run preflight -- --base https://<網域>
管理權杖採用建議值或自備MAPSYNC_ADMIN_TOKEN 後重啟
解析準確率提升LLM 金鑰、Google Places 金鑰設環境變數後重啟,跑 npm run test:ai 複驗
告警通知通知管道npm run monitor 或平台健康檢查
備份上傳Drive 權杖或 rclone remote設環境變數後跑 npm run backup:remote
這五項沒有一項會擋住「產品本身完成」——它們只影響對外服務與準確率。換句話說:產品已經做完,剩下的都是環境與帳號的事。