Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 12 additions & 8 deletions docs/TODO.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 裡,
Expand Down Expand Up @@ -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:<id>: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:<id>:loc`),派單距離以最後回報的那台為準;
Expand Down
Loading