Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
47 changes: 45 additions & 2 deletions docs/TODO.md
Original file line number Diff line number Diff line change
Expand Up @@ -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:<id>:loc`),派單距離會以最後回報的那台為準。
- 後端**沒有踢舊 session 的機制**(JWT 無狀態)。要不要「一個帳號只能一台上線」是產品決策,
不該由 App 端片面實作。

---

## 下次任務

> **✅ 維護項 5「清開發殘留」已完成(2026-07-28)**,詳見上方。
Expand Down Expand Up @@ -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`
Expand Down
19 changes: 18 additions & 1 deletion lib/driver/driver_controller.dart
Original file line number Diff line number Diff line change
Expand Up @@ -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(
Expand All @@ -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 &&
Expand Down
183 changes: 183 additions & 0 deletions test/driver_multi_device_test.dart
Original file line number Diff line number Diff line change
@@ -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<void> 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<void>.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<void>.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<void>.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<void>.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<LoginResult> login({
required String lineUserId,
required String password,
}) async =>
const LoginResult(driverId: 7, token: 'tok', name: '阿明');

@override
Future<ActiveRide?> activeRide() async {
activeCalls++;
return restoreRide;
}

@override
Future<String> acceptRide(int rideId) async {
// 比照真後端:接單成功後 active 立即查得到(見 driver_controller_test 的說明)。
restoreRide ??= ActiveRide(
rideId: rideId,
address: '台北車站',
phase: DriverRidePhase.enRouteToPickup,
);
return '接單成功';
}

@override
Future<DriverVehicle> fetchVehicle() async => const DriverVehicle(
vehicleType: 'sedan',
plateNumber: 'ABC-1234',
hasVehicle: true,
reviewStatus: VehicleReviewStatus.approved,
canAccept: true,
);

@override
Future<List<LostItemRequest>> fetchLostItems() async => const [];
}