diff --git a/docs/TODO.md b/docs/TODO.md index e3e23e4..2efb28d 100644 --- a/docs/TODO.md +++ b/docs/TODO.md @@ -935,6 +935,35 @@ - App 端對應(fleet-app 同批):完成卡「留下評分」開 1–5 星+評論的 bottom sheet; 歷史清單未評給「評分」、已評顯示星等;司機收入頁顯示「服務評價 4.5 / 5.0(12 則)」。 +**✅ 模擬器實跑 E2E(2026-07-27,`m6_pixel` + docker compose 三服務,全程截圖)**: +- **migration 000023 真的套用**:容器啟動後 `\d ride_ratings` 顯示表、唯一索引 + `uq_ride_ratings_ride_id`、兩條 CHECK、FK 全部到位。 +- **全鏈路**:App 叫車 → 司機 API 接單→上車→完成(ride #26,車資 8500 分)→ + **完成卡「留下評分」是可按的實心按鈕**(不再是 disabled 佔位)→ 4 星+評論送出 → + **DB 交叉驗證** `ride_ratings` 寫入 `(26, customer 8, driver 24, score 4, "GreatDriver-B5")` + → 完成卡當場翻成 ★★★★☆「已評分」、評分按鈕消失。 +- **四道守門實打**(直打 API,App 已不給入口):重複評分 **409**「此行程已評分過」且 + **原分數未被覆寫**;星等 6 → **400**;已取消的行程 → **409**;他人的訂單 → **403**。 +- 🐛 **實跑抓到並修掉**:未完成行程的 409 文案是**遺失物的**(見下方 fix 段)。 + 單元測試斷言 `errors.Is` 而非文案,所以測不到——這是 live E2E 的直接產出。 +- **平均分**:兩趟分別評 4 星與 5 星 → `GET /driver/me` 回 `rating_avg=4.5, rating_count=2`, + 司機 App 收入頁顯示「服務評價 4.5 / 5.0(2 則)」,**三處(DB/API/UI)完全一致**。 +- 順帶驗到 P4 取消文案兩態:乘客主動取消 →「行程已取消。」;派單逾時無人接 → + 「抱歉,附近暫無可用司機,請稍後再試。」 + +### 🐛 修正:評分被拒的錯誤訊息講的是遺失物協尋(2026-07-27) + +`RateByCustomer` 重用了 `lost_item.go` 的 `ErrRideNotCompleted`,其文案是 +「僅已完成的行程可申請遺失物協尋」——而它會**原樣顯示在乘客的評分對話框上**。 +兩個功能的**條件**恰好相同(只有已完成且有司機的行程才適用),所以重用 sentinel +看起來很合理,但**面向使用者的文案不是共用的**。 + +修法:新增 `ErrRideNotRatable`(「僅已完成的行程可以評分」),handler 的 409 對應同步改, +遺失物那條路徑一行不動。測試補「錯誤訊息不得提到遺失物」的斷言, +**反向確認**改回舊 sentinel 會讓 `TestRatingFlow` FAIL。 +部署到本機 docker compose 後**實打複驗**:評分回「僅已完成的行程可以評分」、 +遺失物端點仍回原本的文案。 + ## 下次任務 **新需求(2026-07-16 加入,尚未實作,皆需後端地基先行)**: diff --git a/internal/handler/ride.go b/internal/handler/ride.go index 3240b68..a731a22 100644 --- a/internal/handler/ride.go +++ b/internal/handler/ride.go @@ -86,7 +86,7 @@ func ratingStatusForErr(err error) int { return http.StatusForbidden case errors.Is(err, service.ErrNotFound): return http.StatusNotFound - case errors.Is(err, service.ErrRatingExists), errors.Is(err, service.ErrRideNotCompleted): + case errors.Is(err, service.ErrRatingExists), errors.Is(err, service.ErrRideNotRatable): return http.StatusConflict default: return http.StatusInternalServerError diff --git a/internal/service/rating.go b/internal/service/rating.go index f5a2cf8..f3ba37e 100644 --- a/internal/service/rating.go +++ b/internal/service/rating.go @@ -17,6 +17,11 @@ var ( ErrRatingExists = errors.New("此行程已評分過") // ErrCommentTooLong 評論字數超過上限。 ErrCommentTooLong = errors.New("評論長度超過上限") + // ErrRideNotRatable 行程尚未完成、或根本沒派到司機(派單前取消)。 + // **不可重用遺失物的 ErrRideNotCompleted**——它的文案是「僅已完成的行程可申請 + // 遺失物協尋」,會原樣顯示在乘客的評分對話框上,講的卻是另一個功能 + // (2026-07-27 模擬器實跑抓到;單元測試斷言 errors.Is 而非文案,所以測不到)。 + ErrRideNotRatable = errors.New("僅已完成的行程可以評分") ) // ratingCommentMaxRunes 評論字數上限(DB 另有 char_length ≤ 500 的最後防線)。 @@ -54,7 +59,7 @@ func (s *RatingService) RateByCustomer(customerID, rideID int64, score int, comm } // 沒司機的行程(派單前取消)沒有評分對象;未完成的行程還沒有可評的服務。 if ride.Status != constants.RideStatusCompleted || ride.DriverID == nil { - return nil, ErrRideNotCompleted + return nil, ErrRideNotRatable } if existing, err := s.ratings.FindByRide(rideID); err != nil { return nil, err diff --git a/internal/service/rating_test.go b/internal/service/rating_test.go index 485745b..d7037e2 100644 --- a/internal/service/rating_test.go +++ b/internal/service/rating_test.go @@ -75,9 +75,16 @@ func TestRatingFlow(t *testing.T) { // 未完成的行程沒有可評的服務 activeRide := newTestRide(t, rides, owner.ID, constants.RideStatusPickedUp) - if _, err := svc.RateByCustomer(owner.ID, activeRide.ID, 5, ""); !errors.Is(err, ErrRideNotCompleted) { + err = func() error { _, e := svc.RateByCustomer(owner.ID, activeRide.ID, 5, ""); return e }() + if !errors.Is(err, ErrRideNotRatable) { t.Fatalf("未完成行程評分應被拒,got %v", err) } + // **文案也要驗**:錯誤訊息會原樣顯示在乘客的評分對話框上。 + // 只斷言 errors.Is 的話,重用了遺失物的 ErrRideNotCompleted(文案是 + // 「僅已完成的行程可申請遺失物協尋」)照樣會綠——2026-07-27 實跑才抓到。 + if strings.Contains(err.Error(), "遺失物") { + t.Fatalf("評分的錯誤訊息不該提到遺失物協尋:%q", err.Error()) + } // 主流程:評論前後空白會被 trim rating, err := svc.RateByCustomer(owner.ID, rideID, 4, " 司機很準時 ")