Skip to content
Merged
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
8 changes: 6 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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()` 才訂閱——
廣播串流不緩衝,事件當場消失。**司機端「被殺 → 點推播 → 接單卡」與乘客端
Expand Down
39 changes: 38 additions & 1 deletion docs/TODO.md
Original file line number Diff line number Diff line change
Expand Up @@ -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-完成)
Expand All @@ -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 點)。
Expand Down Expand Up @@ -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)**,詳見上方。
Expand Down
7 changes: 4 additions & 3 deletions lib/core/push/firebase_push_service.dart
Original file line number Diff line number Diff line change
Expand Up @@ -119,17 +119,18 @@ class FirebaseFleetPushService implements FleetPushService {
}
}

/// 司機端:只收派單邀請(喚醒後要顯示接單卡)。
/// 司機端:派單邀請(喚醒後要顯示接單卡)+乘客傳來的對話訊息。
Future<FleetPushService> createDriverPushService() =>
_create(isRideOfferPush);
_create(isDriverPush);

/// 乘客端:收行程狀態變化。
///
/// **推播只當作「去跟後端對一次帳」的訊號**,payload 不直接套用到畫面——
/// FCM data 的值全是字串又稀疏(見 pitfall-fcm-data-all-strings),
/// 直接灌進 `_handleWsEvent` 會把司機姓名/車牌之類的欄位洗成空的。
/// 對話訊息同樣只當訊號:推播只負責把未讀角標點亮,內容由聊天室自己以 REST 補齊。
Future<FleetPushService> createCustomerPushService() =>
_create(isCustomerRidePush);
_create(isCustomerPush);

/// 依環境建立推播服務:有 Firebase 設定則用 FCM,否則 no-op
/// (**沒有 `google-services.json` 的裝置照樣能用 App,只是少了推播喚醒**)。
Expand Down
14 changes: 14 additions & 0 deletions lib/core/push/push_payload.dart
Original file line number Diff line number Diff line change
Expand Up @@ -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);
20 changes: 19 additions & 1 deletion lib/customer/customer_controller.dart
Original file line number Diff line number Diff line change
Expand Up @@ -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';

Expand Down Expand Up @@ -439,7 +440,14 @@ class CustomerController extends ChangeNotifier {
/// 訂閱推播:事件本身只當**對帳訊號**,token 輪替則重新註冊。
Future<void> _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()));
Expand All @@ -459,6 +467,16 @@ class CustomerController extends ChangeNotifier {
await refreshLostItems();
}

/// 收到「司機傳來訊息」的推播:只把未讀角標點亮,內容等聊天室自己以 REST 補齊。
///
/// 聊天室開著時忽略:那代表 App 在前景、WS 也連著,同一則訊息已經由 WS 送到並顯示,
/// 這裡再加一次會把角標加在乘客正在看的訊息上。
void _onChatPush() {
if (_chatVisible) return;
_unreadChat++;
notifyListeners();
}

/// 登入後向後端註冊推播 token;token 輪替時亦會重註冊。
///
/// **靜默降級**:這是登入與輪替時的背景動作,乘客沒按任何東西。註冊失敗只代表
Expand Down
26 changes: 25 additions & 1 deletion lib/driver/driver_controller.dart
Original file line number Diff line number Diff line change
Expand Up @@ -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';

Expand Down Expand Up @@ -409,11 +410,34 @@ class DriverController extends ChangeNotifier {

Future<void> _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<void> _syncDeviceToken() async {
if (!_push.isAvailable || _session == null) return;
Expand Down
Loading
Loading