Skip to content

fix(driver): 別處做的動作,這台也要跟上(多裝置/跨管道) - #61

Closed
thothawei wants to merge 1 commit into
claude/accept-create-outcome-reconcilefrom
claude/driver-multi-device-sync
Closed

thothawei wants to merge 1 commit into
claude/accept-create-outcome-reconcilefrom
claude/driver-multi-device-sync

Conversation

@thothawei

Copy link
Copy Markdown
Owner

⚠️ 第四層 stacked PR:base 是 claude/accept-create-outcome-reconcile(#60)→ #59 → #58。合併順序 #58 → #59 → #60 → 本 PR。
需要後端同批:fleet-dispatch#53(ride.stop_updated 原本只推給乘客)。

先推翻自己的假設

原本猜「後端可能只保留最後一條 WS 連線 → 兩台互踢無限循環」。讀 internal/events/hub.go 查證後不成立:Hub 是 map[*Client]bool,同一個 driver id 的每一條連線都會收到事件,不覆蓋也不互踢。所以多裝置本來就被支援,真正的問題是事件到了卻沒人處理。

兩個缺口(不只多裝置,LINE 那條路徑同樣會踩)

  1. 別處接了單,這台毫無反應。ride.accepted 的收件人就是「接單的那個司機」,所以這台收到它=「我在別的地方接了這張單」。舊碼只在 _activeRide?.rideId == event.rideId 時處理(只認自己這台接的),其他情況什麼都不做:接單卡繼續留在畫面上、行程卡不出現。
  2. 別處標記了停靠點,這台停在舊的「下一站」。乘客端早就會收 ride.stop_updated 並更新進度,司機端連這個 case 都沒有——而「下一站」正是司機端唯一給操作的那一站。

改了什麼

  • ride.accepted 不是自己這台接的 → 收掉接單卡 + 以後端為準重讀 active(事件 payload 不含全程 stops,重讀才會齊全)。
  • 新增 ride.stop_updated 的處理:同一張單就重讀 active。
  • 缺口 2 需要後端配合:該事件原本只推給乘客,所以這段在舊後端下是死碼(實跑當場證實)。後端修正在 dispatch#53。

驗收

  • flutter analyze 無 issue、flutter test 261 passed(257 +新 4)。新增 test/driver_multi_device_test.dart。
  • 反向確認:兩處修正各自拿掉後 2 案 FAIL。
  • 模擬器實跑(2 乘客 4 站的 ride docs: 聊天/遺失物模擬器實跑(雙 flavor E2E)+3 個實跑發現 #9):
    • 別台接單:App 亮著接單卡 → 用同一司機的 API token 接單 → 司機沒按任何按鈕,接單卡自動消失、行程卡自動出現且含完整 4 站清單與多點地圖。
    • 別處標記停靠點:舊後端下標記第 1 站 → 8 分鐘後畫面完全沒動(缺口 2 的實證);換上 dispatch#53 的後端後標記第 2 站 → 5 秒內前兩站變綠勾「已完成」、下一站前移、地圖重畫。

查了但沒動(屬後端/產品決策)

  • 兩台同時上線時位置互相覆蓋(Redis 單一 driver:<id>:loc),派單距離會以最後回報的那台為準。
  • 後端沒有踢舊 session 的機制(JWT 無狀態)。要不要「一個帳號只能一台上線」是產品決策,不該由 App 端片面實作。

🤖 Generated with Claude Code

@thothawei
thothawei force-pushed the claude/accept-create-outcome-reconcile branch from 8fd7b15 to befe3c4 Compare July 28, 2026 13:33
先推翻自己的假設:原本猜後端可能只保留最後一條 WS 連線而兩台互踢,
讀 internal/events/hub.go 後不成立——Hub 是 map[*Client]bool,
同一個 driver id 的每條連線都會收到事件。真正的問題是事件到了沒人處理:

1. ride.accepted 的收件人就是「接單的那個司機」,所以這台收到它
   =我在別的地方接了這張單。舊碼只認自己這台接的,其他情況什麼都不做:
   接單卡繼續留著、行程卡不出現,司機以為還沒接到。
2. ride.stop_updated 司機端完全沒處理,畫面停在舊的「下一站」——
   而那正是唯一給操作的一站,兩台會對不同的站給按鈕。

修法:accepted 不是自己這台接的 → 收掉接單卡並以後端為準重讀 active
(事件不含全程 stops,重讀才齊全);新增 stop_updated 的處理。
缺口 2 需要後端配合(dispatch PR #53:該事件原本只推給乘客)。

驗收:flutter analyze 無 issue、flutter test 261 passed(新增 4);
反向確認兩處修正各自拿掉後 2 案 FAIL。
模擬器實跑:亮著接單卡時用同一司機的 API token 接單 → 沒按任何按鈕,
接單卡消失、行程卡帶完整 4 站出現;舊後端下標記停靠點 8 分鐘畫面沒動,
換上 PR #53 的後端後 5 秒內整份清單跟上。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@thothawei

Copy link
Copy Markdown
Owner Author

以 #63(合併為 #65)取代:ride.accepted 的多裝置處理(別台接走時收掉接單卡+重讀 active)在 #63 已落地。

本 PR 獨有、已救回(#66):司機端處理 ride.stop_updated。後端側的 dispatch#53 也已合併,兩端齊備。

@thothawei thothawei closed this Jul 29, 2026
thothawei added a commit that referenced this pull request Jul 29, 2026
* fix(ws): 補上客戶端心跳,讓半開連線偵測得到(救回 PR #59 獨有的修正)

半開連線(對端沒了但本地收不到 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>

* fix(driver): 停靠點在別處被標記時,這台也要跟上(救回 PR #61 獨有的修正)

同一司機的第二台裝置或 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>

* fix(customer): 建單 409 也去跟後端對帳,並與建單成功共用狀態切換(救回 PR #60 獨有的修正)

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>

* docs(app): 回填 PR 佇列稽核——兩條 stack 撞題、去重與救回的三項

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5 <noreply@anthropic.com>
@thothawei
thothawei deleted the claude/driver-multi-device-sync branch July 29, 2026 06:58
thothawei added a commit that referenced this pull request Jul 29, 2026
FirebaseFleetPushService 用 StreamController.broadcast(),而廣播串流在沒有訂閱者的
當下 add 的事件會直接消失(Dart 不緩衝)。冷啟動的順序正好是這樣:

  main() → createXxxPushService() → initialize() → getInitialMessage() → _events.add(事件)
         → runApp() → Controller.init() → ... → rideEvents.listen(...)

getInitialMessage() 是「App 被殺 → 點通知 → 冷啟動」唯一的取得管道,
而它在 runApp 之前就送出去了。於是司機端「被殺 → 點推播 → 接單卡」(A2 的招牌情境)
與乘客端「點推播 → 跟後端對帳」(第十一輪剛接好的)兩條都是死路徑——
兩端寫好的處理都在,缺的是事件本身。

改法:新增 PendingReplaySink,沒有訂閱者時留著**最後一則**,第一個訂閱者上來時
用 microtask 補送(onListen 在訂閱建立過程中被呼叫,當下同步 add 不保證送得到)。
補送過就丟掉,登出後重新訂閱不會再收到同一則。

驗收:flutter analyze 無 issue、flutter test 317 passed(312+新 5)。
反向確認:把 add 退回普通廣播行為,3 案 FAIL。
真裝置端到端仍卡 google-services.json(同 A2)——這批修的是純 Dart 串流語意,不需憑證。

文件:TODO 第十二輪專段、README 回填後端送出路徑已補(dispatch #61)與測試數 317。

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