From e432b812dc87eab7437663fa3686e397051a9dfe Mon Sep 17 00:00:00 2001 From: awei Date: Wed, 29 Jul 2026 21:23:05 +0800 Subject: [PATCH] =?UTF-8?q?docs(todo):=20T2=EF=BC=8FT3=20=E5=B7=B2?= =?UTF-8?q?=E4=BF=AE=EF=BC=88PR=20#59=EF=BC=89=EF=BC=8C=E7=AB=A0=E7=AF=80?= =?UTF-8?q?=E6=A8=99=E9=A1=8C=E5=90=8C=E6=AD=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 5 --- docs/TODO.md | 20 ++++++++++++-------- 1 file changed, 12 insertions(+), 8 deletions(-) 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`),派單距離以最後回報的那台為準;