From 3b25f9808b8d8aff0047bd133557d5e78f567c9f Mon Sep 17 00:00:00 2001 From: awei Date: Mon, 27 Jul 2026 20:11:13 +0800 Subject: [PATCH 1/2] =?UTF-8?q?fix(S):=20=E8=A9=95=E5=88=86=E8=A2=AB?= =?UTF-8?q?=E6=8B=92=E7=9A=84=E9=8C=AF=E8=AA=A4=E8=A8=8A=E6=81=AF=E8=AC=9B?= =?UTF-8?q?=E7=9A=84=E6=98=AF=E9=81=BA=E5=A4=B1=E7=89=A9=E5=8D=94=E5=B0=8B?= =?UTF-8?q?=EF=BC=88=E6=A8=A1=E6=93=AC=E5=99=A8=E5=AF=A6=E8=B7=91=E6=8A=93?= =?UTF-8?q?=E5=88=B0=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 乘客對未完成/沒派到司機的行程評分,後端回的是「僅已完成的行程可申請遺失物 協尋」——狀態碼 409 正確,但文案來自遺失物功能,而它會**原樣顯示在乘客的評分 對話框上**。原因是 RateByCustomer 重用了 lost_item.go 的 ErrRideNotCompleted。 單元測試測不到:它斷言的是 errors.Is(err, ErrRideNotCompleted),訊息內容從來 沒被檢查。2026-07-27 B5 模擬器實跑打 API 時才顯現。 - 新增 ErrRideNotRatable(「僅已完成的行程可以評分」),RateByCustomer 改用它; handler 的 409 對應同步改。遺失物那條路徑不動。 - 測試補「錯誤訊息不得提到遺失物」的斷言——反向確認改回 ErrRideNotCompleted 會讓 TestRatingFlow FAIL。 Co-Authored-By: Claude Opus 4.8 --- internal/handler/ride.go | 2 +- internal/service/rating.go | 7 ++++++- internal/service/rating_test.go | 9 ++++++++- 3 files changed, 15 insertions(+), 3 deletions(-) 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, " 司機很準時 ") From ab7b4204e8fc351ae91021b01e3111b6c849a1f7 Mon Sep 17 00:00:00 2001 From: awei Date: Mon, 27 Jul 2026 20:18:36 +0800 Subject: [PATCH 2/2] =?UTF-8?q?docs(S):=20=E5=9B=9E=E5=A1=AB=20B5=20?= =?UTF-8?q?=E8=A9=95=E5=88=86=E6=A8=A1=E6=93=AC=E5=99=A8=E5=AF=A6=E8=B7=91?= =?UTF-8?q?=20E2E=20=E8=88=87=E6=96=87=E6=A1=88=E4=BF=AE=E6=AD=A3=E7=B4=80?= =?UTF-8?q?=E9=8C=84?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 全鏈路(叫車→接單→完成→完成卡評分→DB 交叉驗證→歷史補評→司機平均分) 與四道守門的實打狀態碼;並記錄實跑抓到的遺失物文案外洩問題與其修法。 Co-Authored-By: Claude Opus 4.8 --- docs/TODO.md | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) 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 加入,尚未實作,皆需後端地基先行)**: