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
23 changes: 22 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -171,7 +171,28 @@ FCM data 的值一律是字串,App 端 `fleetEventFromPushData()` 會把座標
已核准→首頁;能不能接單以後端 `can_accept` 為準(App 不自行推導)。
admin 端在司機管理頁核准/退回(退回須附原因)。

**目前**:`flutter analyze` 無 issue、`flutter test` **179 passed**。
- **司機聯絡電話(2026-07-21)**:司機端車輛資訊頁加**獨立的電話區塊+獨立送出鈕**,
串後端 `PUT /api/driver/profile`。**不可與 `PUT /driver/vehicle` 共用**——那支會把
車輛審核重置為待審核(O5),司機改一次電話就會被踢出接單池。留空=清除號碼。
在此之前 `drivers.phone` 沒有任何寫入路徑,乘客端的撥號按鈕從未真正出現過。

**目前**:`flutter analyze` 無 issue、`flutter test` **182 passed**。

### 測試怎麼跑

```bash
flutter analyze
flutter test # 單元/widget(不含 integration_test/)

# 在真模擬器上跑真 App、打真後端(需先起後端 docker)
flutter test integration_test/driver_phone_test.dart \
-d <simulator-id> --flavor driver \
--dart-define=API_BASE=http://127.0.0.1:8080
```

> **iOS 的 UI 驗收優先走 `integration_test`**:它的點擊由 Flutter 自己派送,
> 不經過系統合成事件——`cliclick` 那類工具在無輔助使用授權的環境會**靜默失效**
> (游標會動、點擊卻到不了模擬器),別再跟座標纏鬥。

## 規劃中(尚未實作)

Expand Down
86 changes: 77 additions & 9 deletions docs/TODO.md
Original file line number Diff line number Diff line change
Expand Up @@ -59,8 +59,9 @@
兩個 shared scheme,bundle id 對齊 Android(`dev.linefleet.line_fleet_app.driver`/`.customer`),
顯示名走 xcconfig 變數;模擬器主畫面「司機端」「乘客端」**兩個 icon 並存不互相覆蓋**。
**✅ 階段 7 收尾**:README 補 iOS 段與 `API_BASE` 平台預設對照表;
CI 的 `build-ios` job(macos-latest,customer flavor 不簽名 build)**已寫好但推不上去**——
token 缺 `workflow` scope,改動留在本機工作區,需 `gh auth refresh -h github.com -s workflow`。
CI 的 `build-ios` job(macos-latest,customer flavor 不簽名 build)**已在 `origin/main`**
(`.github/workflows/flutter-ci.yml:31`;2026-07-21 覆核,先前記的「token 缺 workflow scope
推不上去」已不成立)。
**➡️ 只剩階段 5 實機部署**(需使用者接上 iPhone+Xcode 選 Personal Team+手機信任憑證,
產出是 A1「鎖屏長跑背景定位」的 iOS 實機驗收)**與階段 6 推播**(卡在付費 Apple 帳號)。
**實機已有、Apple 帳號為免費 Personal Team**:階段 1–5(含實機部署與 A1 背景定位實機驗收)
Expand Down Expand Up @@ -252,6 +253,30 @@

## 下次任務

> **⬅️ 從這裡開始(2026-07-21 收工時的狀態)**
>
> **0. 先合兩個待審 PR**(電話功能,三層都有實證,合併順序有相依):
> 1. [fleet-dispatch#42](https://github.com/thothawei/fleet-dispatch/pull/42)(`PUT /api/driver/profile`)**要先合**
> 2. [fleet-app#40](https://github.com/thothawei/fleet-app/pull/40)(司機端填寫入口)——後端未合前會 404
>
> **1. A5 階段 5:iOS 實機部署 → 產出 A1「鎖屏長跑背景定位」實機驗收**(最高優先)
> 這是掛最久且唯一沒有實機證據的核心功能;背景定位失效=司機靜默收不到派單,測試補不上。
> 阻塞**不是技術問題**,是三件需要人操作的事:接上 iPhone/Xcode 登入 Apple ID
> (`security find-identity` 目前 **0 valid identities**)/Runner target 選 Personal Team。
> 做完就跑:`flutter run -d ios -t lib/main_driver.dart --flavor driver --dart-define=API_BASE=http://<區網IP>:8080`
> ——**不用查 device-id,`-d ios` 會自動選唯一的 iOS 實機**。
> 驗收腳本已寫好:每 5 秒讀 Redis `driver:<id>:loc` 的 `updated_at`,輸出更新次數/
> 最大空窗/PASS-FAIL(後端沒掛 `gin.Logger()`,請求層不印 log,所以不看 log 看 Redis)。
> 腳本已收進 repo:`tool/watch_driver_location.sh <driver_id> [監看秒數]`。
> 已預先驗過:driver flavor 的 `flutter build ios --no-codesign` 可過(20.6MB)。
>
> **2. 若當下不方便接實機**,可獨立完成的候選:
> - **B5 評分/付款**:卡後端 Phase C(未開工),需要先談後端
> - **A2 FCM 推播**:需建 Firebase 專案 + `google-services.json` + 後端 FCM 實作(Android 可做,iOS 端卡付費帳號)
> - **WS 重連 jitter**:退避已上線但無抖動,後端重啟時所有司機會同時重連(量體大才有感)
>
> **3. 等你拍板才能動**:多停靠點的建單前車資預估(需後端新開報價 API,見「懸而未決」)

> **🎨 App icon(叫車系統圖示)✅ 已完成(2026-07-15,PR #15)**:品牌綠 LINE green #06C755 + 白色計程車,
> 以 `flutter_launcher_icons` 產生 Android(含 adaptive icon)與 iOS 各尺寸,driver/customer 兩 flavor 共用。

Expand Down Expand Up @@ -592,25 +617,68 @@ admin 月報表頁 UI 亦渲染相同數字(NT$85.00/NT$12.75/NT$3,012.75

### 司機端

- [ ] **車輛資訊設定頁**:車種**下拉選單**(轎車/休旅/七人座/無障礙/寵物用車,
顯示名稱在 App 對應,送後端 code)+車牌輸入+**聯絡電話**(`drivers.phone` 欄位已存在,只是沒填寫入口),
串 `GET/PUT /api/driver/vehicle`。
- [x] **車輛資訊設定頁**:車種**下拉選單**+車牌輸入 ✅ 2026-07-17(見上方 O2/O3 段);
**聯絡電話 ✅ 2026-07-21**(見下方「司機聯絡電話」段)。
- [ ] **強制跳轉引導** ✅ 定案(2026-07-16):未填車輛資訊時**強制導向設定頁**,
填完才能回到首頁/上線。不是「提示」而是 gate——
使用者明確要求「強迫司機必須填寫才能開始接單(用跳轉方式引導)」。
實作點:`driver/app.dart` 的 `_DriverRoot`(目前只有 `isLoggedIn ? Home : Login`),
加第三種狀態 `已登入但無車輛資訊 → VehicleSetupScreen`。
註:**後端也會擋**(O3),App 端跳轉只是提早給回饋、不能只靠 App。
- [ ] **`DriverController` 狀態**:加 `vehicle`/`hasVehicle`;`init()`/`login()` 後載入。
注意 `hasVehicle` 未載入完成前不要誤判成「沒填」而閃跳轉(載入中要有明確狀態)。
- [x] **`DriverController` 狀態** ✅ 2026-07-17:`vehicle`/`hasVehicle`/`vehicleChecked`/
`vehicleLoadFailed`(見上方 O2/O3 段的三態說明)。

## 📞 司機聯絡電話(2026-07-21,三層都補)

> **抓到的缺口**:乘客端「撥打司機電話」按鈕(O7)早就上線,資料讀 `drivers.phone`;
> 但那個欄位**沒有任何寫入路徑**——註冊不收、沒有更新端點、司機端沒有欄位,
> 只有後端測試碼直接寫 DB。正式流程下號碼恆為空字串,`hasPhone` 永遠 false,
> **撥號按鈕從來沒有真正出現過**。規劃早在「司機端/車輛資訊設定頁」寫過
> 「`drivers.phone` 欄位已存在,只是沒填寫入口」,但一直沒人接。

- [x] **後端**(dispatch `claude/driver-phone-profile`,commit `eb46ce1`,**尚未開 PR**):
新開 **`PUT /api/driver/profile`**(driver JWT,只改 phone)+
`constants.NormalizePhone`/`IsValidPhone`(8–15 碼、允許開頭 `+`)。
**刻意不併進 `PUT /driver/vehicle`**——那支的 `UpdateVehicle` 會把
`vehicle_review_status` 原子地重置為 pending(O5),司機每改一次電話
就會被審核 gate 踢出接單池。空字串=清除號碼(司機可收回不公開)。
驗證格式比照車牌的取捨:不綁「09 開頭」,否則市話與國際號碼會被誤擋。
- [x] **App 端**:`DriverProfile` 模型、`fetchProfile`/`updatePhone`、
controller 的 `phone`/`hasPhone`/`savePhone`(載入失敗**靜默降級**,
電話是選填,不能讓它擋住車輛設定流程或掛一條無關的紅字);
車輛資訊頁加**獨立的電話區塊+獨立送出鈕**——兩者走不同端點,UI 若共用一顆
「儲存」,司機改電話就會連帶重送審。頁面明講「修改電話不會影響車輛審核狀態」。

**驗收**:
- 靜態:`flutter analyze` 無 issue、`flutter test` **182 passed**(原 173,新增 9);
後端 `go build ./...` OK、`TestDriverSetPhone` 4 子測試+`TestNormalizePhone`/
`TestIsValidPhone` 全綠。
- **反向確認**(兩次,都真的跑過):讓 `UpdatePhone` 也重置審核 → 「改電話不影響車輛
審核狀態」FAIL;移除電話長度檢查 → 「太短的號碼在本地就擋下」FAIL;兩者皆已還原。
- **後端 live 全鏈路**(新分支 docker):存 `0912-345-678` → 回 `0912345678`(正規化生效);
存完再查車輛 → **`review_status:"approved"`、`can_accept:true`(審核沒被重置,這是關鍵斷言)**;
存 `12345` → 400「電話格式錯誤」;存 `""` → 清除成功。
再走完整叫車鏈路(司機上線→乘客建單→接單),乘客端 `GET /customer/rides/active`
**首次真的帶出 `"driver_phone":"0912345678"`**——改動前此欄恆為空字串。
- **UI 互動實跑 ✅(2026-07-21,iPhone 17 Pro 模擬器+後端 docker)**:
新增 `integration_test/driver_phone_test.dart`——在**真模擬器上跑真 App、打真後端**,
輸入 `0988-123-456` → 點「儲存聯絡電話」→ 斷言 SnackBar「聯絡電話已儲存」出現 →
**重新向後端查**(不信 controller 的記憶體狀態)得到正規化後的 `0988123456` →
車輛仍 `approved`/`can_accept:true`。`All tests passed`。
外部 curl 交叉驗證:`GET /driver/me` 回 `"phone":"0988123456"`(操作前是空字串)。
- **踩到的坑(已記進 [[ios-simulator-automation]])**:`cliclick` 的點擊在此環境**靜默失效**
——`cliclick m:` 移動游標正常、`osascript` 的 keystroke 也有效,但合成滑鼠點擊完全到不了
模擬器(該執行檔缺輔助使用授權),Tab/方向鍵焦點導航又只能停在第一個 AppBar icon。
**出路是 `integration_test`**:點擊由 Flutter 自己派送,不經過系統事件,
同時還能斷言後端狀態。以後 iOS 的 UI 驗收優先走這條,別再跟座標纏鬥。

### 乘客端

- [ ] **顯示司機車種車牌**:`ride.accepted` 後的「司機前往上車點」階段,
sheet 目前只顯示「司機:{name}」+ETA,要加車種與車牌(醒目、方便路邊對車)。
`CustomerController` 的 `driverName` 旁加 `driverVehicleType`/`driverPlateNumber`。
- [ ] **司機聯絡方式** ✅ 已拍板(2026-07-16):**明碼**顯示可撥打的電話(`tel:` 連結)+留言板入口。
僅該趟乘客可見(後端 MultiAuth 控管,App 只在行程/協尋畫面顯示,不做任何司機列表)。
- [x] **司機聯絡方式** ✅ 2026-07-17 乘客端 UI 完成(`DriverVehicleCard` 的 `tel:` 撥號鈕);
**但號碼直到 2026-07-21 補上司機端填寫入口才真的會出現**(見上方「司機聯絡電話」段)。
- [ ] **清潔費分項顯示** ✅ 定案:完成卡不可只給總額,要拆「車資 NT$X + 清潔費 NT$Y」。
**只有乘客指定寵物車的行程才有清潔費**(依 `required_vehicle_type`,非司機車種);
未指定時完成卡不該出現清潔費欄位。
Expand Down
72 changes: 72 additions & 0 deletions integration_test/driver_phone_test.dart
Original file line number Diff line number Diff line change
@@ -0,0 +1,72 @@
// 司機聯絡電話的端到端驗收:在真模擬器上跑真 App、打真後端。
//
// 為什麼需要這個檔:widget test 用的是 Fake API,證明不了「App 真的把電話寫進後端、
// 而且沒有把車輛審核狀態弄壞」;而系統層的合成點擊事件在本機 CI/agent 環境送不進
// 模擬器(見 docs/TODO.md 的說明),所以互動必須由 Flutter 自己派送。
//
// 前置:後端要跑在 --dart-define 指定的 API_BASE,且該司機帳號存在、車輛已核准。
// 跑法:
// flutter test integration_test/driver_phone_test.dart \
// -d <simulator-id> --flavor driver \
// --dart-define=API_BASE=http://127.0.0.1:8080
import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:integration_test/integration_test.dart';
import 'package:line_fleet_app/core/api/fleet_api_client.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/core/theme/app_theme.dart';
import 'package:line_fleet_app/driver/driver_controller.dart';
import 'package:line_fleet_app/driver/screens/driver_vehicle_screen.dart';
import 'package:provider/provider.dart';

void main() {
IntegrationTestWidgetsFlutterBinding.ensureInitialized();

testWidgets('司機填聯絡電話 → 真的寫進後端,且車輛審核狀態不受影響', (tester) async {
final api = FleetApiClient();
final ctrl = DriverController(
storage: MemoryDriverAuthStore(),
api: api,
// 這個案子與派單無關,靜默 WS 免得測試被連線時序干擾。
wsFactory: FleetWsClient.silent,
);
addTearDown(ctrl.dispose);

await ctrl.init();
await ctrl.login(lineUserId: 'sim-driver-001', password: 'password123');
expect(ctrl.isLoggedIn, isTrue, reason: '前置:登入應成功(後端有跑嗎?)');
expect(ctrl.canAcceptRides, isTrue, reason: '前置:這位司機的車輛應已核准');

await tester.pumpWidget(
ChangeNotifierProvider<DriverController>.value(
value: ctrl,
child: MaterialApp(
theme: appLightTheme,
home: const DriverVehicleScreen(),
),
),
);
await tester.pumpAndSettle();

// 帶分隔符號輸入,順便驗後端正規化後有回填到欄位。
await tester.enterText(
find.widgetWithText(TextFormField, '電話(選填)'),
'0988-123-456',
);
await tester.tap(find.text('儲存聯絡電話'));
await tester.pumpAndSettle(const Duration(seconds: 3));

expect(find.text('聯絡電話已儲存'), findsOneWidget, reason: 'SnackBar 應出現');
expect(ctrl.error, isNull, reason: '不應有錯誤');

// 以「重新向後端查一次」為準,而不是相信 controller 的記憶體狀態。
final fresh = await api.fetchProfile();
expect(fresh.phone, '0988123456', reason: '後端應存下正規化後的號碼');

// 這是本功能存在的理由:改電話不可以把司機踢回審核中。
final vehicle = await api.fetchVehicle();
expect(vehicle.canAccept, isTrue, reason: '存電話後仍必須能接單');
expect(vehicle.reviewStatus.name, 'approved');
});
}
29 changes: 29 additions & 0 deletions lib/core/api/fleet_api_client.dart
Original file line number Diff line number Diff line change
Expand Up @@ -149,6 +149,35 @@ class FleetApiClient {
}
}

/// 查自己的個資(對齊 GET /api/driver/me)。目前只用 `phone`。
Future<DriverProfile> fetchProfile() async {
try {
final res = await _dio.get<Map<String, dynamic>>('/driver/me');
return DriverProfile.fromJson(res.data ?? const {});
} on DioException catch (e) {
throw _wrap(e);
}
}

/// 設定聯絡電話(對齊 PUT /api/driver/profile)。
///
/// **刻意不走 `/driver/vehicle`**:那支會把車輛審核重置為 pending(O5),
/// 司機改一次電話就會被踢回「審核中」而無法接單。
///
/// 後端會正規化號碼(去空白與 `-`、`(`、`)`)並回傳正規化後的值——**以回傳值為準**。
/// 傳空字串=清除號碼(乘客端撥號按鈕隨之消失)。
Future<DriverProfile> updatePhone(String phone) async {
try {
final res = await _dio.put<Map<String, dynamic>>(
'/driver/profile',
data: {'phone': phone},
);
return DriverProfile.fromJson(res.data ?? const {});
} on DioException catch (e) {
throw _wrap(e);
}
}

/// 查自己的車輛資訊(對齊 GET /api/driver/vehicle,O2)。
/// 未設定時兩欄為空字串、hasVehicle=false,非錯誤。
Future<DriverVehicle> fetchVehicle() async {
Expand Down
30 changes: 30 additions & 0 deletions lib/core/models/vehicle.dart
Original file line number Diff line number Diff line change
Expand Up @@ -96,3 +96,33 @@ class DriverVehicle {

static const empty = DriverVehicle(vehicleType: '', plateNumber: '', hasVehicle: false);
}

/// 司機個資(對齊後端 `driverPublic`:`GET /api/driver/me`、`PUT /api/driver/profile`)。
///
/// 目前 App 只用到 `phone`——乘客端在「司機前往上車點」階段用它撥號(O7),
/// 而司機端在此之前**沒有任何填寫入口**,號碼永遠是空的、撥號按鈕永遠不顯示。
class DriverProfile {
const DriverProfile({
required this.driverId,
required this.name,
required this.phone,
});

final int driverId;
final String name;

/// 聯絡電話;'' =未填(乘客端整塊撥號按鈕不顯示)。後端已正規化(去空白與分隔符號)。
final String phone;

bool get hasPhone => phone.isNotEmpty;

factory DriverProfile.fromJson(Map<String, dynamic> json) {
return DriverProfile(
driverId: (json['driver_id'] as num?)?.toInt() ?? 0,
name: json['name'] as String? ?? '',
phone: json['phone'] as String? ?? '',
);
}

static const empty = DriverProfile(driverId: 0, name: '', phone: '');
}
Loading
Loading