Skip to content

fix(app): 救回重複 stack 裡獨有的三項(WS 心跳/建單 409 對帳/司機端停靠點同步) - #66

Merged
thothawei merged 4 commits into
mainfrom
claude/fleet-improvements-todo-cc8d85
Jul 29, 2026
Merged

thothawei merged 4 commits into
mainfrom
claude/fleet-improvements-todo-cc8d85

Conversation

@thothawei

Copy link
Copy Markdown
Owner

這一輪的題目不是「再寫什麼」,是「做完的東西沒進 main」

盤點三個 repo 的實際狀態(開工第一件事是 gh pr list):

repo open PR CI
fleet-app 6 支(#59–#64) 全綠,#59 為 BLOCKED
fleet-dispatch 2 支(#53/#54) 全綠
fleet-frontEnd(admin) 0 支 —

而且那 6 支是兩條互相撞題的 stack:

stack PR 內容
A #59 → #60 → #61 回前景對帳/接單建單對帳/司機多裝置
B #62 → #63 → #64 回前景對帳/搶單假行程卡/弱網

#59 與 #62 是同一個功能的兩份獨立實作——連新檔名都一樣(lib/shared/widgets/app_lifecycle_reactor.dart),由兩個平行 worktree 的 session 在兩小時內各做了一次。往上疊的 #60/#61 與 #63/#64 也大量重疊。兩條都合會直接衝突。

做了什麼

  1. 合併 B 條全部(fix(app): 回前景後不再停在背景前的舊狀態——立刻重連 WS + 跟後端對帳 #62 → fix(driver): 沒搶到的單不再給司機一張假的行程卡 #65〔原 fix(driver): 沒搶到的單不再給司機一張假的行程卡 #63〕 → fix(app): 弱網下不再堆請求、不再謊稱「等待派單中」、逾時後跟後端對帳 #64)與 dispatch feat(customer): 接住 ride.redispatched——司機放棄時說明並清掉舊司機資訊 #53/docs(app): 回填 2026-07-28 的 debug 成果與跨端契約對帳結論 #54。
  2. 關閉 A 條(fix(app): 回到前景時對帳,並讓 WS 偵測得到半開連線 #59/fix(app): 接單與建單的結果要向後端確認,不能只看有沒有丟例外 #60/fix(driver): 別處做的動作,這台也要跟上(多裝置/跨管道) #61)之前,先逐條比對 diff 把它獨有的三項救回來——本 PR 的內容。「看起來被取代」不等於「內容都在」,這是清殘留分支那次的教訓。

救回的三項(本 PR)

救自 修正 機制
#59 WS 客戶端心跳(pingInterval 20 秒) 半開連線(對端沒了但本地收不到 FIN)不會 onDone/onError,重連鏈根本不會啟動,isConnected 仍是 true——司機靜靜地收不到派單。後端只做了另一半(writePump 每 54 秒 ping、60 秒沒 pong 砍連線),那保護的是伺服器不留死連線。B 條的「回前景立刻重連」補不到這個洞(人沒切走就不會觸發)。
#60 建單 409 也去對帳 + 接手時與建單成功共用狀態切換 409「已有進行中的訂單」是後端在明說有單、而畫面上一張都沒有(多半是上一次逾時其實建成了,或訂單來自 LINE/另一台裝置)。#64 只對帳連線類(statusCode == null),409 只顯示訊息=死路:再按一次還是 409。另外接手原本只做 _applyActiveRide,編輯中的多乘客清單與預估車資會留到下一趟。
#61 司機端處理 ride.stop_updated #63 收掉了 ride.accepted 的多裝置缺口,停靠點沒有。兩台裝置會停在不同的「下一站」,而那是司機端唯一給操作鈕的一站。後端側同批合併 dispatch#53(該事件原本只推給乘客)。

驗收

  • flutter analyze 無 issue、flutter test 277 passed(268 +新 9)。
  • 新增 test/driver_stop_updated_test.dart(3 案)、test/customer_create_conflict_test.dart(4 案)、test/fleet_ws_client_test.dart 兩案(心跳)。
  • 反向確認:拿掉 ride.stop_updated 處理 → 1 案 FAIL;拿掉 409 分支 → 2 案 FAIL。心跳那案先斷言預設 pingInterval 為 null 再斷言設定後的值,避免寫出恆真的斷言。
  • 誠實標記:這三項都沒有模擬器實跑。半開連線要斷網卡層級的手法才造得出來,409 與跨裝置停靠點需要兩台裝置+後端;目前只有單元測試與反向確認覆蓋(已寫進 TODO 的「下一次開工先做」)。

兩個 GitHub 操作坑(已寫進 TODO,下次做 stacked PR 前先看)

  1. --delete-branch 會連帶關閉以該分支為 base 的 PR:合併 fix(app): 回前景後不再停在背景前的舊狀態——立刻重連 WS + 跟後端對帳 #62 的當下 fix(driver): 沒搶到的單不再給司機一張假的行程卡 #63/fix(app): 弱網下不再堆請求、不再謊稱「等待派單中」、逾時後跟後端對帳 #64 立刻被關,而且重開被拒(Cannot reopen / Cannot change the base branch of a closed pull request),只能 rebase 後另開新 PR(fix(driver): 沒搶到的單不再給司機一張假的行程卡 #63 → fix(driver): 沒搶到的單不再給司機一張假的行程卡 #65)。之後改用「合併時不刪分支 → 下一支 rebase 到 main → gh pr edit --base main → 再刪舊分支」,fix(app): 弱網下不再堆請求、不再謊稱「等待派單中」、逾時後跟後端對帳 #64 的編號就保住了。
  2. CI 不會跑:workflow 的 pull_request: branches: [main] 是 base 分支過濾器,stacked PR 的 base 不是 main 時 push 不觸發;改 base 也不補觸發(edited 不在預設 types)。要 gh pr close 再 gh pr reopen。

文件

docs/TODO.md 新增「🧾 2026-07-29 PR 佇列稽核」專段並更新「下次任務」;README 的測試數(230 → 277)與現況段同步,並加上「開工前先看 PR 佇列」這條。

🤖 Generated with Claude Code

thothawei and others added 4 commits July 29, 2026 14:13
半開連線(對端沒了但本地收不到 FIN)不會觸發 onDone/onError,重連鏈永遠不啟動,
isConnected 仍是 true——司機靜靜地收不到派單。後端只做了另一半(54 秒 ping、
60 秒沒 pong 就砍連線),保護的是伺服器不留死連線。

改用 IOWebSocketChannel 並設 pingInterval=20 秒(對齊後端派單 offer 逾時的數量級),
收不到 pong 就關閉連線 → 走既有重連鏈。

測試:enableKeepAlive 在真 socket 上開啟 ping(先校準預設為 null,斷言非恆真)、
預設 connector 仍連得上且收得到事件。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
同一司機的第二台裝置或 LINE 那條路徑標記到達/跳過時,這台的司機端不處理
ride.stop_updated——兩台會停在不同的「下一站」,而那正是唯一給操作按鈕的一站。
乘客端早就會收這則事件。後端側已於 dispatch#53 補推給司機。

修法:同一張單就以後端重讀 active(payload 沒有 phase/車資等欄位,重讀最不易對不齊),
失敗靜默(不是使用者按出來的動作,橫幅只會在他開車時干擾)。

測試:新增 driver_stop_updated_test.dart 3 案;反向確認拿掉修正後第 1 案 FAIL。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
409「已有進行中的訂單」是後端在明說有單,而乘客畫面上一張都沒有——多半是上一次
逾時其實建成了,或訂單來自 LINE/另一台裝置。只把這句話原樣顯示,乘客無路可走:
再按一次還是 409,唯一出路是重開 App。

同時把建單成功的狀態切換抽成 _applyCreatedRide 與「接手既有訂單」共用——
原本接手只做 _applyActiveRide,編輯中的多乘客清單、預估車資、上一趟的取消通知
都會留著帶進下一次叫車。

測試:新增 customer_create_conflict_test.dart 4 案;反向確認拿掉 409 分支後 2 案 FAIL。
全套 flutter analyze 無 issue、flutter test 277 passed。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@thothawei
thothawei merged commit ce46879 into main Jul 29, 2026
2 checks passed
@thothawei
thothawei deleted the claude/fleet-improvements-todo-cc8d85 branch July 29, 2026 06:20
thothawei added a commit that referenced this pull request Jul 31, 2026
1. 造大量測試行程改用 tool/seed_customer_rides.sh:叫車限流(5 次/分)、
   「已有進行中訂單」、建單回應是 ride_id 不是 id——三個都不會讓迴圈停下來,
   自己寫 for 迴圈會整批靜默失敗還印得像成功。腳本建單失敗直接 exit 1 並印回應。
   已用 seed_customer_rides.sh 3 實跑驗過(ride #66-#68,全部已取消)。

2. 本機後端跑法更正為 REDIS_ADDR=127.0.0.1:6380:6379 會靜默連到 Mac 本機的
   redis-server(已用 raw socket 對兩台寫 whoami 鍵驗死)。容器改發布 6380 見
   dispatch PR #72。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant