From a1001c4afad925b16b1d874192824e3c78a2ed6e Mon Sep 17 00:00:00 2001 From: awei Date: Tue, 28 Jul 2026 21:27:58 +0800 Subject: [PATCH] =?UTF-8?q?fix(driver):=20=E5=88=A5=E8=99=95=E5=81=9A?= =?UTF-8?q?=E7=9A=84=E5=8B=95=E4=BD=9C=EF=BC=8C=E9=80=99=E5=8F=B0=E4=B9=9F?= =?UTF-8?q?=E8=A6=81=E8=B7=9F=E4=B8=8A=EF=BC=88=E5=A4=9A=E8=A3=9D=E7=BD=AE?= =?UTF-8?q?=EF=BC=8F=E8=B7=A8=E7=AE=A1=E9=81=93=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 先推翻自己的假設:原本猜後端可能只保留最後一條 WS 連線而兩台互踢, 讀 internal/events/hub.go 後不成立——Hub 是 map[*Client]bool, 同一個 driver id 的每條連線都會收到事件。真正的問題是事件到了沒人處理: 1. ride.accepted 的收件人就是「接單的那個司機」,所以這台收到它 =我在別的地方接了這張單。舊碼只認自己這台接的,其他情況什麼都不做: 接單卡繼續留著、行程卡不出現,司機以為還沒接到。 2. ride.stop_updated 司機端完全沒處理,畫面停在舊的「下一站」—— 而那正是唯一給操作的一站,兩台會對不同的站給按鈕。 修法:accepted 不是自己這台接的 → 收掉接單卡並以後端為準重讀 active (事件不含全程 stops,重讀才齊全);新增 stop_updated 的處理。 缺口 2 需要後端配合(dispatch PR #53:該事件原本只推給乘客)。 驗收:flutter analyze 無 issue、flutter test 261 passed(新增 4); 反向確認兩處修正各自拿掉後 2 案 FAIL。 模擬器實跑:亮著接單卡時用同一司機的 API token 接單 → 沒按任何按鈕, 接單卡消失、行程卡帶完整 4 站出現;舊後端下標記停靠點 8 分鐘畫面沒動, 換上 PR #53 的後端後 5 秒內整份清單跟上。 Co-Authored-By: Claude Opus 5 --- docs/TODO.md | 47 +++++++- lib/driver/driver_controller.dart | 19 ++- test/driver_multi_device_test.dart | 183 +++++++++++++++++++++++++++++ 3 files changed, 246 insertions(+), 3 deletions(-) create mode 100644 test/driver_multi_device_test.dart diff --git a/docs/TODO.md b/docs/TODO.md index dac5f54..788fd5c 100644 --- a/docs/TODO.md +++ b/docs/TODO.md @@ -858,6 +858,49 @@ admin 的全域 query 錯誤處理有去重 key 且整個 repo 沒有 `refetchIn --- +## 📱📱 2026-07-28 第六輪 debug:多裝置/跨管道(同一司機的另一處動作) + +> 清單上的第 2 項。**先推翻自己的假設**:原本猜「後端可能只保留最後一條連線 → +> 兩台互踢無限循環」。讀 `internal/events/hub.go` 查證後**不成立**—— +> Hub 是 `map[*Client]bool`,同一個 driver id 的**每一條連線都會收到事件**, +> 不覆蓋也不互踢。所以多裝置本來就被支援,真正的問題是**事件到了卻沒人處理**。 + +**兩個缺口**(都不是多裝置獨有,LINE 那條路徑同樣會踩到): + +1. **別處接了單,這台毫無反應**。`ride.accepted` 的收件人就是「接單的那個司機」, + 所以這台收到它=「我在別的地方接了這張單」。舊碼只在 `_activeRide?.rideId == event.rideId` + 時處理(也就是只認自己這台接的),其他情況什麼都不做:**接單卡繼續留在畫面上、 + 行程卡不出現**,司機以為還沒接到,按下去才發現。 +2. **別處標記了停靠點,這台停在舊的「下一站」**。乘客端早就會收 `ride.stop_updated` + 並更新進度,司機端卻連這個 case 都沒有。而「下一站」正是司機端唯一給操作的那一站—— + 兩台會對不同的站給按鈕。 + +**修法**: +- App(本批):`ride.accepted` 不是自己這台接的 → 收掉接單卡+以後端為準重讀 active + (事件 payload 不含全程 stops,重讀才會齊全);新增 `ride.stop_updated` 的處理, + 同一張單就重讀 active。 +- **後端(dispatch PR #53,同批)**:`ride.stop_updated` 原本**只推給乘客**—— + 所以缺口 2 的 App 端處理在舊後端下是死碼(實跑當場證實:標記後 8 分鐘畫面沒動)。 + 後端 `publishStops` 改成乘客與司機各推一則。 + +**驗收**: +- 靜態:`flutter analyze` 無 issue、`flutter test` **261 passed**(257 +新 4)。 + 新增 `test/driver_multi_device_test.dart`(別台接走→收卡+補行程/自己這台照舊不重打 active/ + 別處標記→重讀跟上/不是這張單不動)。**反向確認**:兩處修正各自拿掉後 2 案 FAIL。 +- **✅ 模擬器實跑(`m6_pixel` driver flavor + docker compose,2 乘客 4 站的 ride #9)**: + - **別台接單**:App 亮著接單卡(「多乘客行程(4 站)」)→ **用同一司機的 API token 接單** + → **司機沒按 App 任何按鈕**,接單卡自動消失、行程卡自動出現,且**含完整 4 站清單與多點地圖**。 + - **別處標記停靠點**:舊後端下標記第 1 站 → **8 分鐘後畫面完全沒動**(缺口 2 的實證); + 換上 dispatch PR #53 的後端後標記第 2 站 → **5 秒內**前兩站變綠勾「已完成」、 + 下一站前移到「乘客 A下車」並帶操作鈕、地圖重畫。 + +**查了但沒動的**(多裝置的其餘行為,屬後端/產品決策): +- 兩台同時上線時**位置互相覆蓋**(Redis 單一 `driver::loc`),派單距離會以最後回報的那台為準。 +- 後端**沒有踢舊 session 的機制**(JWT 無狀態)。要不要「一個帳號只能一台上線」是產品決策, + 不該由 App 端片面實作。 + +--- + ## 下次任務 > **✅ 維護項 5「清開發殘留」已完成(2026-07-28)**,詳見上方。 @@ -902,8 +945,8 @@ admin 的全域 query 錯誤處理有去重 key 且整個 repo 沒有 `refetchIn > > **➡️ 下一輪 debug 還沒碰過的角落**(依價值排序,都不需外部資源): > 1. ~~**App 生命週期**~~ ✅ **已完成(2026-07-28 第四輪)**,見上方專段。 -> 2. **多裝置/同帳號重複登入**:同一司機在兩台裝置上線,後端沒有踢舊 session 的機制, -> 兩邊都會收派單——先確認後端行為,再決定 App 該不該處理。 +> 2. ~~**多裝置/同帳號重複登入**~~ ✅ **已完成(2026-07-28 第六輪)**,見上方專段 +> (原本猜的「兩台互踢」不成立;真正的問題是事件到了沒人處理,順帶補了後端一則事件)。 > 3. ~~**弱網**(非全斷)的逾時分支~~ ✅ **已完成(2026-07-28 第五輪)**,見上方專段 > (真正的問題不是文案,是「沒丟例外 = 成功」的判定)。 > 4. **其他有副作用的操作是否也有同一個洞**:`pickUp`/`completeRide`/`cancelRide` diff --git a/lib/driver/driver_controller.dart b/lib/driver/driver_controller.dart index 0989dfd..824b59c 100644 --- a/lib/driver/driver_controller.dart +++ b/lib/driver/driver_controller.dart @@ -757,7 +757,8 @@ class DriverController extends ChangeNotifier { notifyListeners(); } case FleetEventTypes.rideAccepted: - if (event.rideId != null && _activeRide?.rideId == event.rideId) { + if (event.rideId == null) break; + if (_activeRide?.rideId == event.rideId) { // 司機端 ride.accepted 事件帶目的地,先預載供 onTrip 導航(pickup 回應為保底來源) final dropoff = event.payload?['dropoff_address'] as String?; _activeRide = _activeRide!.copyWith( @@ -768,12 +769,28 @@ class DriverController extends ChangeNotifier { dropoffLng: (event.payload?['dropoff_lng'] as num?)?.toDouble(), ); notifyListeners(); + } else { + // **這則事件的收件人就是「接單的那個司機」**,所以到了這裡代表 + // 「我在別的地方接了這張單」——另一台裝置、或 LINE 那條路徑。 + // 舊碼在這種情況下什麼都不做:接單卡繼續留在畫面上,行程卡不出現, + // 司機以為自己還沒接到,按下去才發現。 + if (_pendingOffer?.rideId == event.rideId) _pendingOffer = null; + // 以後端為準把行程補進來(事件 payload 不含全程 stops)。 + unawaited(_restoreActiveRide()); + notifyListeners(); } case FleetEventTypes.ridePickedUp: if (event.rideId != null && _activeRide?.rideId == event.rideId) { _activeRide = _activeRide!.copyWith(phase: DriverRidePhase.onTrip); notifyListeners(); } + case FleetEventTypes.rideStopUpdated: + // 多裝置/跨管道:另一處標記了到達或跳過。乘客端早就會收這則事件並更新進度, + // 司機端卻不處理——同一位司機的兩台裝置會看到不同的「下一站」, + // 而「下一站」正是司機端唯一給操作的那一站。 + if (event.rideId != null && _activeRide?.rideId == event.rideId) { + unawaited(_restoreActiveRide()); + } case FleetEventTypes.rideCompleted: case FleetEventTypes.rideCancelled: if (event.rideId != null && diff --git a/test/driver_multi_device_test.dart b/test/driver_multi_device_test.dart new file mode 100644 index 0000000..209cc43 --- /dev/null +++ b/test/driver_multi_device_test.dart @@ -0,0 +1,183 @@ +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'; + +/// 後端 Hub 是 `map[*Client]bool`,**同一個 driver id 的每一條連線都會收到事件** +/// (不覆蓋、不互踢——這點是讀 `internal/events/hub.go` 查證的)。 +/// 所以同一位司機的第二台裝置、或 LINE 那條路徑的動作,都會以事件形式送到這台來; +/// 這組測試釘住「別處做的事,這台也要跟上」。 +void main() { + late _MultiDeviceApi api; + late DriverController ctrl; + + setUp(() { + api = _MultiDeviceApi(); + ctrl = DriverController( + storage: MemoryDriverAuthStore(), + api: api, + wsFactory: FleetWsClient.silent, + ); + }); + + tearDown(() => ctrl.dispose()); + + Future loginWithOffer(int rideId) async { + await ctrl.init(); + await ctrl.login(lineUserId: 'U', password: 'pw'); + ctrl.handleWsEventForTest(FleetWsEvent( + type: FleetEventTypes.rideAssigned, + rideId: rideId, + payload: const {'address': '台北車站'}, + )); + expect(ctrl.pendingOffer?.rideId, rideId, reason: '前提:這台亮著接單卡'); + } + + test('別台裝置接走同一張單 → 這台的接單卡收掉,並補出行程卡', () async { + await loginWithOffer(31); + // ride.accepted 的收件人就是「接單的那個司機」= 自己,只是動作發生在別處。 + api.restoreRide = ActiveRide.fromBackendJson(const { + 'id': 31, + 'status': RideStatus.accepted, + 'pickup_address': '台北車站', + }); + + ctrl.handleWsEventForTest(FleetWsEvent( + type: FleetEventTypes.rideAccepted, + rideId: 31, + payload: const {'dropoff_address': '松山機場'}, + )); + await Future.delayed(Duration.zero); // 重讀 active 是背景鏈 + + expect(ctrl.pendingOffer, isNull, reason: '已經接到了,接單卡不該還留著'); + expect(ctrl.activeRide?.rideId, 31, reason: '行程卡要自己出現,不必等司機按什麼'); + }); + + test('自己這台接的單照舊:以事件預載目的地,不重打 active', () async { + await loginWithOffer(32); + await ctrl.acceptOffer(); + final callsAfterAccept = api.activeCalls; + + ctrl.handleWsEventForTest(FleetWsEvent( + type: FleetEventTypes.rideAccepted, + rideId: 32, + payload: const { + 'dropoff_address': '松山機場', + 'dropoff_lat': 25.06, + 'dropoff_lng': 121.55, + }, + )); + await Future.delayed(Duration.zero); + + expect(ctrl.activeRide?.dropoffAddress, '松山機場'); + expect(api.activeCalls, callsAfterAccept, reason: '同一張單的事件不必再問一次後端'); + }); + + test('別處標記了停靠點 → 這台重讀 active 跟上進度', () async { + await loginWithOffer(33); + await ctrl.acceptOffer(); + + // 後端那邊第一站已經到達了(另一台裝置按的)。 + api.restoreRide = ActiveRide.fromBackendJson(const { + 'id': 33, + 'status': RideStatus.accepted, + 'pickup_address': '台北車站', + 'stops': [ + { + 'id': 1, + 'seq': 1, + 'kind': 'pickup', + 'lat': 25.033, + 'lng': 121.565, + 'passenger_label': 'A', + 'arrived_at': '2026-07-28T10:00:00Z', + }, + { + 'id': 2, + 'seq': 2, + 'kind': 'dropoff', + 'lat': 25.04, + 'lng': 121.51, + 'passenger_label': 'A', + }, + ], + }); + + ctrl.handleWsEventForTest(FleetWsEvent( + type: FleetEventTypes.rideStopUpdated, + rideId: 33, + payload: const {}, + )); + await Future.delayed(Duration.zero); + + expect(ctrl.activeRide?.stops.length, 2); + expect(ctrl.activeRide?.nextStop?.id, 2, + reason: '第一站已到達,下一站要前移——這台若不跟上,兩台會對不同的站給操作'); + }); + + test('不是這張單的 stop_updated 不動(不同行程互不干擾)', () async { + await loginWithOffer(34); + await ctrl.acceptOffer(); + final before = api.activeCalls; + + ctrl.handleWsEventForTest(FleetWsEvent( + type: FleetEventTypes.rideStopUpdated, + rideId: 999, + payload: const {}, + )); + await Future.delayed(Duration.zero); + + expect(api.activeCalls, before); + }); +} + +class _MultiDeviceApi extends FleetApiClient { + _MultiDeviceApi() + : super(dio: Dio(BaseOptions(baseUrl: 'http://test.invalid/api'))); + + ActiveRide? restoreRide; + int activeCalls = 0; + + @override + void setToken(String? token) {} + + @override + Future login({ + required String lineUserId, + required String password, + }) async => + const LoginResult(driverId: 7, token: 'tok', name: '阿明'); + + @override + Future activeRide() async { + activeCalls++; + return restoreRide; + } + + @override + Future acceptRide(int rideId) async { + // 比照真後端:接單成功後 active 立即查得到(見 driver_controller_test 的說明)。 + restoreRide ??= ActiveRide( + rideId: rideId, + address: '台北車站', + phase: DriverRidePhase.enRouteToPickup, + ); + return '接單成功'; + } + + @override + Future fetchVehicle() async => const DriverVehicle( + vehicleType: 'sedan', + plateNumber: 'ABC-1234', + hasVehicle: true, + reviewStatus: VehicleReviewStatus.approved, + canAccept: true, + ); + + @override + Future> fetchLostItems() async => const []; +}