From 150c373073d959390f45b6357eeeea8cf29198bb Mon Sep 17 00:00:00 2001 From: awei Date: Thu, 30 Jul 2026 00:43:03 +0800 Subject: [PATCH] =?UTF-8?q?feat(app):=20=E5=B0=8D=E8=A9=B1=E8=A8=8A?= =?UTF-8?q?=E6=81=AF=E7=9A=84=E6=8E=A8=E6=92=AD=E2=80=94=E2=80=94=E5=85=A9?= =?UTF-8?q?=E7=AB=AF=E6=94=B6=E4=B8=8B=20chat.message=E3=80=81=E5=8F=AA?= =?UTF-8?q?=E9=BB=9E=E4=BA=AE=E6=9C=AA=E8=AE=80=E8=A7=92=E6=A8=99=EF=BC=88?= =?UTF-8?q?=E7=AC=AC=E5=8D=81=E4=B8=89=E8=BC=AA=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 對話先前只走 WS:對方 App 一離開前景 WS 就斷了,訊息只會躺在伺服器上, 要等他自己再打開 App 才看得到。斷掉的正是最需要的兩個情境—— 司機到了要聯絡乘客、乘客回報遺失物。後端同批補上送出路徑(dispatch #62)。 - 白名單:新增 isChatPush,兩端過濾器改成 isDriverPush(派單邀請 ∪ 對話)與 isCustomerPush(行程狀態五種 ∪ 對話);原本兩支保留、語意不變。 - 收到對話推播只點亮未讀角標: * 不能餵進 _handleWsEvent——推播 data 只有 type 與 ride_id,RideMessage.fromJson 會解析失敗被丟掉,角標根本不會動(司機端原本整條推播都直接進 _handleWsEvent)。 * 不必重讀行程/協尋——對話不影響行程狀態。 * 聊天室開著時忽略——那代表 App 在前景、WS 也連著,同一則已經顯示了。 驗收:flutter analyze 無 issue、flutter test 325 passed(317+新 8,含「派單推播照樣 開接單卡」與「行程狀態推播仍走對帳」兩案的回歸網)。 反向確認:白名單拿掉對話 → 1 案 FAIL;兩端 controller 拿掉分流 → 2 案 FAIL。 Co-Authored-By: Claude Opus 5 --- README.md | 8 +- docs/TODO.md | 39 +++- lib/core/push/firebase_push_service.dart | 7 +- lib/core/push/push_payload.dart | 14 ++ lib/customer/customer_controller.dart | 20 +- lib/driver/driver_controller.dart | 26 ++- test/chat_push_test.dart | 250 +++++++++++++++++++++++ 7 files changed, 356 insertions(+), 8 deletions(-) create mode 100644 test/chat_push_test.dart diff --git a/README.md b/README.md index 076eb0f..9325515 100644 --- a/README.md +++ b/README.md @@ -215,10 +215,14 @@ REST 一定完整,而推播要傳達的資訊只有「有事發生了」。 至此三端齊備:**乘客評 → 司機看得到自己的平均分 → 營運看得出誰評價低**。 詳見 [`docs/TODO.md`](docs/TODO.md)「⭐ 乘客評分司機」。 -**目前**:`flutter analyze` 無 issue、`flutter test` **317 passed**(44 個測試檔,2026-07-30 實跑)。 +**目前**:`flutter analyze` 無 issue、`flutter test` **325 passed**(45 個測試檔,2026-07-30 實跑)。 ~~291 passed(2026-07-29)~~ 是漏更新的舊數字——**這一行請跟著最後一次實跑一起改**。 -**2026-07-30 這一批**(詳見 [`docs/TODO.md`](docs/TODO.md) 第十二輪): +**2026-07-30 這一批**(詳見 [`docs/TODO.md`](docs/TODO.md) 第十二~十三輪): +- **對話訊息也會推播**:先前對話只走 WS,對方 App 一離開前景就收不到,訊息躺在伺服器上 + 等他自己再打開——「司機到了要聯絡乘客」「乘客回報遺失物」都因此斷線。 + 後端推給收訊那一方(dispatch PR #62),App 兩端收到後**只點亮未讀角標** + (推播 data 沒有訊息本體,內容由聊天室以 REST 補齊)。 - **點推播喚醒的事件不再被丟掉**:`getInitialMessage()`(App 被殺後點通知的唯一管道) 在 `runApp` 之前就把事件送進廣播串流,而 controller 要到 `init()` 才訂閱—— 廣播串流不緩衝,事件當場消失。**司機端「被殺 → 點推播 → 接單卡」與乘客端 diff --git a/docs/TODO.md b/docs/TODO.md index 6618385..dd09835 100644 --- a/docs/TODO.md +++ b/docs/TODO.md @@ -63,6 +63,7 @@ - [🔧 第十輪:聊天室回前景補讀+三條寫入路徑的逾時對帳](#-2026-07-29-第十輪-debug把第九輪的候選-23-修掉本批) - [📲 第十一輪:乘客端推播接線(候選 1 的前半)](#-2026-07-29-第十一輪乘客端推播接線候選-1-的前半) - [🔔 第十二輪:點推播喚醒的事件在沒人聽時被丟掉](#-2026-07-30-第十二輪點推播喚醒的那條路事件在沒人聽的時候就被丟掉了本批修掉) +- [💬 第十三輪:對話訊息的推播(兩端)](#-2026-07-30-第十三輪對話訊息的推播兩端) **四、維護、決策與待辦** - [🧹 清開發殘留 worktree/舊分支(維護項 5)](#-清開發殘留-worktree舊分支維護項-52026-07-28-完成) @@ -79,7 +80,7 @@ - **UI/UX 翻新(2026-07-10)**:LINE 綠亮暗雙主題;司機駕駛情境 UI;乘客地圖為底+卡片降級。靜態驗收 49 tests 通過;模擬器主鏈路待後端 docker 可起後補跑。 **登入/註冊頁 2026-07-23 補齊翻新**(先前是唯一漏網畫面),詳見下方「🔐 登入頁 UI/UX 翻新+驗證」。 - **座標導航(2026-07-10)**:司機端目的地導航改吃後端 `dropoff_point` 座標,地址僅供顯示與退路。 -- 單元測試:**44 個測試檔、`flutter test` 317 passed**(2026-07-30 實跑;`flutter analyze` 無 issue)。 +- 單元測試:**45 個測試檔、`flutter test` 325 passed**(2026-07-30 實跑;`flutter analyze` 無 issue)。 ~~(54 項)~~ 是 2026-07-10 的數字,長期沒更新,已更正——**本節的數字請跟著最後盤點日一起改**。 - 遠端:`github.com/thothawei/fleet-app`。**2026-07-29 實查**:`git ls-remote --heads origin` 只有 `main`、 `gh pr list` 三個 repo 的 open PR 皆為 0(開工前請自己再跑一次,見「下次任務」第 1 點)。 @@ -1491,6 +1492,42 @@ main() → createXxxPushService() → initialize() → getInitialMessage() → _ --- +## 💬 2026-07-30 第十三輪:對話訊息的推播(兩端) + +> 後端同批補上送出路徑(dispatch [PR #62](https://github.com/thothawei/fleet-dispatch/pull/62)): +> `ChatService.Send` 推給**收訊那一方**(不推發話者自己的其他裝置)。 +> App 這端要把 `chat.message` 收下來並做對的事。 + +**為什麼要做**:對話先前**只走 WS**——對方 App 一離開前景 WS 就斷了,訊息只會躺在 +伺服器上,要等他自己再打開 App 才看得到。斷掉的正是最需要的兩個情境: +**司機到了要聯絡乘客**、**乘客回報遺失物**。 + +### 改了什麼 + +- **白名單**:新增 `isChatPush`,兩端過濾器改成 + `isDriverPush = 派單邀請 ∪ 對話`、`isCustomerPush = 行程狀態五種 ∪ 對話`。 + 原本兩支(`isRideOfferPush`/`isCustomerRidePush`)保留、語意不變。 +- **收到對話推播只點亮未讀角標**,不做別的: + - **不能餵進 `_handleWsEvent`**:推播 data 只有 `type` 與 `ride_id`, + `RideMessage.fromJson` 會解析失敗被丟掉,角標根本不會動(司機端原本整條推播 + 都直接進 `_handleWsEvent`,這次多了一層分流)。 + - **不必重讀行程/協尋**:對話不影響行程狀態,多打兩支 API 只是浪費。 + - **聊天室開著時忽略**:那代表 App 在前景、WS 也連著,同一則訊息已經由 WS 送到並顯示, + 再加一次會把角標加在使用者正在看的訊息上。 +- 內容不放進推播 data,由聊天室自己以 REST(`afterId` 增量)補齊——與第十一輪 + 「推播只當訊號」同一條原則。 + +### 驗收 + +- `flutter analyze` 無 issue、`flutter test` **325 passed**(317 +新 8)。 + 新增 `test/chat_push_test.dart`:白名單 2 案、司機端 3 案(角標 +1/聊天室開著忽略/ + **派單推播照樣開接單卡**)、乘客端 3 案(角標 +1 且不重讀行程/聊天室開著忽略/ + **行程狀態推播仍走對帳**)。後兩案是這次新增分流的回歸網——分流寫錯會把原路徑吃掉。 +- **反向確認**:白名單拿掉對話 → 1 案 FAIL;兩端 controller 拿掉分流 → 2 案 FAIL。 +- **未做**:真裝置端到端(同 A2,卡 `google-services.json`)。 + +--- + ## 下次任務 > **✅ 維護項 5「清開發殘留」已完成(2026-07-28)**,詳見上方。 diff --git a/lib/core/push/firebase_push_service.dart b/lib/core/push/firebase_push_service.dart index c9f2a96..7acdd58 100644 --- a/lib/core/push/firebase_push_service.dart +++ b/lib/core/push/firebase_push_service.dart @@ -119,17 +119,18 @@ class FirebaseFleetPushService implements FleetPushService { } } -/// 司機端:只收派單邀請(喚醒後要顯示接單卡)。 +/// 司機端:派單邀請(喚醒後要顯示接單卡)+乘客傳來的對話訊息。 Future createDriverPushService() => - _create(isRideOfferPush); + _create(isDriverPush); /// 乘客端:收行程狀態變化。 /// /// **推播只當作「去跟後端對一次帳」的訊號**,payload 不直接套用到畫面—— /// FCM data 的值全是字串又稀疏(見 pitfall-fcm-data-all-strings), /// 直接灌進 `_handleWsEvent` 會把司機姓名/車牌之類的欄位洗成空的。 +/// 對話訊息同樣只當訊號:推播只負責把未讀角標點亮,內容由聊天室自己以 REST 補齊。 Future createCustomerPushService() => - _create(isCustomerRidePush); + _create(isCustomerPush); /// 依環境建立推播服務:有 Firebase 設定則用 FCM,否則 no-op /// (**沒有 `google-services.json` 的裝置照樣能用 App,只是少了推播喚醒**)。 diff --git a/lib/core/push/push_payload.dart b/lib/core/push/push_payload.dart index 1db12ec..2d7259e 100644 --- a/lib/core/push/push_payload.dart +++ b/lib/core/push/push_payload.dart @@ -55,3 +55,17 @@ const _customerPushTypes = { bool isCustomerRidePush(FleetWsEvent? event) => event != null && _customerPushTypes.contains(event.type); + +/// 對方傳來對話訊息(**兩端共用**)。 +/// +/// 後端只推給**收訊那一方**(發話者自己的裝置不推),所以 App 這端不必再判斷是誰說的。 +bool isChatPush(FleetWsEvent? event) => + event?.type == FleetEventTypes.chatMessage; + +/// 司機端接受的推播:派單邀請+對方訊息。 +bool isDriverPush(FleetWsEvent event) => + isRideOfferPush(event) || isChatPush(event); + +/// 乘客端接受的推播:行程狀態變化+對方訊息。 +bool isCustomerPush(FleetWsEvent event) => + isCustomerRidePush(event) || isChatPush(event); diff --git a/lib/customer/customer_controller.dart b/lib/customer/customer_controller.dart index c2f4a78..6e623ed 100644 --- a/lib/customer/customer_controller.dart +++ b/lib/customer/customer_controller.dart @@ -9,6 +9,7 @@ import '../core/api/fleet_api_client.dart' show ApiException; import '../core/config/app_config.dart'; import '../core/models/models.dart'; import '../core/push/fleet_push_service.dart'; +import '../core/push/push_payload.dart'; import '../core/storage/customer_token_storage.dart'; import '../core/ws/fleet_ws_client.dart'; @@ -439,7 +440,14 @@ class CustomerController extends ChangeNotifier { /// 訂閱推播:事件本身只當**對帳訊號**,token 輪替則重新註冊。 Future _bindPushListener() async { await _pushSub?.cancel(); - _pushSub = _push.rideEvents.listen((_) => unawaited(_handlePushEvent())); + _pushSub = _push.rideEvents.listen((event) { + // 對話訊息不必重讀行程與協尋:它只影響未讀角標,多打兩支 API 是浪費。 + if (isChatPush(event)) { + _onChatPush(); + return; + } + unawaited(_handlePushEvent()); + }); await _tokenRefreshSub?.cancel(); _tokenRefreshSub = _push.tokenRefresh.listen((_) => unawaited(_syncDeviceToken())); @@ -459,6 +467,16 @@ class CustomerController extends ChangeNotifier { await refreshLostItems(); } + /// 收到「司機傳來訊息」的推播:只把未讀角標點亮,內容等聊天室自己以 REST 補齊。 + /// + /// 聊天室開著時忽略:那代表 App 在前景、WS 也連著,同一則訊息已經由 WS 送到並顯示, + /// 這裡再加一次會把角標加在乘客正在看的訊息上。 + void _onChatPush() { + if (_chatVisible) return; + _unreadChat++; + notifyListeners(); + } + /// 登入後向後端註冊推播 token;token 輪替時亦會重註冊。 /// /// **靜默降級**:這是登入與輪替時的背景動作,乘客沒按任何東西。註冊失敗只代表 diff --git a/lib/driver/driver_controller.dart b/lib/driver/driver_controller.dart index 156ea24..cc65b31 100644 --- a/lib/driver/driver_controller.dart +++ b/lib/driver/driver_controller.dart @@ -10,6 +10,7 @@ import '../core/location/driver_location_permissions.dart'; import '../core/location/driver_location_settings.dart'; import '../core/models/models.dart'; import '../core/push/fleet_push_service.dart'; +import '../core/push/push_payload.dart'; import '../core/storage/token_storage.dart'; import '../core/ws/fleet_ws_client.dart'; @@ -409,11 +410,34 @@ class DriverController extends ChangeNotifier { Future _bindPushListener() async { await _pushSub?.cancel(); - _pushSub = _push.rideEvents.listen(_handleWsEvent); + _pushSub = _push.rideEvents.listen(_handlePushEvent); await _tokenRefreshSub?.cancel(); _tokenRefreshSub = _push.tokenRefresh.listen((_) => _syncDeviceToken()); } + /// 推播事件的入口。 + /// + /// 派單邀請直接走 `_handleWsEvent`——它的 data 是完整的(後端沒有「目前 offer」端點, + /// 喚醒後只能靠 payload 開接單卡)。**對話訊息不行**:推播 data 只有 `type` 與 `ride_id`, + /// 餵進去 `RideMessage.fromJson` 會解析失敗被丟掉,未讀角標不會動。 + void _handlePushEvent(FleetWsEvent event) { + if (isChatPush(event)) { + _onChatPush(); + return; + } + _handleWsEvent(event); + } + + /// 收到「乘客傳來訊息」的推播:只把未讀角標點亮,內容等聊天室自己以 REST 補齊。 + /// + /// 聊天室開著時忽略:那代表 App 在前景、WS 也連著,同一則訊息已經由 WS 送到並顯示, + /// 這裡再加一次會把角標加在使用者正在看的訊息上。 + void _onChatPush() { + if (_chatVisible) return; + _unreadChat++; + notifyListeners(); + } + /// 登入後向後端註冊 FCM token;token 刷新時亦會重註冊。 Future _syncDeviceToken() async { if (!_push.isAvailable || _session == null) return; diff --git a/test/chat_push_test.dart b/test/chat_push_test.dart new file mode 100644 index 0000000..5b23542 --- /dev/null +++ b/test/chat_push_test.dart @@ -0,0 +1,250 @@ +import 'dart:async'; + +import 'package:dio/dio.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'; +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/push/fleet_push_service.dart'; +import 'package:line_fleet_app/core/push/push_payload.dart'; +import 'package:line_fleet_app/core/storage/customer_token_storage.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/customer/customer_controller.dart'; +import 'package:line_fleet_app/driver/driver_controller.dart'; + +/// 對話訊息的推播(後端 dispatch 同批補上送出路徑)。 +/// +/// 先前對話**只走 WS**:對方 App 一離開前景 WS 就斷了,訊息只會躺在伺服器上, +/// 要等他自己再打開 App 才看得到——這對「司機到了要聯絡乘客」「乘客回報遺失物」 +/// 都是致命的。 +/// +/// App 這端要做兩件事:把 `chat.message` 放進兩端的推播白名單、 +/// 收到時**只點亮未讀角標**(內容等聊天室自己以 REST 補齊——推播 data 只有 +/// `type` 與 `ride_id`,餵給 `RideMessage.fromJson` 只會解析失敗被丟掉)。 +void main() { + group('哪些推播收得下來', () { + FleetWsEvent ev(String type) => + FleetWsEvent(type: type, rideId: 1, payload: const {}); + + test('chat.message 兩端都收', () { + expect(isChatPush(ev(FleetEventTypes.chatMessage)), isTrue); + expect(isDriverPush(ev(FleetEventTypes.chatMessage)), isTrue); + expect(isCustomerPush(ev(FleetEventTypes.chatMessage)), isTrue); + }); + + test('原本的白名單沒有被放寬', () { + // 司機端仍只要派單邀請(+對話)。 + expect(isDriverPush(ev(FleetEventTypes.rideAssigned)), isTrue); + expect(isDriverPush(ev(FleetEventTypes.rideCompleted)), isFalse); + expect(isDriverPush(ev(FleetEventTypes.driverLocation)), isFalse); + + // 乘客端仍是行程狀態五種(+對話)。 + expect(isCustomerPush(ev(FleetEventTypes.rideAccepted)), isTrue); + expect(isCustomerPush(ev(FleetEventTypes.rideAssigned)), isFalse, + reason: '派單邀請是司機端的'); + expect(isCustomerPush(ev(FleetEventTypes.driverLocation)), isFalse, + reason: '每 8 秒一則位置,拿它當推播只會把電池與額度燒光'); + }); + }); + + group('司機端', () { + test('收到對話推播 → 未讀角標 +1', () async { + final ctrl = _driver(); + addTearDown(ctrl.$1.dispose); + await ctrl.$1.init(); + expect(ctrl.$1.unreadChat, 0); + + ctrl.$2.emit(FleetWsEvent( + type: FleetEventTypes.chatMessage, + rideId: 9, + payload: const {}, + )); + await Future.delayed(Duration.zero); + + expect(ctrl.$1.unreadChat, 1); + }); + + test('聊天室開著時忽略——同一則 WS 已經送到並顯示了', () async { + final ctrl = _driver(); + addTearDown(ctrl.$1.dispose); + await ctrl.$1.init(); + ctrl.$1.setChatVisible(true); + + ctrl.$2.emit(FleetWsEvent( + type: FleetEventTypes.chatMessage, + rideId: 9, + payload: const {}, + )); + await Future.delayed(Duration.zero); + + expect(ctrl.$1.unreadChat, 0); + }); + + test('派單推播照樣開接單卡(多一層分流不能把原路徑弄斷)', () async { + final ctrl = _driver(); + addTearDown(ctrl.$1.dispose); + await ctrl.$1.init(); + + ctrl.$2.emit(FleetWsEvent( + type: FleetEventTypes.rideAssigned, + rideId: 21, + payload: const {'address': '台北車站', 'eta_sec': 300, 'dist_m': 1200}, + )); + await Future.delayed(Duration.zero); + + expect(ctrl.$1.pendingOffer?.rideId, 21); + expect(ctrl.$1.pendingOffer?.address, '台北車站'); + }); + }); + + group('乘客端', () { + test('收到對話推播 → 未讀角標 +1,且不必重讀行程', () async { + final api = _CustomerApi(); + final push = _FakePush(); + final ctrl = await _customer(api, push); + addTearDown(ctrl.dispose); + final activeCallsBefore = api.activeCalls; + + push.emit(FleetWsEvent( + type: FleetEventTypes.chatMessage, + rideId: 9, + payload: const {}, + )); + await Future.delayed(Duration.zero); + + expect(ctrl.unreadChat, 1); + expect(api.activeCalls, activeCallsBefore, + reason: '對話訊息不影響行程狀態,多打 API 只是浪費'); + }); + + test('聊天室開著時忽略', () async { + final api = _CustomerApi(); + final push = _FakePush(); + final ctrl = await _customer(api, push); + addTearDown(ctrl.dispose); + ctrl.setChatVisible(true); + + push.emit(FleetWsEvent( + type: FleetEventTypes.chatMessage, + rideId: 9, + payload: const {}, + )); + await Future.delayed(Duration.zero); + + expect(ctrl.unreadChat, 0); + }); + + test('行程狀態推播仍走對帳(沒被對話那條分流吃掉)', () async { + final api = _CustomerApi(); + final push = _FakePush(); + final ctrl = await _customer(api, push); + addTearDown(ctrl.dispose); + final before = api.activeCalls; + + push.emit(FleetWsEvent( + type: FleetEventTypes.driverArrived, + rideId: 9, + payload: const {}, + )); + await Future.delayed(Duration.zero); + + expect(api.activeCalls, greaterThan(before)); + }); + }); +} + +(DriverController, _FakePush) _driver() { + final push = _FakePush(); + final ctrl = DriverController( + storage: MemoryDriverAuthStore(), // 未登入:init() 不會打任何 API + api: _DriverApi(), + wsFactory: FleetWsClient.silent, + push: push, + ); + return (ctrl, push); +} + +Future _customer(_CustomerApi api, _FakePush push) async { + final storage = _MemoryCustomerStorage(); + await storage.save(const CustomerSession(customerId: 3, token: 'tok')); + final ctrl = CustomerController( + storage: storage, + api: api, + wsFactory: FleetWsClient.silent, + push: push, + ); + await ctrl.init(); + return ctrl; +} + +class _DriverApi extends FleetApiClient { + _DriverApi() : super(dio: Dio(BaseOptions(baseUrl: 'http://test.invalid/api'))); +} + +class _CustomerApi extends CustomerApiClient { + _CustomerApi() + : super(dio: Dio(BaseOptions(baseUrl: 'http://test.invalid/api'))); + + int activeCalls = 0; + + @override + Future activeRide() async { + activeCalls++; + return null; + } + + @override + Future> fetchLostItems() async => const []; + + @override + Future registerDeviceToken({ + required String platform, + required String token, + }) async {} + + @override + Future unregisterDeviceToken({required String token}) async {} +} + +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; +} + +class _FakePush implements FleetPushService { + final _controller = StreamController.broadcast(); + final _tokenRefresh = StreamController.broadcast(); + + void emit(FleetWsEvent event) => _controller.add(event); + + @override + Future initialize() async => true; + + @override + bool get isAvailable => true; + + @override + Future getToken() async => 'fcm-tok'; + + @override + Stream get rideEvents => _controller.stream; + + @override + Stream get tokenRefresh => _tokenRefresh.stream; + + @override + Future dispose() async { + await _tokenRefresh.close(); + await _controller.close(); + } +}