From befe3c44f025cd5ac8a6df7181f3ed34de6a2496 Mon Sep 17 00:00:00 2001 From: awei Date: Tue, 28 Jul 2026 19:29:25 +0800 Subject: [PATCH] =?UTF-8?q?fix(app):=20=E6=8E=A5=E5=96=AE=E8=88=87?= =?UTF-8?q?=E5=BB=BA=E5=96=AE=E7=9A=84=E7=B5=90=E6=9E=9C=E8=A6=81=E5=90=91?= =?UTF-8?q?=E5=BE=8C=E7=AB=AF=E7=A2=BA=E8=AA=8D=EF=BC=8C=E4=B8=8D=E8=83=BD?= =?UTF-8?q?=E5=8F=AA=E7=9C=8B=E6=9C=89=E6=B2=92=E6=9C=89=E4=B8=9F=E4=BE=8B?= =?UTF-8?q?=E5=A4=96?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 對真後端取證發現兩件事:司機接一張已被別人接走的單,後端回的是 HTTP 200 +「手慢了,這單已被其他司機接走」(不是錯誤);乘客重複 建單則回 409「已有進行中的訂單」。 由此兩個真 bug: 1. 司機抱著一張別人的行程卡出發。acceptOffer 只在丟例外時才算失敗, 而舊碼的重讀 active 又寫著「回 null 時寧可保留樂觀設定」, 於是沒接到也照樣顯示行程卡,直到按「乘客已上車」被 409 擋下。 2. 弱網下「請求送達、回應丟失」= 使用者被騙。司機端接單其實成功卻報錯, 他按「略過」後行程從畫面消失,而後端已把他設成載客中——收不到新派單 也無法離線;乘客端建單其實成功卻停在叫車表單,再按一次得到 「已有進行中的訂單」,唯一出路是重開 App。 修法(同一原則:有副作用的請求,結果要向後端問): - 司機端接單後一律重讀 active,以「是不是這張單」判定三態——確認到就以 後端資料覆蓋、確認沒接到就收掉行程卡並說明、連問都問不到才保留樂觀值。 逾時走同一條確認,確認到了就不報錯。 - 乘客端建單逾時或 409 時先問後端有沒有進行中訂單,有就接手(含司機資訊); 400 之類的輸入錯誤不觸發對帳。成功與接手共用同一份狀態切換。 驗收:flutter analyze 無 issue、flutter test 257 passed(新增 7、改寫 2); 反向確認兩處修正各自拿掉後 5 案 FAIL。 模擬器實跑:司機 A 收到 #8 接單卡 → 司機 B 用 API 搶走 → A 按接單 → 畫面不再出現行程卡,改顯示「這單已被其他司機接走」,DB driver_id=6 一致。 「逾時但其實成功」真機不好精準重現,只有單元測試覆蓋。 Co-Authored-By: Claude Opus 5 --- docs/TODO.md | 63 +++++- lib/customer/customer_controller.dart | 80 +++++-- lib/driver/driver_controller.dart | 44 +++- test/customer_place_order_timeout_test.dart | 219 ++++++++++++++++++++ test/driver_controller_test.dart | 78 ++++++- 5 files changed, 445 insertions(+), 39 deletions(-) create mode 100644 test/customer_place_order_timeout_test.dart diff --git a/docs/TODO.md b/docs/TODO.md index a634ca8..dac5f54 100644 --- a/docs/TODO.md +++ b/docs/TODO.md @@ -803,6 +803,61 @@ admin 的全域 query 錯誤處理有去重 key 且整個 repo 沒有 `refetchIn --- +## ⏱️ 2026-07-28 第五輪 debug:「其實成功了」與「其實沒成功」 + +> 接續第 3 項(弱網/逾時分支)。查下去發現真正的問題不在逾時文案, +> 而在**兩端都把「沒有丟例外」當成「成功」**。 + +**先對真後端取證**(curl 打實際端點): + +| 情境 | 後端實際回應 | App 原本怎麼解讀 | +|---|---|---| +| 同一乘客第二次建單 | **409**「已有進行中的訂單」 | 原樣顯示——但乘客畫面上根本沒有任何訂單,這句話無法行動 | +| 司機接一張已被別人接走的單 | **HTTP 200** +「手慢了,這單已被其他司機接走」 | **當成接單成功**:樂觀行程卡留在畫面上 | +| 司機非待命狀態接單 | **HTTP 200** +「您目前無法接單(非待命狀態)」 | 同上 | + +**兩個真 bug**: + +1. **司機抱著一張別人的行程卡出發**。`acceptOffer` 只在丟例外時才算失敗,而後端這兩種 + 拒絕都是 200。舊碼的重讀 active 又寫著「回 null 或別的 rideId 時**寧可保留樂觀設定**」, + 於是沒接到的情況下畫面照樣顯示行程卡,直到司機按「乘客已上車」被 409 擋下才發現。 +2. **弱網下「請求送達、回應丟失」= 使用者被騙**。 + - 司機端:接單其實成功了,App 卻報錯。司機按「略過」→ 行程從畫面消失, + 而後端已把他設成載客中——**收不到新派單、也無法離線**,畫面上什麼都沒有 + (這正是 `pitfall-driver-stuck-ontrip` 的成因之一)。 + - 乘客端:建單其實成功了,App 停在叫車表單說「請求逾時」;再按一次就得到 + 409「已有進行中的訂單」——唯一的出路是重開 App。 + +**修法**(同一個原則:**有副作用的請求,結果要向後端問,不能只看有沒有丟例外**): +- 司機端 `acceptOffer`:接單後一律重讀 active,以「是不是這張單」判定三態 + (`_AcceptOutcome`)。**confirmed** → 以後端資料覆蓋樂觀值(順帶補齊推播路徑缺的 stops); + **rejected** → 收掉樂觀行程卡並說明「這單已被其他司機接走」; + **unknown**(重讀本身也失敗=網路仍不通)→ 保留樂觀行程,因為「真的接到卻看不到行程」更糟。 + 逾時(`statusCode == null`)也走同一條確認:確認到了就當作接單成功,不報錯。 + 後端 `AcceptRide` 是同步寫入後才回應,所以「回應之後 active 查得到」可以依賴—— + `null` 是真的沒接到,不是還沒寫好。 +- 乘客端 `placeOrder`:逾時(`statusCode == null`)或 **409** 時先問後端有沒有進行中訂單, + 有就直接接手(含已被接單時的司機資訊)。**400 之類的輸入錯誤不觸發對帳**——那是真的沒建。 + 建單成功與「其實已經建好了」共用同一份狀態切換(`_applyCreatedRide`), + 避免兩份清單其中一份漏掉某項而把上一趟的司機/取消通知帶進這一趟。 + +**驗收**: +- 靜態:`flutter analyze` 無 issue、`flutter test` **257 passed**(248 +新 7 +改寫 2)。 + 新增 `test/customer_place_order_timeout_test.dart` 7 案(逾時已建/409 已建/逾時期間已被接單 + 連司機資訊帶出/真的沒建照常報錯/對帳也失敗不編故事/400 不觸發對帳/終態訂單不算數); + `driver_controller_test` 加 2 案(逾時但其實接到了、逾時且真的沒接到)並**改寫**原本 + 「回別的行程/null 時不覆蓋樂觀行程」那條——它釘的正是本輪要修掉的行為。 + **反向確認**:兩處修正各自拿掉後,5 案 FAIL。 +- **✅ 模擬器實跑(`m6_pixel` driver flavor + docker compose)**: + 司機 A(`simexp01`)上線收到 ride #8 接單卡 → **趁他還沒按,用 API 讓司機 B(`simexp02`)接走** + → 司機 A 按「接單」→ 後端回 200「手慢了」→ **App 沒有出現行程卡**, + 改顯示紅色橫幅**「這單已被其他司機接走」**,畫面回到「等待派單中」。 + DB 交叉驗證 ride #8 `driver_id = 6`(司機 B),與畫面一致。 +- **誠實標記**:「逾時但其實成功」這條在真機上不好精準重現(要讓回應剛好在 + `receiveTimeout` 後才丟失),**只有單元測試覆蓋**,未在模擬器上實跑過。 + +--- + ## 下次任務 > **✅ 維護項 5「清開發殘留」已完成(2026-07-28)**,詳見上方。 @@ -849,8 +904,12 @@ admin 的全域 query 錯誤處理有去重 key 且整個 repo 沒有 `refetchIn > 1. ~~**App 生命週期**~~ ✅ **已完成(2026-07-28 第四輪)**,見上方專段。 > 2. **多裝置/同帳號重複登入**:同一司機在兩台裝置上線,後端沒有踢舊 session 的機制, > 兩邊都會收派單——先確認後端行為,再決定 App 該不該處理。 -> 3. **弱網**(非全斷):`adb shell svc data` 或模擬器限速下的逾時分支, -> api_error 的逾時文案與重試行為只在單元測試層驗過,沒在真裝置跑過。 +> 3. ~~**弱網**(非全斷)的逾時分支~~ ✅ **已完成(2026-07-28 第五輪)**,見上方專段 +> (真正的問題不是文案,是「沒丟例外 = 成功」的判定)。 +> 4. **其他有副作用的操作是否也有同一個洞**:`pickUp`/`completeRide`/`cancelRide` +> 在逾時後同樣可能「其實成功了」。本輪只修了最貴的兩條(接單、建單)—— +> 完成行程逾時會讓司機重按,後端回 409 而司機仍停在行程卡上。 +> **條件**:等第五輪的做法在真機上跑一陣子沒問題,再用同一套 `_confirm*` 模式推廣。 > **🎨 App icon(叫車系統圖示)✅ 已完成(2026-07-15,PR #15)**:品牌綠 LINE green #06C755 + 白色計程車, > 以 `flutter_launcher_icons` 產生 Android(含 adaptive icon)與 iOS 各尺寸,driver/customer 兩 flavor 共用。 diff --git a/lib/customer/customer_controller.dart b/lib/customer/customer_controller.dart index e2de6ed..0f3ee3b 100644 --- a/lib/customer/customer_controller.dart +++ b/lib/customer/customer_controller.dart @@ -852,36 +852,70 @@ class CustomerController extends ChangeNotifier { // P2:null =不指定,client 端不會帶這個鍵。 requiredVehicleType: _requiredVehicleType?.code, ); - _activeRide = ride; - _lastActiveRide = ride; - // 這趟已送出,編輯狀態不該留到下一趟。 - _passengers.clear(); - // 預估屬於「建單前」的輔助資訊,送出後就該收掉,不留到下一趟。 - _estimate = null; - _estimating = false; - _estDropoffLat = null; - _estDropoffLng = null; - _driverName = null; - _driverInfo = null; - // 新的一趟開始 → 上一趟的取消原因不該還掛著。 - _cancelReason = null; - _cancelledVehicleType = null; - _rideCancelled = false; - _liveEtaSec = null; - _liveDistM = null; - _liveDriverLat = null; - _liveDriverLng = null; - _driverArrived = false; - _completedSummary = null; - _error = null; - _startPolling(); + _applyCreatedRide(ride); } on ApiException catch (e) { + // 建單是**有副作用**的請求:逾時/斷線(`statusCode == null`)代表 + // 「不知道後端有沒有收到」,而 409 更是明說「你已經有一張進行中的訂單」—— + // 那張多半就是上一次逾時真的建起來的。兩者都先去問後端到底有沒有單, + // 不能直接把「請求逾時」丟給乘客:他會停在叫車表單,再按一次就得到 + // 「已有進行中的訂單」,而畫面上根本沒有任何訂單可看。 + if ((e.statusCode == null || e.statusCode == 409) && + await _adoptExistingRide()) { + return; + } _error = e.message; } finally { _setBusy(false); } } + /// 建單失敗後向後端確認是否其實已經有一張進行中的訂單;有就直接接手它。 + /// 回 true 代表「這趟其實成立了」,呼叫端不該再報錯。 + Future _adoptExistingRide() async { + try { + final ride = await _api.activeRide(); + if (ride == null || RideStatus.isTerminal(ride.status)) return false; + _applyCreatedRide(ride); + // 逾時期間可能已經被司機接走了:這行把司機姓名/車輛補回來, + // 不必等下一個輪詢週期才顯示。 + _applyActiveRide(ride); + return true; + } on ApiException { + // 連問都問不到(網路仍不通)→ 維持原本的錯誤回報,不編故事。 + return false; + } + } + + /// 一趟新訂單成立後的狀態切換(建單成功與「其實已經建好了」共用)。 + /// + /// 兩條路徑必須共用同一份清單:漏掉其中一項,就會把上一趟的司機、取消通知或 + /// 完成卡帶進這一趟。 + void _applyCreatedRide(CustomerRide ride) { + _activeRide = ride; + _lastActiveRide = ride; + // 這趟已送出,編輯狀態不該留到下一趟。 + _passengers.clear(); + // 預估屬於「建單前」的輔助資訊,送出後就該收掉,不留到下一趟。 + _estimate = null; + _estimating = false; + _estDropoffLat = null; + _estDropoffLng = null; + _driverName = null; + _driverInfo = null; + // 新的一趟開始 → 上一趟的取消原因不該還掛著。 + _cancelReason = null; + _cancelledVehicleType = null; + _rideCancelled = false; + _liveEtaSec = null; + _liveDistM = null; + _liveDriverLat = null; + _liveDriverLng = null; + _driverArrived = false; + _completedSummary = null; + _error = null; + _startPolling(); + } + /// [silent] = 這次刷新不是使用者按出來的(背景輪詢),失敗時**不寫全域 error**。 /// 15 秒一次的輪詢若把失敗丟給畫面層,後端一斷線就變成每 15 秒彈一次 SnackBar /// 蓋住 sheet 上的按鈕,而使用者沒有任何辦法讓它停——他根本沒按過什麼。 diff --git a/lib/driver/driver_controller.dart b/lib/driver/driver_controller.dart index cb991b8..0989dfd 100644 --- a/lib/driver/driver_controller.dart +++ b/lib/driver/driver_controller.dart @@ -13,6 +13,13 @@ import '../core/push/driver_push_service.dart'; import '../core/storage/token_storage.dart'; import '../core/ws/fleet_ws_client.dart'; +/// 接單之後向後端確認的三種結果。 +/// +/// **「不知道」必須與「沒接到」分開**:兩者都不是 confirmed,但處置相反—— +/// 沒接到要把樂觀行程卡收掉,不知道(重讀也失敗)則要留著, +/// 否則司機真的接到單卻看不到行程。 +enum _AcceptOutcome { confirmed, rejected, unknown } + /// 司機端狀態:登入、上線、WS 派單、行程操作。 class DriverController extends ChangeNotifier { DriverController({ @@ -533,28 +540,49 @@ class DriverController extends ChangeNotifier { // 以後端為權威補齊:**推播喚醒路徑**的 offer 來自 FCM data,data 值全是字串、 // 不帶結構化的 stops 陣列(見 pitfall-fcm-data-all-strings),所以樂觀行程會缺全程。 // 重讀 active 讓多停靠點清單/多點地圖一定齊全,不必讓推播 payload 塞 stops。 - await _refreshActiveAfterAccept(offer.rideId); + // + // **同時這也是「到底有沒有接到」的唯一判準**:後端在「被別人接走」與 + // 「非待命狀態」時回的是 **HTTP 200 + 一句訊息**(不是錯誤), + // 只看有沒有丟例外,就會在沒接到的情況下留著一張別人的行程卡。 + final outcome = await _confirmAccepted(offer.rideId); + if (outcome == _AcceptOutcome.rejected) { + _activeRide = null; + _setError('這單已被其他司機接走'); + } } on ApiException catch (e) { - _setApiError(e); + // 連線類錯誤(沒收到 HTTP 回應)= **請求可能已經送達後端**:接單也許已經成功, + // 只是回應在路上丟了。這時候若直接報錯,司機會以為沒接到而按「略過」, + // 而後端已把他設成載客中——他收不到新派單、也無法離線,且畫面上什麼都沒有。 + if (e.statusCode == null && + await _confirmAccepted(offer.rideId) == _AcceptOutcome.confirmed) { + _pendingOffer = null; + _setError(null); + } else { + _setApiError(e); + } } finally { _busy = false; notifyListeners(); } } - /// 接單後重讀 active,以後端回傳為權威補齊樂觀 offer 缺的欄位(尤其 stops)。 + /// 向後端確認這張單現在是不是我的,並以後端資料覆蓋樂觀值。 /// - /// **只在後端回傳非 null 且 rideId 相符時覆蓋**——active API 對剛接的單短暫回 null - /// 或競態回別的行程時,寧可保留樂觀設定,也不要把剛接到的單清掉。 - /// 重讀失敗(網路)不算接單失敗:吞掉例外、不覆寫 error。 - Future _refreshActiveAfterAccept(int rideId) async { + /// 後端 `AcceptRide` 是同步寫入(同一個請求裡更新 rides 與 driver 狀態)後才回應, + /// 所以「回應之後 active 查得到」是可以依賴的——`null` 代表**真的不是我的**, + /// 不是還沒寫好。 + /// 只有重讀本身失敗時才回 [_AcceptOutcome.unknown]:那代表網路仍不通, + /// 這時保留樂觀行程比清掉安全(真的接到卻看不到行程,司機無事可做)。 + Future<_AcceptOutcome> _confirmAccepted(int rideId) async { try { final fresh = await _api.activeRide(); if (fresh != null && fresh.rideId == rideId) { _activeRide = fresh; + return _AcceptOutcome.confirmed; } + return _AcceptOutcome.rejected; } on ApiException { - // 樂觀行程已足以繼續作業;重讀失敗不打斷接單流程。 + return _AcceptOutcome.unknown; } } diff --git a/test/customer_place_order_timeout_test.dart b/test/customer_place_order_timeout_test.dart new file mode 100644 index 0000000..b3ef8d8 --- /dev/null +++ b/test/customer_place_order_timeout_test.dart @@ -0,0 +1,219 @@ +import 'package:dio/dio.dart'; +import 'package:flutter/services.dart'; +import 'package:flutter_test/flutter_test.dart'; +import 'package:line_fleet_app/core/api/customer_api_client.dart'; +import 'package:line_fleet_app/core/api/fleet_api_client.dart' show ApiException; +import 'package:line_fleet_app/core/models/models.dart'; +import 'package:line_fleet_app/core/storage/customer_token_storage.dart'; +import 'package:line_fleet_app/core/ws/fleet_ws_client.dart'; +import 'package:line_fleet_app/customer/customer_controller.dart'; + +/// 建單是**有副作用**的請求:逾時只代表「沒收到回應」,不代表後端沒建。 +/// 實測後端:同一乘客第二次建單會被擋下並回 **409「已有進行中的訂單」**—— +/// 也就是說,逾時後再按一次,乘客會得到一句與畫面完全矛盾的話 +/// (他面前根本沒有任何訂單),而唯一的出路是重開 App。 +void main() { + TestWidgetsFlutterBinding.ensureInitialized(); + + late _CreateFakeApi api; + late CustomerController ctrl; + + setUp(() { + // placeOrder 的前半段要定位權限與座標;測試環境沒有平台端,改接管 geolocator 的 + // method channel,讓「取得定位」這段照常成立,才測得到後面的建單與對帳。 + _mockGeolocator(); + api = _CreateFakeApi(); + ctrl = CustomerController( + storage: _MemoryCustomerStorage(), + api: api, + wsFactory: FleetWsClient.silent, + ); + }); + + tearDown(() => ctrl.dispose()); + + Future login() => ctrl.login(lineUserId: 'u', password: 'p'); + + test('建單逾時但後端其實建好了 → 接手那張單,不報錯', () async { + await login(); + api.createError = ApiException('請求逾時,請稍後再試'); // statusCode == null + api.existingRide = _ride(71, RideStatus.requested); + + await ctrl.placeOrder(pickupAddress: '台北101', dropoffAddress: '台北車站'); + + expect(ctrl.activeRide?.rideId, 71, reason: '後端有單就該進配對中畫面'); + expect(ctrl.error, isNull, reason: '單其實建起來了,不能說失敗'); + }); + + test('重按後拿到 409「已有進行中的訂單」→ 也接手,不把矛盾訊息丟給乘客', () async { + await login(); + api.createError = ApiException('已有進行中的訂單', statusCode: 409); + api.existingRide = _ride(72, RideStatus.assigned); + + await ctrl.placeOrder(pickupAddress: '台北101', dropoffAddress: '台北車站'); + + expect(ctrl.activeRide?.rideId, 72); + expect(ctrl.error, isNull); + }); + + test('逾時期間已被司機接走 → 連司機資訊一起帶出來,不必等下一輪輪詢', () async { + await login(); + api.createError = ApiException('請求逾時,請稍後再試'); + // 司機資訊在後端是**扁平鍵**(與 WS payload 同一組),不是巢狀物件。 + api.existingRide = CustomerRide.fromJson({ + 'id': 73, + 'status': RideStatus.accepted, + 'driver_name': '阿明', + 'driver_phone': '0912345678', + 'driver_vehicle_type': 'sedan', + 'driver_plate_number': 'ABC-1234', + }); + + await ctrl.placeOrder(pickupAddress: '台北101', dropoffAddress: '台北車站'); + + expect(ctrl.activeRide?.rideId, 73); + expect(ctrl.driverName, '阿明'); + expect(ctrl.driverInfo?.plateNumber, 'ABC-1234'); + }); + + test('逾時且後端真的沒建 → 照常報錯(不能因為對帳就把失敗吞掉)', () async { + await login(); + api.createError = ApiException('請求逾時,請稍後再試'); + api.existingRide = null; + + await ctrl.placeOrder(pickupAddress: '台北101', dropoffAddress: '台北車站'); + + expect(ctrl.activeRide, isNull); + expect(ctrl.error, '請求逾時,請稍後再試'); + }); + + test('對帳本身也失敗(網路仍不通)→ 維持原本的錯誤,不編故事', () async { + await login(); + api.createError = ApiException('無法連線到伺服器,請檢查網路'); + api.activeError = ApiException('無法連線到伺服器,請檢查網路'); + + await ctrl.placeOrder(pickupAddress: '台北101', dropoffAddress: '台北車站'); + + expect(ctrl.activeRide, isNull); + expect(ctrl.error, '無法連線到伺服器,請檢查網路'); + }); + + test('400 之類的輸入錯誤不觸發對帳(那是真的沒建)', () async { + await login(); + api.createError = ApiException('座標格式錯誤', statusCode: 400); + api.existingRide = _ride(74, RideStatus.requested); + final callsBefore = api.activeCalls; // 登入時的還原也會查一次 + + await ctrl.placeOrder(pickupAddress: '台北101', dropoffAddress: '台北車站'); + + expect(ctrl.activeRide, isNull, reason: '不該把別的既有訂單當成這次建單的結果'); + expect(ctrl.error, '座標格式錯誤'); + expect(api.activeCalls, callsBefore, reason: '輸入錯誤不必去問後端有沒有單'); + }); + + test('接手的是終態訂單時不算數(剛結束的上一趟不能變成這一趟)', () async { + await login(); + api.createError = ApiException('請求逾時,請稍後再試'); + api.existingRide = _ride(75, RideStatus.completed); + + await ctrl.placeOrder(pickupAddress: '台北101', dropoffAddress: '台北車站'); + + expect(ctrl.activeRide, isNull); + expect(ctrl.error, '請求逾時,請稍後再試'); + }); +} + +/// geolocator 的預設實作走 `flutter.baseflow.com/geolocator` 這支 method channel。 +/// 權限給 whileInUse(enum 第 3 個 = index 2),位置固定在台北 101。 +void _mockGeolocator() { + TestDefaultBinaryMessengerBinding.instance.defaultBinaryMessenger + .setMockMethodCallHandler( + const MethodChannel('flutter.baseflow.com/geolocator'), + (call) async { + switch (call.method) { + case 'checkPermission': + case 'requestPermission': + return 2; // LocationPermission.whileInUse + case 'isLocationServiceEnabled': + return true; + case 'getCurrentPosition': + case 'getLastKnownPosition': + return { + 'latitude': 25.0335, + 'longitude': 121.5655, + 'timestamp': DateTime.now().millisecondsSinceEpoch, + 'accuracy': 5.0, + 'altitude': 0.0, + 'altitude_accuracy': 0.0, + 'heading': 0.0, + 'heading_accuracy': 0.0, + 'speed': 0.0, + 'speed_accuracy': 0.0, + 'is_mocked': true, + }; + } + return null; + }, + ); +} + +CustomerRide _ride(int id, int status) => + CustomerRide.fromJson({'id': id, 'status': status}); + +class _CreateFakeApi extends CustomerApiClient { + _CreateFakeApi() + : super(dio: Dio(BaseOptions(baseUrl: 'http://test.invalid/api'))); + + ApiException? createError; + ApiException? activeError; + CustomerRide? existingRide; + int activeCalls = 0; + + @override + void setToken(String? token) {} + + @override + Future login({ + required String lineUserId, + required String password, + }) async => + const CustomerLoginResult(customerId: 3, token: 'tok', name: '小美'); + + @override + Future activeRide() async { + activeCalls++; + if (activeError != null) throw activeError!; + return existingRide; + } + + @override + Future> fetchLostItems() async => const []; + + @override + Future createRide({ + required double pickupLat, + required double pickupLng, + required String pickupAddress, + String? dropoffAddress, + double? dropoffLat, + double? dropoffLng, + List stops = const [], + String? requiredVehicleType, + }) async { + if (createError != null) throw createError!; + return _ride(1, RideStatus.requested); + } +} + +class _MemoryCustomerStorage extends CustomerTokenStorage { + CustomerSession? _saved; + + @override + Future read() async => _saved; + + @override + Future save(CustomerSession session) async => _saved = session; + + @override + Future clear() async => _saved = null; +} diff --git a/test/driver_controller_test.dart b/test/driver_controller_test.dart index 79661b3..a6834b6 100644 --- a/test/driver_controller_test.dart +++ b/test/driver_controller_test.dart @@ -103,6 +103,8 @@ void main() { test('WS ride.assigned 帶 pickup 座標 → acceptOffer 後 activeRide 有上車點座標', () async { // 司機端地圖要標出上車點;address 字串無法定位,座標得從派單事件一路帶到 activeRide。 + // 接單後的確認重讀失敗(弱網)=「不知道」→ 保留樂觀行程,正好驗到 offer→activeRide 的欄位對映。 + api.activeError = ApiException('請求逾時,請稍後再試'); await ctrl.init(); await ctrl.login(lineUserId: 'U_driver', password: 'pw'); @@ -126,6 +128,8 @@ void main() { test('WS ride.assigned 帶 stops → 接單「當下」activeRide 就有全程(N4)', () async { // 實跑抓到:RideOffer 沒解析 stops、acceptOffer 沒帶,接單當下清單與 // 多點地圖不出現,要重啟 App 走 rides/active 還原才看得到。 + // 重讀失敗=「不知道」→ 保留樂觀行程,驗的是 offer 自己帶進來的全程。 + api.activeError = ApiException('請求逾時,請稍後再試'); await ctrl.init(); await ctrl.login(lineUserId: 'U_driver', password: 'pw'); @@ -183,12 +187,14 @@ void main() { expect(ctrl.activeRide?.stops.length, 4); }); - test('acceptOffer 重讀 active 回別的行程/null 時,不覆蓋剛接到的樂觀行程', () async { - // 防競態:active API 短暫回 null 或回到別的 rideId 時,不能把剛接到的單清掉。 + test('acceptOffer 後 active 不是這張單 = 沒接到:收掉樂觀行程並說明', () async { + // 後端在「被別人接走」與「非待命狀態」時回的是 **HTTP 200 + 一句訊息**, + // 不是錯誤。只看有沒有丟例外,司機就會抱著一張別人的行程卡出發, + // 直到按下「乘客已上車」被 409 擋下才發現。 await ctrl.init(); await ctrl.login(lineUserId: 'U_driver', password: 'pw'); - // 後端回 rideId 不符(模擬競態)。 + // 後端說:你手上的 active 是別張單(或根本沒有)。 api.restoreRide = ActiveRide.fromBackendJson(const { 'id': 999, 'status': RideStatus.accepted, @@ -202,8 +208,52 @@ void main() { )); await ctrl.acceptOffer(); - expect(ctrl.activeRide?.rideId, 55, reason: '保留樂觀行程,不被別的 rideId 蓋掉'); - expect(ctrl.activeRide?.address, '士林夜市'); + expect(ctrl.activeRide, isNull, reason: '沒接到就不能留著行程卡'); + expect(ctrl.error, '這單已被其他司機接走'); + }); + + test('接單逾時但後端其實接到了 → 不報錯,直接進行程卡', () async { + // 弱網下最貴的一種:請求送達了、回應丟了。報錯會讓司機按「略過」, + // 而後端已把他設成載客中——他收不到新派單、也無法離線,畫面上卻什麼都沒有。 + await ctrl.init(); + await ctrl.login(lineUserId: 'U_driver', password: 'pw'); + + api.acceptError = ApiException('請求逾時,請稍後再試'); // statusCode == null = 沒收到回應 + api.restoreRide = ActiveRide.fromBackendJson(const { + 'id': 61, + 'status': RideStatus.accepted, + 'pickup_address': '南港展覽館', + }); + + ctrl.handleWsEventForTest(FleetWsEvent( + type: FleetEventTypes.rideAssigned, + rideId: 61, + payload: {'address': '南港展覽館'}, + )); + await ctrl.acceptOffer(); + + expect(ctrl.activeRide?.rideId, 61); + expect(ctrl.pendingOffer, isNull, reason: '接到了就不該還留著接單卡'); + expect(ctrl.error, isNull, reason: '其實成功了,不能報錯'); + }); + + test('接單逾時且後端也沒接到 → 照常報錯,接單卡留著讓司機再試', () async { + await ctrl.init(); + await ctrl.login(lineUserId: 'U_driver', password: 'pw'); + + api.acceptError = ApiException('請求逾時,請稍後再試'); + api.restoreRide = null; + + ctrl.handleWsEventForTest(FleetWsEvent( + type: FleetEventTypes.rideAssigned, + rideId: 62, + payload: {'address': '內湖'}, + )); + await ctrl.acceptOffer(); + + expect(ctrl.activeRide, isNull); + expect(ctrl.pendingOffer?.rideId, 62); + expect(ctrl.error, '請求逾時,請稍後再試'); }); test('init 還原行程時從 rides/active 的 pickup_point 取得上車點座標', () async { @@ -229,6 +279,8 @@ void main() { }); test('WS ride.assigned 帶 dropoff → acceptOffer 預載目的地', () async { + // 同上:確認重讀失敗時保留樂觀行程,驗 offer 的目的地有進到 activeRide。 + api.activeError = ApiException('請求逾時,請稍後再試'); await ctrl.init(); await ctrl.login(lineUserId: 'U_driver', password: 'pw'); @@ -501,6 +553,8 @@ class _FakeFleetApi extends FleetApiClient { String? lastToken; ApiException? loginError; ApiException? acceptError; + /// 讓 `GET /driver/rides/active` 失敗(模擬弱網):接單後的確認會回「不知道」。 + ApiException? activeError; ApiException? completeError; ApiException? deviceTokenError; ActiveRide? restoreRide; @@ -536,7 +590,10 @@ class _FakeFleetApi extends FleetApiClient { } @override - Future activeRide() async => restoreRide; + Future activeRide() async { + if (activeError != null) throw activeError!; + return restoreRide; + } @override Future> fetchLostItems() async => lostItems; @@ -568,6 +625,15 @@ class _FakeFleetApi extends FleetApiClient { Future acceptRide(int rideId) async { if (acceptError != null) throw acceptError!; acceptedRideIds.add(rideId); + // 真後端的 AcceptRide 在回應前就把 rides 與 driver 狀態寫完了,所以接單成功後 + // `GET /driver/rides/active` **立即**查得到這張單。替身必須忠實反映這件事—— + // controller 正是以「重讀 active 是不是這張單」判斷到底有沒有接到 + // (後端「被別人接走」是 HTTP 200,不是例外)。 + restoreRide ??= ActiveRide( + rideId: rideId, + address: '台北車站', + phase: DriverRidePhase.enRouteToPickup, + ); return '接單成功'; }