diff --git a/README.md b/README.md index 5391be7..8ef9cf5 100644 --- a/README.md +++ b/README.md @@ -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**。 @@ -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。 diff --git a/docs/TODO.md b/docs/TODO.md index bd29c7f..c02f39a 100644 --- a/docs/TODO.md +++ b/docs/TODO.md @@ -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、位置心跳全數關閉。 --- @@ -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 共用。