From 4260de3b87946b77ec6012691df7021f8173bad7 Mon Sep 17 00:00:00 2001 From: awei Date: Wed, 29 Jul 2026 21:18:24 +0800 Subject: [PATCH] =?UTF-8?q?feat(dispatch):=20=E6=B2=92=E6=90=B6=E5=88=B0?= =?UTF-8?q?=E7=9A=84=E5=8F=B8=E6=A9=9F=E4=B9=9F=E8=A6=81=E7=9F=A5=E9=81=93?= =?UTF-8?q?=E2=80=94=E2=80=94=E8=A3=9C=E9=80=81=20ride.taken=20=E8=88=87?= =?UTF-8?q?=E5=8F=96=E6=B6=88=E6=99=82=E7=9A=84=20ride.cancelled=EF=BC=88T?= =?UTF-8?q?2=EF=BC=8FT3=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 一輪派單會同時推給半徑內每一位待命司機,只有一位搶得到。先前沒搶到的人手機上 留著一張全螢幕接單卡,而後端沒有任何方式通知他們:ride.accepted 只送給接到的那位, 逾時取消也只通知乘客。他得自己按下去、拿到「手慢了,這單已被其他司機接走」才會消失。 根因是 dispatchRound 的 offered 只是遞迴中的記憶體 map,接單/取消流程拿不到。 改法:Redis 加 ride::offered 集合(比照既有的 rejected),pushOffer 時記錄; 接單時對「除了接單者以外」的人送 ride.taken、取消(逾時或乘客/客服)時送 ride.cancelled, 送完即清集合。 ride.taken 是新事件型別——不能用 ride.cancelled 代替:訂單並沒有取消,只是不是他的了。 測試:新增 2 案(真 PostGIS+Redis):接單只送沒搶到的那位且集合清空、逾時取消也會送。 Co-Authored-By: Claude Opus 5 --- internal/events/event.go | 6 + internal/redis/store.go | 35 +++++ internal/service/dispatch.go | 34 +++++ internal/service/dispatch_offer_taken_test.go | 125 ++++++++++++++++++ 4 files changed, 200 insertions(+) create mode 100644 internal/service/dispatch_offer_taken_test.go diff --git a/internal/events/event.go b/internal/events/event.go index 43ac841..a86ed21 100644 --- a/internal/events/event.go +++ b/internal/events/event.go @@ -28,6 +28,12 @@ const ( // TypeRideStopUpdated 司機標記到達/跳過某一站(N7)。payload 帶**整趟 stops**, // 收到整批覆蓋即可,不必自己套用差異——乘客端據此顯示「走到第幾站」。 TypeRideStopUpdated = "ride.stop_updated" + + // TypeRideTaken 這單已被別人接走——**只送給本輪收過 offer 但沒接到的司機**。 + // 他們的手機上留著一張全螢幕接單卡,先前沒有任何事件收得掉它: + // ride.accepted 只送給接到的那位,逾時取消也只通知乘客。 + // 不能用 ride.cancelled 代替——訂單並沒有取消,只是不是他的了。 + TypeRideTaken = "ride.taken" ) // 審計 actor_role diff --git a/internal/redis/store.go b/internal/redis/store.go index c0f775b..b30bfc4 100644 --- a/internal/redis/store.go +++ b/internal/redis/store.go @@ -116,6 +116,41 @@ func (s *Store) ClearRejected(ctx context.Context, rideID int64) { s.client.Del(ctx, fmt.Sprintf("ride:%d:rejected", rideID)) } +// OfferRideDriver 記錄「本單已推給這位司機」。 +// +// 一輪派單會**同時**推給半徑內每一位符合條件的司機,只有一位搶得到; +// 其餘的人手機上留著一張全螢幕接單卡,而後端先前**沒有任何方式**通知他們這單沒了 +// (`offered` 只是 dispatchRound 遞迴中的記憶體 map,接單/取消流程都拿不到)。 +// 這個集合讓「已被接走/已取消」時能把那些卡片收掉。 +func (s *Store) OfferRideDriver(ctx context.Context, rideID, driverID int64) error { + key := fmt.Sprintf("ride:%d:offered", rideID) + if err := s.client.SAdd(ctx, key, driverID).Err(); err != nil { + return err + } + // 與拒接集合同一個 TTL:派單輪次全部走完也遠短於 30 分鐘,過期即自然清掉。 + return s.client.Expire(ctx, key, 30*time.Minute).Err() +} + +// OfferedDrivers 取得本單收過派單邀請的司機集合。 +func (s *Store) OfferedDrivers(ctx context.Context, rideID int64) []int64 { + vals, err := s.client.SMembers(ctx, fmt.Sprintf("ride:%d:offered", rideID)).Result() + if err != nil { + return nil + } + ids := make([]int64, 0, len(vals)) + for _, v := range vals { + if id, e := strconv.ParseInt(v, 10, 64); e == nil { + ids = append(ids, id) + } + } + return ids +} + +// ClearOffered 清掉本單的已派送集合(接單/取消後)。 +func (s *Store) ClearOffered(ctx context.Context, rideID int64) { + s.client.Del(ctx, fmt.Sprintf("ride:%d:offered", rideID)) +} + // GetDriverLocation 取得司機最新位置 func (s *Store) GetDriverLocation(ctx context.Context, driverID int64) (lat, lng float64, ok bool) { idStr := strconv.FormatInt(driverID, 10) diff --git a/internal/service/dispatch.go b/internal/service/dispatch.go index ab18b72..d9bee1c 100644 --- a/internal/service/dispatch.go +++ b/internal/service/dispatch.go @@ -305,6 +305,12 @@ func (s *DispatchService) pushOffer(ctx context.Context, driver *model.Driver, r rideOfferPushData(ride, ride.PickupAddress, etaSec, distM), ) } + // 記錄「這單推給過他」——接單/取消時要靠它把沒搶到的人手機上的接單卡收掉。 + // 失敗只記 log:漏記一位的後果是他的卡片留著(=修正前的行為),不該擋住派單。 + if err := s.redis.OfferRideDriver(ctx, ride.ID, driver.ID); err != nil { + log.Error().Err(err).Int64("ride_id", ride.ID).Int64("driver_id", driver.ID). + Msg("記錄派單對象失敗(接單後將無法收掉他的接單卡)") + } s.publish(events.Recipient{Role: events.RoleDriver, ID: driver.ID}, events.Event{ Type: events.TypeRideAssigned, RideID: ride.ID, @@ -312,6 +318,26 @@ func (s *DispatchService) pushOffer(ctx context.Context, driver *model.Driver, r }) } +// notifyOfferedDrivers 通知「收過本單 offer」的司機,並清掉該集合。 +// +// exceptID 為 0 時通知全部(取消情境);否則跳過該司機(接單者自己已經收到 ride.accepted)。 +// 沒有這一步,沒搶到的司機手機上那張全螢幕接單卡**沒有任何東西收得掉**—— +// 他要自己按下去、拿到「手慢了,這單已被其他司機接走」才會消失。 +func (s *DispatchService) notifyOfferedDrivers( + ctx context.Context, rideID int64, eventType string, exceptID int64, +) { + for _, id := range s.redis.OfferedDrivers(ctx, rideID) { + if id == exceptID { + continue + } + s.publish(events.Recipient{Role: events.RoleDriver, ID: id}, events.Event{ + Type: eventType, + RideID: rideID, + }) + } + s.redis.ClearOffered(ctx, rideID) +} + // giveUpIfUnaccepted 逾時仍無人接單 → 取消訂單並通知客戶(避免永久停在 ASSIGNED) func (s *DispatchService) giveUpIfUnaccepted(rideID int64) { ctx := context.Background() @@ -330,6 +356,8 @@ func (s *DispatchService) giveUpIfUnaccepted(rideID int64) { s.audit.record(rideID, statusPtr(from), constants.RideStatusCancelled, events.TypeRideCancelled, events.ActorSystem, nil, "dispatch_timeout") s.redis.ClearRejected(ctx, rideID) + // 逾時取消先前**只通知乘客**,收過 offer 的司機卡片一樣留著(T3)。 + s.notifyOfferedDrivers(ctx, rideID, events.TypeRideCancelled, 0) log.Warn().Int64("ride_id", rideID).Msg("逾時無人接單,訂單自動取消") reason, text, payload := giveUpCancelInfo(ride) @@ -418,6 +446,9 @@ func (s *DispatchService) cancelActiveRide( s.audit.record(ride.ID, statusPtr(from), constants.RideStatusCancelled, events.TypeRideCancelled, actorRole, actorID, note) s.releaseAndReset(ctx, ride.ID, ride.DriverID) + // 還沒有人接單就被取消時(status=Assigned),收過 offer 的司機全都留著卡片; + // 已接單的情境下這個集合通常已在接單時清空,這裡再呼叫一次是冪等的。 + s.notifyOfferedDrivers(ctx, ride.ID, events.TypeRideCancelled, 0) log.Info().Int64("ride_id", ride.ID).Str("actor", actorRole).Msg("訂單已取消") s.publish(events.Recipient{Role: events.RoleCustomer, ID: ride.CustomerID}, events.Event{ Type: events.TypeRideCancelled, @@ -574,6 +605,9 @@ func (s *DispatchService) AcceptRide(ctx context.Context, rideID, driverID int64 RideID: rideID, Payload: rideAcceptedCustomerPayload(driver, etaSec), }) + // 沒搶到的司機:把他們的接單卡收掉(T2)。必須在接單者的 ride.accepted 之外另送, + // 因為 ride.accepted 的收件人是「接到的那位」。 + s.notifyOfferedDrivers(ctx, rideID, events.TypeRideTaken, driverID) s.publish(events.Recipient{Role: events.RoleDriver, ID: driverID}, events.Event{ Type: events.TypeRideAccepted, RideID: rideID, diff --git a/internal/service/dispatch_offer_taken_test.go b/internal/service/dispatch_offer_taken_test.go new file mode 100644 index 0000000..539382b --- /dev/null +++ b/internal/service/dispatch_offer_taken_test.go @@ -0,0 +1,125 @@ +package service + +import ( + "context" + "testing" + + "line-fleet-dispatch/internal/constants" + "line-fleet-dispatch/internal/events" + lineclient "line-fleet-dispatch/internal/line" + "line-fleet-dispatch/internal/repository" +) + +// 同一張單會**同時**推給半徑內每一位待命司機,只有一位搶得到。 +// 先前沒搶到的人手機上留著一張全螢幕接單卡,而**沒有任何事件收得掉它**—— +// ride.accepted 只送給接到的那位,逾時取消也只通知乘客。 +// 他得自己按下去、拿到「手慢了,這單已被其他司機接走」才會消失。 +// +// 這組測試釘住補送的兩則:接單 → ride.taken 給沒接到的人;取消 → ride.cancelled 給所有人。 + +func TestAcceptRide_通知沒搶到的司機(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(""), NewETAService(nil), NewDispatchSettings(3000, 5, 20, 1, 5), fp) + + cust, err := customers.FindOrCreateByLineUserID("U_taken_cust", "乘客") + if err != nil { + t.Fatalf("建立乘客失敗:%v", err) + } + winner, err := drivers.FindOrCreate("U_taken_win", "搶到的司機") + if err != nil { + t.Fatalf("建立司機失敗:%v", err) + } + loser, err := drivers.FindOrCreate("U_taken_lose", "沒搶到的司機") + if err != nil { + t.Fatalf("建立司機失敗:%v", err) + } + if err := drivers.UpdateStatus(winner.ID, constants.DriverStatusIdle); err != nil { + t.Fatalf("設定司機狀態失敗:%v", err) + } + // O5 gate:沒有已核准的車輛就接不了單。 + if err := drivers.UpdateVehicle(winner.ID, constants.VehicleTypeSedan, "TAKEN-01"); err != nil { + t.Fatalf("設定車輛失敗:%v", err) + } + if err := drivers.UpdateVehicleReview(winner.ID, constants.VehicleReviewApproved, ""); err != nil { + t.Fatalf("核准車輛失敗:%v", err) + } + ride := newTestRide(t, rides, cust.ID, constants.RideStatusAssigned) + + ctx := context.Background() + // 模擬本輪派單:兩位都收到了 offer + for _, id := range []int64{winner.ID, loser.ID} { + if err := redisStore.OfferRideDriver(ctx, ride.ID, id); err != nil { + t.Fatalf("記錄派單對象失敗:%v", err) + } + } + + if _, err := dispatch.AcceptRide(ctx, ride.ID, winner.ID, ""); err != nil { + t.Fatalf("接單應成功:%v", err) + } + + var takenTo []int64 + for _, r := range fp.recv { + if r.Ev.Type == events.TypeRideTaken && r.Rec.Role == events.RoleDriver { + takenTo = append(takenTo, r.Rec.ID) + } + } + if len(takenTo) != 1 || takenTo[0] != loser.ID { + t.Fatalf("ride.taken 應只送給沒搶到的司機 %d,實際送給 %v(全部事件:%+v)", + loser.ID, takenTo, fp.recv) + } + // 接到的那位收的是 ride.accepted,不該再收一則「被別人接走」 + for _, r := range fp.recv { + if r.Ev.Type == events.TypeRideTaken && r.Rec.ID == winner.ID { + t.Fatalf("接到單的司機不該收到 ride.taken:%+v", r) + } + } + // 集合用過即清,重派時不會誤發給舊名單 + if left := redisStore.OfferedDrivers(ctx, ride.ID); len(left) != 0 { + t.Fatalf("接單後 offered 集合應清空,仍有 %v", left) + } +} + +func TestGiveUp逾時取消_通知收過offer的司機(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(""), NewETAService(nil), NewDispatchSettings(3000, 5, 20, 1, 5), fp) + + cust, err := customers.FindOrCreateByLineUserID("U_giveup_cust", "乘客") + if err != nil { + t.Fatalf("建立乘客失敗:%v", err) + } + drv, err := drivers.FindOrCreate("U_giveup_drv", "收到邀請的司機") + if err != nil { + t.Fatalf("建立司機失敗:%v", err) + } + ride := newTestRide(t, rides, cust.ID, constants.RideStatusAssigned) + + ctx := context.Background() + if err := redisStore.OfferRideDriver(ctx, ride.ID, drv.ID); err != nil { + t.Fatalf("記錄派單對象失敗:%v", err) + } + + dispatch.giveUpIfUnaccepted(ride.ID) + + var gotDriver bool + for _, r := range fp.recv { + if r.Ev.Type == events.TypeRideCancelled && r.Rec.Role == events.RoleDriver && r.Rec.ID == drv.ID { + gotDriver = true + } + } + if !gotDriver { + t.Fatalf("逾時取消時收過 offer 的司機也要收到 %s,否則接單卡留著;實際:%+v", + events.TypeRideCancelled, fp.recv) + } +}