fix(app): App 被收掉再開，行程還在但位置回報整段消失（第二十三輪）

[thothawei]

先更正一句 TODO

原本寫的是「前景服務被系統收走 → App 端沒有任何偵測」。查下去發現那句要改：服務被收走而 App 還活著時串流會停，第二十一輪的定期重評已經接住了（第二十二輪實測 12～24 秒降級）。真正沒有網的是冷啟動。

根因

init() 會用 _restoreActiveRide() 把進行中行程還原（行程卡照樣顯示「導航／已上車／完成」），但 _online 一律從 false 起、定位串流也沒起來——整趟零位置回報。

後果不在司機這一端：

• 乘客端的司機 marker 定格、ETA 不再更新
• 後端的抵達圍籬（靠司機座標自動觸發）不會觸發
• F3 里程計價的「軌跡 vs 路線取大者」缺一整段軌跡

而 hero 只寫「離線／目前不會收到派單」——在載客途中，那句話講的是接不接新單。觸發條件很日常：省電模式或廠商清背景把 App 收掉、司機自己從最近工作清單滑掉。

修法（兩個）

1. 冷啟動恢復回報，三個限制條件都寫在碼裡：
   • 只在冷啟動做（onAppResumed 刻意不做——回前景也自動上線的話，那顆離線鈕就按不掉了）
   • 只在已經有權限時做（冷啟動彈系統權限視窗太侵入）；沒權限時留一則「需要定位權限才能把位置回報給乘客」，不是「才能上線」
   • 沒有行程就不自動上線（接不接單是司機的決定）
2. refreshVehicle() 不再無條件 _setError(null)：它會把排在前面設好的訊息全洗掉，上面那句權限提示就是這樣消失的。改成只清自己造成的那則（同一種病第二十一輪在位置回報探針上修過一次）。

驗收

• flutter analyze 無 issue、flutter test 383 passed（377 ＋新 6）。
• 反向驗證兩半各一次：拿掉冷啟動恢復 → 2 案 FAIL；讓 refreshVehicle 回去無條件清錯誤 → 2 案 FAIL。
• 模擬器實跑：同一台裝置、同一張行程 docs: 下次任務 to-do list（T1–T5）＋README 功能進度重整 #37，兩個版本各跑一次

時刻	事件	後端收到的位置回報
23:21:29–23:22:22	上線＋接單 #37	每 8 秒一筆
23:22:25	am force-stop（模擬系統收掉 App）	停止
23:23:15	修好的版本冷啟動	23:23:23 起恢復，hero「上線中」＋行程卡
23:24:41	修改前的版本冷啟動（同一張單）	40 秒零筆，行程卡完整、hero 卻寫「離線」

• 負向對照：沒有進行中行程時冷啟動 → 後端零位置回報。
• dev DB 收乾淨（ride docs: 下次任務 to-do list（T1–T5）＋README 功能進度重整 #37 已取消為終態、司機回 Available）。

過程中踩到的一條（已寫進 TODO）

接縫的預設實作會跑進測試環境：我一開始讓冷啟動直接 await 平台權限確認，driver_home_widget_test 從 4.8 秒變成 7 分鐘以上——測試環境沒有 platform channel，那支呼叫的 Future 永遠不會完成。預設探針現在先看 FLUTTER_TEST 回「查不到」，並用三態（null／denied／granted）區分「查不到」與「被拒絕」。

🤖 Generated with Claude Code