From df7771890143c79c400cf3ccb81db9c2957217f2 Mon Sep 17 00:00:00 2001 From: awei Date: Wed, 29 Jul 2026 14:21:34 +0800 Subject: [PATCH 1/2] =?UTF-8?q?docs(todo):=20=E8=A3=9C=E8=A8=98=20App=20?= =?UTF-8?q?=E7=AB=AF=E5=AF=A6=E8=B7=91=E6=9F=A5=E5=87=BA=E7=9A=84=E5=9B=9B?= =?UTF-8?q?=E5=80=8B=E5=BE=8C=E7=AB=AF=E7=BC=BA=E5=8F=A3=EF=BC=88T1?= =?UTF-8?q?=E2=80=93T4=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit App 的搶單/多裝置/弱網三輪 debug 對真後端逐則印 payload 查出四件事, 但先前只寫在 fleet-app 的 TODO:接單/放棄失敗回 200+文案(應為 409)、 沒搶到的司機收不到任何事件、逾時取消只通知乘客、多裝置位置互相覆蓋且無踢舊 session。 後端這份清單上沒有它們,等於這些缺口沒人會排進後端的工作。 ride.stop_updated 只推乘客那一項已於 PR #53 修掉,一併標記。 Co-Authored-By: Claude Opus 5 --- docs/TODO.md | 34 ++++++++++++++++++++++++++++++++++ 1 file changed, 34 insertions(+) diff --git a/docs/TODO.md b/docs/TODO.md index e361a52..3297864 100644 --- a/docs/TODO.md +++ b/docs/TODO.md @@ -999,6 +999,40 @@ admin 端對應:fleet-frontEnd PR #22(司機管理頁評價欄、訂單詳情評分卡)。 +## 🎫 T. App 端實跑回報的後端缺口(2026-07-29 記錄,**尚未實作**) + +> 來源:fleet-app 的搶單/多裝置/弱網三輪 debug(app PR #62–#66)。 +> 這些缺口**都是對真後端逐則印 payload 查證出來的**,但先前只寫在 App 的 TODO 裡, +> 後端這份清單上沒有——所以在這裡補記。App 端已各自做了防線, +> 下面每一項都寫明「後端不改的話,App 只能做到什麼程度」。 + +**已修(同批合併)**: +- [x] **`ride.stop_updated` 只推給乘客**(PR #53)。`publishStops` 的註解假設「司機剛做完動作、 + 會自己重讀 active」——那句話假設司機只有一台裝置。已改為乘客與司機各推一則。 + +**待處理**: + +- [ ] **T1. 接單/放棄失敗回 HTTP 200 + 文案**(應為 409)。 + `AcceptRide` 對「已被別人接走」「非待命狀態」回的是 200+`{"message":"手慢了…"}`, + 放棄不成時同樣。**後果**:App 若只看有沒有丟例外,沒搶到的司機會拿到一張 + 完整但**假的**行程卡(他會開去接一個不存在的乘客)。 + 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。 +- [ ] **T4.(產品決策)多裝置同帳號**。Hub 依 (角色, id) 扇出,**每一條連線都收得到事件**, + 沒有踢舊 session 的機制(JWT 無狀態)。實務影響有兩個: + ① 兩台同時上線時**位置互相覆蓋**(Redis 單一 `driver::loc`),派單距離以最後回報的那台為準; + ② 要不要「一個帳號只能一台上線」屬產品決策,**不該由 App 端片面實作**。 + +--- + ## 下次任務 **新需求(2026-07-16 加入,尚未實作,皆需後端地基先行)**: From 819a83f55f7f08a7bb4178d6fb7a8013963cb1b0 Mon Sep 17 00:00:00 2001 From: awei Date: Wed, 29 Jul 2026 18:19:57 +0800 Subject: [PATCH 2/2] =?UTF-8?q?fix(dispatch):=20=E4=B9=98=E5=AE=A2?= =?UTF-8?q?=E5=8F=96=E6=B6=88=E5=B7=B2=E6=8E=A5=E7=9A=84=E8=A8=82=E5=96=AE?= =?UTF-8?q?=E6=99=82=E4=B9=9F=E9=80=9A=E7=9F=A5=20App=20=E5=8F=B8=E6=A9=9F?= =?UTF-8?q?=EF=BC=88=E5=85=88=E5=89=8D=E5=8F=AA=E6=8E=A8=20LINE=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit cancelActiveRide 的「通知司機」只有 line.PushText,App 司機一則 WS 事件都收不到。 司機端沒有任何輪詢(進行中行程全靠 WS),行程卡因此永遠留在畫面上—— 他會繼續開往上車點接一個已經取消的乘客,直到按下「乘客已上車」被後端擋下才知道; 而後端在取消當下就已經把他放回 Idle,畫面與真實狀態完全相反。 這是 dispatch#52(司機放棄只推 LINE、App 乘客收不到)在司機側的鏡像。 App 端本來就有 ride.cancelled 的處理,缺的一直是這則事件。 測試:新增兩案(已接訂單時乘客與司機各收到一則、未派單時不推給司機)。 Co-Authored-By: Claude Opus 5 --- internal/service/dispatch.go | 13 ++- .../dispatch_cancel_by_customer_test.go | 87 +++++++++++++++++++ 2 files changed, 99 insertions(+), 1 deletion(-) diff --git a/internal/service/dispatch.go b/internal/service/dispatch.go index 3a77259..ab18b72 100644 --- a/internal/service/dispatch.go +++ b/internal/service/dispatch.go @@ -424,8 +424,19 @@ func (s *DispatchService) cancelActiveRide( RideID: ride.ID, }) - // 若已派給司機,通知司機 + // 若已派給司機,通知司機。 + // + // **WS 與 LINE 兩條都要送**:這裡先前只有 `line.PushText`,App 司機一則事件都收不到。 + // 司機端**沒有任何輪詢**(進行中行程全靠 WS),所以行程卡會一直留在畫面上—— + // 他會繼續開往上車點去接一個已經取消的乘客,直到按下「乘客已上車」被後端擋下才知道。 + // 後端這時早已把他放回 Idle(releaseAndReset),畫面與真實狀態完全相反。 + // 與 CancelByDriver 只推 LINE 給乘客是同一個 bug(dispatch#52 已修乘客那一側), + // 這是它在司機側的鏡像。App 端本來就有 ride.cancelled 的處理,缺的一直是這則事件。 if ride.DriverID != nil { + s.publish(events.Recipient{Role: events.RoleDriver, ID: *ride.DriverID}, events.Event{ + Type: events.TypeRideCancelled, + RideID: ride.ID, + }) if d, e := s.drivers.FindByID(*ride.DriverID); e == nil { _ = s.line.PushText(ctx, d.LineUserID, fmt.Sprintf("訂單 #%d 已被取消", ride.ID)) } diff --git a/internal/service/dispatch_cancel_by_customer_test.go b/internal/service/dispatch_cancel_by_customer_test.go index 3176c6a..9f6e1ef 100644 --- a/internal/service/dispatch_cancel_by_customer_test.go +++ b/internal/service/dispatch_cancel_by_customer_test.go @@ -6,6 +6,7 @@ import ( "testing" "line-fleet-dispatch/internal/constants" + "line-fleet-dispatch/internal/events" lineclient "line-fleet-dispatch/internal/line" "line-fleet-dispatch/internal/repository" ) @@ -159,3 +160,89 @@ func TestCancelByCustomerID_本人取消釋放鎖與司機回待命(t *testing.T t.Fatalf("預期取消後搶單鎖已釋放,其他司機應能搶到鎖") } } + +// TestCancelByCustomerID_通知App司機 乘客取消**已接**的訂單時,App 司機也必須收到事件。 +// +// 這條先前只推 LINE(`line.PushText`),App 司機一則 WS 事件都收不到。 +// 司機端**沒有任何輪詢**(進行中行程全靠 WS),所以行程卡會一直留在畫面上—— +// 他會繼續開往上車點接一個已經取消的乘客,直到按下「乘客已上車」被後端擋下才知道; +// 而後端這時早已把他放回 Idle。這是 dispatch#52(司機放棄只通知 LINE)在司機側的鏡像。 +func TestCancelByCustomerID_通知App司機(t *testing.T) { + db := newServiceTestDB(t) + redisStore := newServiceTestRedis(t) + customers := repository.NewCustomerRepository(db) + drivers := repository.NewDriverRepository(db) + rides := repository.NewRideRepository(db) + fp := &fakePublisher{} + dispatch := NewDispatchService(drivers, rides, customers, redisStore, + lineclient.NewClient(""), nil, NewDispatchSettings(3000, 5, 20, 1, 5), fp) + + cust, err := customers.FindOrCreateByLineUserID("U_cancel_notify_cust", "乘客") + if err != nil { + t.Fatalf("建立乘客失敗:%v", err) + } + drv, err := drivers.FindOrCreate("U_cancel_notify_drv", "司機") + if err != nil { + t.Fatalf("建立司機失敗:%v", err) + } + ride := newTestRide(t, rides, cust.ID, constants.RideStatusRequested) + if err := rides.AcceptRide(ride.ID, drv.ID, 300); err != nil { + t.Fatalf("接單失敗:%v", err) + } + + if _, err := dispatch.CancelByCustomerID(context.Background(), cust.ID, ride.ID); err != nil { + t.Fatalf("乘客取消應成功:%v", err) + } + + var toCustomer, toDriver *events.Event + for i := range fp.recv { + r := fp.recv[i] + if r.Ev.Type != events.TypeRideCancelled { + continue + } + switch { + case r.Rec.Role == events.RoleCustomer && r.Rec.ID == cust.ID: + toCustomer = &fp.recv[i].Ev + case r.Rec.Role == events.RoleDriver && r.Rec.ID == drv.ID: + toDriver = &fp.recv[i].Ev + } + } + if toCustomer == nil { + t.Fatalf("乘客沒收到 %s;實際發佈:%+v", events.TypeRideCancelled, fp.recv) + } + if toDriver == nil { + t.Fatalf("**司機**沒收到 %s——他的行程卡會一直留著;實際發佈:%+v", + events.TypeRideCancelled, fp.recv) + } + if toDriver.RideID != ride.ID { + t.Fatalf("司機收到的事件 ride_id 應為 %d,得到 %d", ride.ID, toDriver.RideID) + } +} + +// TestCancelByCustomerID_未派單時不推司機 還沒有司機的訂單不該憑空推給誰。 +func TestCancelByCustomerID_未派單時不推司機(t *testing.T) { + db := newServiceTestDB(t) + redisStore := newServiceTestRedis(t) + customers := repository.NewCustomerRepository(db) + drivers := repository.NewDriverRepository(db) + rides := repository.NewRideRepository(db) + fp := &fakePublisher{} + dispatch := NewDispatchService(drivers, rides, customers, redisStore, + lineclient.NewClient(""), nil, NewDispatchSettings(3000, 5, 20, 1, 5), fp) + + cust, err := customers.FindOrCreateByLineUserID("U_cancel_nodrv_cust", "乘客") + if err != nil { + t.Fatalf("建立乘客失敗:%v", err) + } + ride := newTestRide(t, rides, cust.ID, constants.RideStatusRequested) + + if _, err := dispatch.CancelByCustomerID(context.Background(), cust.ID, ride.ID); err != nil { + t.Fatalf("乘客取消應成功:%v", err) + } + + for _, r := range fp.recv { + if r.Rec.Role == events.RoleDriver { + t.Fatalf("未派單的訂單不該推事件給司機,卻推了:%+v", r) + } + } +}