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
29 changes: 29 additions & 0 deletions docs/TODO.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 加入,尚未實作,皆需後端地基先行)**:
Expand Down
2 changes: 1 addition & 1 deletion internal/handler/ride.go
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
7 changes: 6 additions & 1 deletion internal/service/rating.go
Original file line number Diff line number Diff line change
Expand Up @@ -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 的最後防線)。
Expand Down Expand Up @@ -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
Expand Down
9 changes: 8 additions & 1 deletion internal/service/rating_test.go
Original file line number Diff line number Diff line change
Expand Up @@ -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, " 司機很準時 ")
Expand Down
Loading