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
5 changes: 3 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -190,7 +190,9 @@ FCM data 的值一律是字串,App 端 `fleetEventFromPushData()` 會把座標
**服務評價(平均分/則數)**。後端新開 `POST /api/customer/rides/:id/rating`,
讀回走 `CustomerRideView.rating`/歷史列 `rating_score`/`GET /driver/me` 的 `rating_avg`。
**付款仍屬 Phase C**(需真金流),完成卡在無車資時保留費用佔位。
詳見 [`docs/TODO.md`](docs/TODO.md)「⭐ 乘客評分司機」。
**已模擬器實跑 E2E**(雙 flavor):完成卡評分 → DB 交叉驗證 → 歷史補評 → 司機端
「服務評價 4.5 / 5.0(2 則)」三處一致;實跑抓到並修掉一個後端文案 bug
(評分被拒時講的是遺失物協尋)。詳見 [`docs/TODO.md`](docs/TODO.md)「⭐ 乘客評分司機」。

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

Expand All @@ -199,7 +201,6 @@ FCM data 的值一律是字串,App 端 `fleetEventFromPushData()` 會把座標
> 完整規格與待拍板事項見 [`docs/TODO.md`](docs/TODO.md) 與後端
> [line-fleet-dispatch/docs/TODO.md](../line-fleet-dispatch/docs/TODO.md)。

- **B5 評分的模擬器實跑 E2E**(2026-07-27 留下的唯一缺口;功能已上線但只驗到靜態測試)。
- 完成後付款(B5 的另一半,需真金流)。
- 依賴外部資源/實機的項目(A2 真裝置推播、A5 iOS 實機部署與 iOS 推播)——見 TODO。

Expand Down
45 changes: 33 additions & 12 deletions docs/TODO.md
Original file line number Diff line number Diff line change
Expand Up @@ -399,9 +399,30 @@ app `flutter test` 197 passed。
既有 `widget_test.dart` 的 B5 佔位斷言同步改成「評分入口可按、佔位文案消失」。
- 後端:`go build`/`go vet`/`gofmt` 乾淨;service 3 案(真 PostGIS 跑全部 migration,
順帶驗證 000023 可套用)+ handler 2 案(HTTP 邊界,不需 DB)。
- **未做:模擬器實跑 E2E**——本批只有靜態與整合測試綠。歷次經驗(2026-07-18 抓到 3 個 bug、
2026-07-22 抓到 O7 撥號從未生效)顯示實跑才會踩到跨畫面/時序問題,
**下次任務應優先補這條**(詳見「下次任務」)。
- **✅ 模擬器實跑 E2E(2026-07-27,`m6_pixel` 雙 flavor + dispatch docker compose,全程截圖)**:
- **完成卡**:ride #26 完成 → 車資 NT$ 85 →「留下評分」是**可按的實心按鈕**
(不再是 disabled 佔位,`即將開放` 文案已不存在)→ 開 sheet:5 顆空星、
「想說的話(選填)」0/200、**未選星等時「送出評分」是 disabled**。
- 選 4 星+評論 `GreatDriver-B5` → 送出 → **DB 交叉驗證** `ride_ratings` 寫入
`(ride 26, customer 8, driver 24, score 4, comment)` → 完成卡當場翻成
**★★★★☆「已評分」**、評分按鈕消失。
- **補評路徑**(本功能最關鍵的一條):第二趟 ride #27 完成後按「再叫一輛」關掉完成卡 →
進「我的行程」→ #27 顯示綠色「評分」鈕 → 給 5 星、**不留言** → 送出 →
**清單那一列就地翻成 ★★★★★「已評分」**(沒有重打 API);DB 的 comment 為空字串。
- **`canRate` 三條件在真實資料上一次驗完**:#26/#27(已完成+有司機)給入口;
#25(已取消、無司機)**兩個入口都沒有**;#12(已取消但有司機)只有「聯絡司機」、
**沒有評分鈕**。
- **司機端**:`b5drv01` 登入(已核准 → 直接進首頁,O5 四態正確)→「我的收入」顯示
**「服務評價 4.5 / 5.0(2 則)」**——與 `GET /driver/me` 的 `rating_avg=4.5`/
`rating_count=2` 及 DB 的 (4+5)/2 **三處完全一致**。
- **守門實打**(直打 API,App 已不給入口):重複評分 **409** 且原分數未被覆寫、
星等 6 → **400**、他人訂單 → **403**、已取消行程 → **409**。
- 🐛 **實跑抓到一個真 bug(已修,dispatch PR #46)**:未完成行程的 409 文案是
**「僅已完成的行程可申請遺失物協尋」**——後端 `RateByCustomer` 重用了遺失物的
`ErrRideNotCompleted`,而這段訊息會**原樣顯示在乘客的評分對話框上**。
單元測試斷言的是 `errors.Is(...)` 而非文案內容,所以測不到。
已改用專屬的 `ErrRideNotRatable`,並補上「訊息不得提到遺失物」的斷言。
- 收尾:模擬器、docker compose、位置心跳全數關閉。

---

Expand Down Expand Up @@ -459,16 +480,16 @@ app `flutter test` 197 passed。

## 下次任務

> **➡️ 下次先做這個:B5 評分的模擬器實跑 E2E**(2026-07-27 留下的唯一缺口)。
> 本批評分功能只驗到靜態測試與後端整合測試,**沒有實跑**。
> 要驗的鏈路:乘客叫車 → 司機接單 → 完成 → **完成卡按「留下評分」→ 選星等+留言 → 送出**
> → 後端 `ride_ratings` 有列(DB 交叉驗證)→ 進「我的行程」看到星等
> → **重複評分撞 409**(App 不該再給入口,直打 API 才會遇到)
> → 司機端「我的收入」顯示平均分與則數。
> 起服務前記得 `docs/TODO.md` 的 migration 是 000023——**要先讓 dispatch 跑過 migration**。
> 歷次實跑(2026-07-18 抓 3 個 bug、2026-07-22 抓到 O7 撥號從未生效)證明這步不能省。
> **✅ B5 評分的模擬器實跑 E2E 已完成(2026-07-27)**,詳見上方「⭐ 乘客評分司機」。
> 實跑抓到一個後端文案 bug(評分被拒時講遺失物協尋),已修(dispatch PR #46)——
> 又一次印證「單元測試綠 ≠ 使用者看到的東西是對的」。
>
> 之後才是下列被外部資源卡住的項目。
> **➡️ 下次任務:剩下的都被外部資源卡住**,開工前先確認前置條件到位:
> 1. **A2 真裝置推播**——需要你先建 Firebase 專案並提供 `google-services.json`(後端 FCM 已上線)。
> 2. **A5 階段 5 iOS 實機部署**——需要你接上 iPhone、Xcode 選 Personal Team、手機信任憑證。
> (階段 6 iOS 推播仍卡付費 Apple Developer Program。)
> 3. **B5 的另一半:完成後付款**——需要真金流方案(後端 P4 #19),屬產品決策。
> 4. **車種供給為零時的選項處理**——等產品拍板要停用、隱藏、還是照選但提示。

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