From 251db5dcfc82077a9848c9af13e40971a7dd6cf5 Mon Sep 17 00:00:00 2001 From: awei Date: Wed, 29 Jul 2026 21:19:22 +0800 Subject: [PATCH] =?UTF-8?q?feat(driver):=20=E6=B2=92=E6=90=B6=E5=88=B0?= =?UTF-8?q?=E7=9A=84=E5=96=AE=EF=BC=8C=E6=8E=A5=E5=96=AE=E5=8D=A1=E8=87=AA?= =?UTF-8?q?=E5=B7=B1=E6=B6=88=E5=A4=B1=EF=BC=88=E9=85=8D=E5=90=88=E5=BE=8C?= =?UTF-8?q?=E7=AB=AF=20ride.taken=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 同一張單同時推給半徑內每一位待命司機,只有一位搶得到。先前沒搶到的人 沒有任何事件收得掉那張全螢幕接單卡——他得自己按下去拿到「手慢了」才會消失, 期間卡片蓋著整個畫面。 後端補送 ride.taken(dispatch T2)後,這一側收到就把 pendingOffer 清掉。 **不寫錯誤訊息**:他什麼都沒做,卡片安靜地收掉才是正確行為。 逾時/乘客取消時後端改送 ride.cancelled 給所有收過 offer 的人,既有處理已涵蓋。 測試:新增 3 案;反向確認拿掉處理後 1 案 FAIL。 Co-Authored-By: Claude Opus 5 --- lib/core/config/app_config.dart | 5 ++ lib/driver/driver_controller.dart | 9 +++ test/driver_offer_taken_test.dart | 105 ++++++++++++++++++++++++++++++ 3 files changed, 119 insertions(+) create mode 100644 test/driver_offer_taken_test.dart diff --git a/lib/core/config/app_config.dart b/lib/core/config/app_config.dart index 3335cd7..d3aa2f6 100644 --- a/lib/core/config/app_config.dart +++ b/lib/core/config/app_config.dart @@ -47,6 +47,11 @@ class FleetEventTypes { /// 司機標記到達/跳過某一站(N8)。payload 帶**整趟** stops,收到直接覆蓋即可。 static const rideStopUpdated = 'ride.stop_updated'; + + /// 這單被別人接走了——**只送給本輪收過派單邀請但沒接到的司機**。 + /// 同一張單會同時推給半徑內每一位待命司機,先前沒有任何事件收得掉沒搶到那些人的接單卡 + /// (`ride.accepted` 只送給接到的那位),他們得自己按下去拿到「手慢了」才會消失。 + static const rideTaken = 'ride.taken'; static const chatMessage = 'chat.message'; static const lostItemCreated = 'lost_item.created'; static const lostItemUpdated = 'lost_item.updated'; diff --git a/lib/driver/driver_controller.dart b/lib/driver/driver_controller.dart index 6f65c64..32a37f8 100644 --- a/lib/driver/driver_controller.dart +++ b/lib/driver/driver_controller.dart @@ -897,6 +897,15 @@ class DriverController extends ChangeNotifier { if (event.rideId != null && _activeRide?.rideId == event.rideId) { unawaited(_restoreActiveRide(silent: true)); } + case FleetEventTypes.rideTaken: + // 別的司機搶到了這單。同一張單會同時推給半徑內每一位待命司機, + // 先前沒有任何事件收得掉沒搶到那些人的接單卡——他得自己按下去、 + // 拿到「手慢了,這單已被其他司機接走」才會消失(期間還蓋著整個畫面)。 + // **不寫錯誤訊息**:他什麼都沒做,卡片安靜地收掉就是正確的行為。 + if (event.rideId != null && _pendingOffer?.rideId == event.rideId) { + _pendingOffer = null; + notifyListeners(); + } case FleetEventTypes.rideCompleted: case FleetEventTypes.rideCancelled: if (event.rideId != null && diff --git a/test/driver_offer_taken_test.dart b/test/driver_offer_taken_test.dart new file mode 100644 index 0000000..99868b8 --- /dev/null +++ b/test/driver_offer_taken_test.dart @@ -0,0 +1,105 @@ +import 'package:dio/dio.dart'; +import 'package:flutter_test/flutter_test.dart'; +import 'package:line_fleet_app/core/api/fleet_api_client.dart'; +import 'package:line_fleet_app/core/config/app_config.dart'; +import 'package:line_fleet_app/core/models/models.dart'; +import 'package:line_fleet_app/core/storage/token_storage.dart'; +import 'package:line_fleet_app/core/ws/fleet_ws_client.dart'; +import 'package:line_fleet_app/driver/driver_controller.dart'; + +/// 同一張單會**同時**推給半徑內每一位待命司機(後端 `dispatchRound` 一輪 `pushOffer` 全部), +/// 只有一位搶得到。先前沒搶到的人**沒有任何事件收得掉那張全螢幕接單卡**: +/// `ride.accepted` 只送給接到的那位,逾時取消也只通知乘客。 +/// 他得自己按下去、拿到「手慢了,這單已被其他司機接走」才會消失——期間卡片蓋著整個畫面。 +/// +/// 後端補送 `ride.taken`(給沒接到的人)與 `ride.cancelled`(取消時給所有收過 offer 的人)後, +/// 這一側負責把卡片收掉。 +void main() { + group('司機端:沒搶到的接單卡要自己消失', () { + test('ride.taken → 收掉接單卡,且不報錯(他什麼都沒做)', () async { + final ctrl = await _loggedIn(); + addTearDown(ctrl.dispose); + ctrl.handleWsEventForTest(_assigned(21)); + expect(ctrl.pendingOffer?.rideId, 21, reason: '前置:畫面上有一張接單卡'); + + ctrl.handleWsEventForTest( + FleetWsEvent(type: FleetEventTypes.rideTaken, rideId: 21), + ); + + expect(ctrl.pendingOffer, isNull); + expect(ctrl.error, isNull, reason: '沒搶到不是錯誤,跳紅字只會干擾他開車'); + expect(ctrl.activeRide, isNull, reason: '沒接到就不該有行程'); + }); + + test('別張單的 ride.taken 不動自己的接單卡', () async { + final ctrl = await _loggedIn(); + addTearDown(ctrl.dispose); + ctrl.handleWsEventForTest(_assigned(22)); + + ctrl.handleWsEventForTest( + FleetWsEvent(type: FleetEventTypes.rideTaken, rideId: 99), + ); + + expect(ctrl.pendingOffer?.rideId, 22); + }); + + test('逾時/乘客取消時的 ride.cancelled 一樣收掉接單卡', () async { + final ctrl = await _loggedIn(); + addTearDown(ctrl.dispose); + ctrl.handleWsEventForTest(_assigned(23)); + + ctrl.handleWsEventForTest( + FleetWsEvent(type: FleetEventTypes.rideCancelled, rideId: 23), + ); + + expect(ctrl.pendingOffer, isNull); + expect( + ctrl.error, + isNull, + reason: '他手上沒有行程,只有一張還沒按的邀請——不必跟他解釋什麼', + ); + }); + }); +} + +Future _loggedIn() async { + final ctrl = DriverController( + storage: MemoryDriverAuthStore() + ..save(const AuthSession(driverId: 7, token: 'tok')), + api: _Api(), + wsFactory: FleetWsClient.silent, + ); + await ctrl.init(); + return ctrl; +} + +FleetWsEvent _assigned(int rideId) => FleetWsEvent( + type: FleetEventTypes.rideAssigned, + rideId: rideId, + payload: const { + 'address': '台北市信義區市府路1號', + 'dropoff_address': '台北車站', + }, + ); + +class _Api extends FleetApiClient { + _Api() : super(dio: Dio(BaseOptions(baseUrl: 'http://test.invalid/api'))); + + @override + void setToken(String? token) {} + + @override + Future activeRide() async => null; + + @override + Future> fetchLostItems() async => const []; + + @override + Future fetchVehicle() async => const DriverVehicle( + vehicleType: 'sedan', + plateNumber: 'ABC-1234', + hasVehicle: true, + reviewStatus: VehicleReviewStatus.approved, + canAccept: true, + ); +}