diff --git a/docs/TODO.md b/docs/TODO.md index ff0efc3..85e5779 100644 --- a/docs/TODO.md +++ b/docs/TODO.md @@ -999,7 +999,7 @@ admin 端對應:fleet-frontEnd PR #22(司機管理頁評價欄、訂單詳情評分卡)。 -## 🎫 T. App 端實跑回報的後端缺口(2026-07-29 記錄,**尚未實作**) +## 🎫 T. App 端實跑回報的後端缺口(2026-07-29 記錄,**T1/T4 待處理,其餘已修**) > 來源:fleet-app 的搶單/多裝置/弱網三輪 debug(app PR #62–#66)。 > 這些缺口**都是對真後端逐則印 payload 查證出來的**,但先前只寫在 App 的 TODO 裡, @@ -1031,13 +1031,17 @@ admin 端對應:fleet-frontEnd PR #22(司機管理頁評價欄、訂單詳 App 端現行防線是「接單後一律重讀 `rides/active`、以後端有沒有這張單判定成敗」—— **多打一支 API 才換得到正確性**,且逾時時仍要再對帳一次。 改成 409 之後 App 那條退路可以留著(無害),但錯誤處理會單純很多。 -- [ ] **T2. 沒搶到的司機收不到任何事件**。一輪 `dispatchRound` 會把同一張單同時推給半徑內 - 每一位待命司機,但 `ride.accepted` **只送給接到的那位**。其他人的全螢幕接單卡 - 沒有任何東西可以把它收掉——只有他自己按下接單、或剛好收到同一 rideId 的 - `ride.cancelled`/`ride.completed` 時才會消失。 - 建議:對「本輪收到 offer 但沒接到」的司機補送 `ride.taken`, - 或在 `ride.assigned` 的 payload 帶 `offer_expires_at` 讓 App 自己倒數收卡。 -- [ ] **T3. 逾時取消(`giveUpIfUnaccepted`)只通知乘客**,司機端同 T2。 +- [x] **T2. 沒搶到的司機收不到任何事件**(PR #59,2026-07-29)。一輪 `dispatchRound` 會把 + 同一張單同時推給半徑內每一位待命司機,但 `ride.accepted` **只送給接到的那位**—— + 其他人的全螢幕接單卡沒有任何東西收得掉,他得自己按下去拿到「手慢了」才會消失, + 期間卡片蓋著整個畫面。**每一趟車都會發生在所有沒搶到的司機身上。** + **根因**:`dispatchRound` 的 `offered` 只是遞迴中的記憶體 map,接單/取消流程拿不到。 + **改法**:Redis 加 `ride::offered`(比照既有的 `rejected`,同 30 分鐘 TTL), + `pushOffer` 時記錄;接單時對「除了接單者以外」的人送新事件 **`ride.taken`**,送完清集合。 + **不能用 `ride.cancelled` 代替**——訂單沒取消,只是不是他的了。 +- [x] **T3. 逾時取消(`giveUpIfUnaccepted`)只通知乘客**(PR #59,同批)。 + 改為對所有收過 offer 的司機送 `ride.cancelled`(App 端既有處理就能收掉卡片); + **乘客/客服在還沒人接單時取消**(`status=Assigned`)先前同樣沒人通知,一併補上。 - [ ] **T4.(產品決策)多裝置同帳號**。Hub 依 (角色, id) 扇出,**每一條連線都收得到事件**, 沒有踢舊 session 的機制(JWT 無狀態)。實務影響有兩個: ① 兩台同時上線時**位置互相覆蓋**(Redis 單一 `driver::loc`),派單距離以最後回報的那台為準;