From 872e20934a08dcbcd4c24a0724630263727ef592 Mon Sep 17 00:00:00 2001 From: awei Date: Fri, 17 Jul 2026 14:13:55 +0800 Subject: [PATCH] =?UTF-8?q?feat(N5):=20=E8=A8=88=E8=B2=BB=E6=94=B9?= =?UTF-8?q?=E5=90=83=E5=85=A8=E7=A8=8B=E5=AF=A6=E9=9A=9B=E8=B7=AF=E7=B7=9A?= =?UTF-8?q?=EF=BC=88OSRM=20=E5=A4=9A=20waypoint=EF=BC=8C=E6=8E=92=E9=99=A4?= =?UTF-8?q?=E5=B7=B2=E8=B7=B3=E9=81=8E=E7=9A=84=E7=AB=99=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit N 章節最後一批。至此 N/O/P 三章只剩 O5(可選、待拍板)。 osrm.Client.RouteVia(ctx, []Point):URL 依序串接所有座標(`;` 分隔、lng,lat)。 OSRM 的 /route/v1 本來就支援多座標,是我們的 client 只開放兩點。既有兩點 RouteDuration 完全不動——派單 ETA 與 F3 既有行為不受影響。Point 型別自訂而非用 model.GeoPoint:osrm 是最底層的外部服務 client,不該依賴領域模型。 fallbackVia 逐段累加:OSRM 掛掉時逐段 haversine×1.4 再取和。只算頭尾會把繞路全部 漏掉,退路里程退化成直達距離;billableDistanceM 取大者時就只剩軌跡可用,軌跡稀疏 (F3)便嚴重低估車資。 TrackingService.routeDistanceM:有未跳過的停靠點(≥2)走全程多點路線,否則退回 現行兩點直達(相容單點訂單)。billableDistanceM 取大者的邏輯完全不變。 已跳過的停靠點不計入(2026-07-17 拍板「司機可跳過」的衍生結論):沒去就沒開那段路, 計入等於收乘客沒走的路的錢。跳過後不足兩點時退回兩點直達,不會失敗。 不必把 ride.PickupPoint 另外補進路線:N3 已保證 pickup_point=第一個 pickup stop、 dropoff_point=seq 最大的 dropoff stop,補了會重複計算。 驗收:build/vet/gofmt 綠;service 1478s、repository 637s、handler 49s、constants、 osrm 全套通過。整合測試用 fake OSRM 伺服器斷言「實際送出的座標」,而非只看回傳數字。 反向驗證:拿掉 Skipped() 過濾 → 已跳過的座標出現在計費路線 FAIL;fallbackVia 只算 頭尾 → 繞路(7040)=直達(7040) FAIL。 Co-Authored-By: Claude Opus 4.8 --- cmd/server/main.go | 1 + docs/TODO.md | 53 ++++- internal/osrm/client.go | 67 ++++++ internal/osrm/route_via_test.go | 107 +++++++++ internal/service/tracking.go | 75 +++++- internal/service/tracking_route_stops_test.go | 224 ++++++++++++++++++ 6 files changed, 508 insertions(+), 19 deletions(-) create mode 100644 internal/osrm/route_via_test.go create mode 100644 internal/service/tracking_route_stops_test.go diff --git a/cmd/server/main.go b/cmd/server/main.go index ea438e5..5bc950e 100644 --- a/cmd/server/main.go +++ b/cmd/server/main.go @@ -140,6 +140,7 @@ func main() { trackingService.SetFeeSettings(feeSettings) trackingService.SetOSRM(osrm) // F3:軌跡里程偏低時以 OSRM 路線里程作計費地板 trackingService.SetReports(reportRepo) // F9-3:完成時重算每日彙總 daily_driver_earnings + trackingService.SetStops(rideStopRepo) // N5:多停靠點行程改用全程多點路線計費 driverRegistry := service.NewDriverRegistry(driverRepo) rideQueryService := service.NewRideQueryService(trackRepo, rideRepo) rideQueryService.SetDrivers(driverRepo) // O4/O7:乘客查自己訂單時附司機姓名/電話 diff --git a/docs/TODO.md b/docs/TODO.md index 00cd7b8..2481105 100644 --- a/docs/TODO.md +++ b/docs/TODO.md @@ -316,9 +316,34 @@ (真 FCM 是 A2 待辦)。故 stops 目前**只走 WS**。此提醒已移到 `rideAssignedPayload` 的註解,留給日後做真 FCM 的人(見 pitfall-fcm-data-all-strings)。 -- [ ] **N5. 計費改吃「全程實際路線」** ✅ **已定案(2026-07-16 使用者拍板)** +- [x] **N5. 計費改吃「全程實際路線」** ✅ **已實作(2026-07-17)**(定案 2026-07-16) (`internal/osrm/client.go` + `tracking.go` `Complete`) + **實作內容**: + 1. **`osrm.Client.RouteVia(ctx, []Point)`**:URL 依序串接所有座標(`;` 分隔,`lng,lat` 順序)。 + **既有兩點 `RouteDuration` 完全不動**——派單 ETA 與 F3 既有行為不受影響。 + `Point` 型別自訂而非用 `model.GeoPoint`:osrm 是最底層的外部服務 client,不該依賴領域模型。 + 2. **`fallbackVia` 逐段累加**:OSRM 掛掉時逐段 haversine×1.4 再取和。 + 3. **`TrackingService.routeDistanceM`**:有未跳過的停靠點(≥2)就走全程多點路線, + 否則退回現行兩點直達(相容單點訂單)。**`billableDistanceM` 取大者的邏輯完全不變**。 + + **已跳過的停靠點不計入**(2026-07-17 拍板「司機可跳過」的衍生結論): + 沒去就沒開那段路,計入等於收乘客沒走的路的錢。軌跡那側本來就自然反映(沒去就沒軌跡)。 + 跳過後不足兩點時退回兩點直達,不會失敗。 + + **不必把 `ride.PickupPoint` 另外補進路線**:N3 已保證 `rides.pickup_point` = 第一個 pickup stop、 + `dropoff_point` = seq 最大的 dropoff stop,兩者本來就在 stops 裡(補了會重複計算)。 + + **驗收**:`go build`/`vet`/`gofmt` 綠。 + 單元(`internal/osrm`,無需容器):URL 依序串接所有座標且為 `lng,lat`、點數不足回 `ErrTooFewPoints`、 + **OSRM 掛掉時逐段累加**(繞路里程 > 直達,且等於手動逐段和)、nil client 走退路。 + 整合(真 PostGIS + fake OSRM 伺服器,斷言實際送出的座標):多停靠點走全程路線、 + **跳過的站不計入**、單點訂單維持兩點直達、全部跳過時退回兩點。 + **反向驗證**:拿掉 `st.Skipped()` 過濾 → 已跳過的座標出現在計費路線,FAIL; + `fallbackVia` 改成只算頭尾 → 繞路(7040) = 直達(7040),繞路被漏掉,FAIL。 + **未驗**:docker compose 全服務 live E2E(含真 OSRM)。 + + 原始定案內容如下(保留供對照): **定案**:車資=**全程實際路線**(起點 → 各停靠點 → 最終目的地,**含繞路**), 不是「起點→最終目的地」的直達路線。理由:司機真的開了那些路,繞路不該做白工; 也與現行「軌跡 vs 路線取大者」的精神一致。 @@ -798,15 +823,23 @@ 清潔費依乘客指定車種、上限 30%、**不計入抽成**/不降級+取消原因明確化/customer fees 端點/ **電話明碼、僅該趟乘客可見**)——**N、O、P 規格完備,可開始實作**, 建議順序:O1→O2→O3(車輛地基)→ P1→P2→P3+P4(車種)→ O6+P5(清潔費)→ O4/O7(乘客可見)→ N(多停靠點,最大塊)。 - **進度:O1/O2/O3/O4/O6/O7 ✅、P1–P5 ✅(O1 為 2026-07-16,其餘皆 2026-07-17) - → **N、O、P 三章中的 O 與 P 已全數完成**,只剩 **O5(admin 呈現/審核,可選、待拍板)**。 - 後端能力已到位:司機填車輛才能接單 → 乘客指定車種 → 只派同車種、找不到明確取消 → - 依乘客指定車種加收清潔費、報表分項 → 乘客看得到車種車牌與司機電話、對話無時間限制。 - - **下一項建議**:**N(多乘客/多停靠點)**——三章中僅存的大塊,需擴充 OSRM client - 支援多 waypoint(現行介面寫死兩點)並讓 haversine 退路逐段累加。 - 或先補 **下游 UI 同步**(admin 費率頁/月報表分項、App 完成卡分項+車輛資訊+強制填寫跳轉), - 否則後端做完的能力在兩端都還看不到。** + **進度:N1–N7 ✅、O1/O2/O3/O4/O6/O7 ✅、P1–P5 ✅ + (O1 為 2026-07-16,其餘皆 2026-07-17) + → **N、O、P 三章全數完成**,只剩 **O5(admin 呈現/審核,可選、待拍板)**。 + + 後端能力已到位:司機填車輛才能接單 → 乘客指定車種(可帶多乘客/多停靠點)→ + 只派同車種、找不到明確取消 → 司機看得到全程、可標記到站/跳過 → + 完成時依**全程實際路線**(排除已跳過)計費、依**乘客指定車種**加收清潔費、報表分項 → + 乘客看得到車種車牌與司機電話、對話無時間限制。 + + **下一項建議:補下游 UI**——後端已跑在兩端前面很遠,做完的能力在 admin 與 App 都還看不到: + - **admin**:費率頁 `pet_cleaning_fee_bps`、月報表清潔費分項欄、(O5 若要做)車輛審核。 + - **App**(見 [line-fleet-app/docs/TODO.md](../../line-fleet-app/docs/TODO.md)): + 司機車輛設定頁+強制跳轉、乘客端車種選擇+清潔費預告、完成卡分項、 + 司機收入頁等式改「營業額 − 手續費 + 清潔費 = 實得」、多停靠點編輯與司機端全程顯示。 + + **其餘後端項目**:O5(待拍板);N 的衍生風險——乘客建單時看不到預估車資 + (繞路越多車資越高),若要「先報價」需要一支以全程路線試算的報價 API,目前**沒有**。** 計費地基 **F1–F8+F3 里程退路+F9-1~F9-6+M 整數台幣 已全數合併進 main**,三端對帳與 F3/F9-3/F9-4 皆 docker E2E 驗過。 其餘皆屬「量體上升後才需」的大資料量最佳化,勿過早做: diff --git a/internal/osrm/client.go b/internal/osrm/client.go index 57f9426..c9e4a6b 100644 --- a/internal/osrm/client.go +++ b/internal/osrm/client.go @@ -3,8 +3,10 @@ package osrmclient import ( "context" "encoding/json" + "errors" "fmt" "net/http" + "strings" "time" "line-fleet-dispatch/internal/util" @@ -70,3 +72,68 @@ func fallbackETA(fromLat, fromLng, toLat, toLng float64) (int, int, error) { roadDist := dist * 1.4 return util.EstimateETASec(roadDist), int(roadDist), nil } + +// Point 路徑上的一個座標點(N5)。 +// 自訂而非用 model.GeoPoint:osrm 是最底層的外部服務 client,不該依賴領域模型。 +type Point struct { + Lat, Lng float64 +} + +// ErrTooFewPoints 多點路線至少要兩個座標點。 +var ErrTooFewPoints = errors.New("路線至少需要兩個座標點") + +// RouteVia 計算「依序經過所有點」的全程路線(N5):起點 → 各停靠點 → 終點,**含繞路**。 +// +// OSRM 的 /route/v1 本來就支援多座標(`;` 分隔),是我們的 client 之前只開放兩點。 +// 既有的兩點 RouteDuration **保留不動**——派單 ETA 與 F3 的既有行為不受影響。 +// +// 失敗時退回逐段 haversine 累加(見 fallbackVia)。 +func (c *Client) RouteVia(ctx context.Context, points []Point) (durationSec int, distanceM int, err error) { + if len(points) < 2 { + return 0, 0, ErrTooFewPoints + } + if c == nil { + return fallbackVia(points) + } + coords := make([]string, 0, len(points)) + for _, p := range points { + // OSRM 的座標順序是 lng,lat——對調會把台北送到別的半球。 + coords = append(coords, fmt.Sprintf("%f,%f", p.Lng, p.Lat)) + } + url := fmt.Sprintf("%s/route/v1/driving/%s?overview=false", c.baseURL, strings.Join(coords, ";")) + + req, err := http.NewRequestWithContext(ctx, http.MethodGet, url, nil) + if err != nil { + return fallbackVia(points) + } + resp, err := c.httpClient.Do(req) + if err != nil { + return fallbackVia(points) + } + defer resp.Body.Close() + + if resp.StatusCode >= 300 { + return fallbackVia(points) + } + var data routeResponse + if err := json.NewDecoder(resp.Body).Decode(&data); err != nil || data.Code != "Ok" || len(data.Routes) == 0 { + return fallbackVia(points) + } + return int(data.Routes[0].Duration), int(data.Routes[0].Distance), nil +} + +// fallbackVia OSRM 不可用時的多點退路:**逐段**累加再取和(N5 明確要求)。 +// +// 不可以只算頭尾兩點——那會把繞路全部漏掉,多停靠點行程的退路里程會退化成直達距離; +// 而 billableDistanceM 取「軌跡 vs 路線」大者時就只剩軌跡可用,軌跡若稀疏(見 F3) +// 就會嚴重低估車資。 +func fallbackVia(points []Point) (int, int, error) { + if len(points) < 2 { + return 0, 0, ErrTooFewPoints + } + total := 0.0 + for i := 1; i < len(points); i++ { + total += util.HaversineM(points[i-1].Lat, points[i-1].Lng, points[i].Lat, points[i].Lng) * 1.4 + } + return util.EstimateETASec(total), int(total), nil +} diff --git a/internal/osrm/route_via_test.go b/internal/osrm/route_via_test.go new file mode 100644 index 0000000..0119425 --- /dev/null +++ b/internal/osrm/route_via_test.go @@ -0,0 +1,107 @@ +package osrmclient + +import ( + "context" + "encoding/json" + "errors" + "net/http" + "net/http/httptest" + "strings" + "testing" +) + +// 台北四個點,構成一趟繞路行程。 +var ( + taipeiMain = Point{Lat: 25.0478, Lng: 121.5170} // 台北車站 + cityHall = Point{Lat: 25.0339, Lng: 121.5645} // 市政府 + songshan = Point{Lat: 25.0697, Lng: 121.5522} // 松山機場 + taipei101 = Point{Lat: 25.0339, Lng: 121.5645} // 台北101 +) + +// TestRouteVia_URL串接所有座標 OSRM 的 /route/v1 支援多座標(`;` 分隔), +// 之前只是我們的 client 沒開放。 +func TestRouteVia_URL串接所有座標(t *testing.T) { + var gotPath string + srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + gotPath = r.URL.Path + _ = json.NewEncoder(w).Encode(map[string]any{ + "code": "Ok", + "routes": []map[string]any{{"duration": 1234.0, "distance": 8888.0}}, + }) + })) + defer srv.Close() + + c := NewClient(srv.URL) + sec, distM, err := c.RouteVia(context.Background(), []Point{taipeiMain, cityHall, songshan}) + if err != nil { + t.Fatalf("RouteVia 失敗:%v", err) + } + if sec != 1234 || distM != 8888 { + t.Fatalf("應回 OSRM 的數值,得到 %d 秒 / %d 公尺", sec, distM) + } + + // 座標順序必須是 lng,lat——對調會把台北送到別的半球。 + wantCoords := "121.517000,25.047800;121.564500,25.033900;121.552200,25.069700" + if !strings.Contains(gotPath, wantCoords) { + t.Fatalf("URL 應依序串接所有座標(lng,lat):\n得到 %s\n預期含 %s", gotPath, wantCoords) + } +} + +// TestRouteVia_點數不足 少於兩點無法構成路線。 +func TestRouteVia_點數不足(t *testing.T) { + c := NewClient("http://unused") + for _, pts := range [][]Point{nil, {taipeiMain}} { + if _, _, err := c.RouteVia(context.Background(), pts); !errors.Is(err, ErrTooFewPoints) { + t.Fatalf("預期 ErrTooFewPoints,得到 %v", err) + } + } +} + +// TestRouteVia_OSRM掛掉時逐段累加 N5 明確要求:退路要**逐段**算再取和。 +// +// 只算頭尾兩點會把繞路全部漏掉——多停靠點的退路里程退化成直達距離, +// billableDistanceM 取大者時就只剩軌跡可用,軌跡稀疏(F3)就會嚴重低估車資。 +func TestRouteVia_OSRM掛掉時逐段累加(t *testing.T) { + // 500 → 走 fallback。 + srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + w.WriteHeader(http.StatusInternalServerError) + })) + defer srv.Close() + c := NewClient(srv.URL) + + // 繞路:台北車站 → 松山機場 → 台北101(先北再南)。 + viaRoute := []Point{taipeiMain, songshan, taipei101} + _, viaM, err := c.RouteVia(context.Background(), viaRoute) + if err != nil { + t.Fatalf("fallback 不該失敗:%v", err) + } + + // 直達:台北車站 → 台北101。 + _, directM, err := c.RouteVia(context.Background(), []Point{taipeiMain, taipei101}) + if err != nil { + t.Fatalf("fallback 不該失敗:%v", err) + } + + if viaM <= directM { + t.Fatalf("繞路里程(%d) 應大於直達(%d)——逐段累加沒生效,繞路被漏掉了", viaM, directM) + } + + // 逐段和:手動累加兩段,應與 RouteVia 的結果一致。 + _, segA, _ := fallbackVia([]Point{taipeiMain, songshan}) + _, segB, _ := fallbackVia([]Point{songshan, taipei101}) + if diff := viaM - (segA + segB); diff > 1 || diff < -1 { + t.Fatalf("多點退路應等於逐段和:得到 %d,逐段和 %d", viaM, segA+segB) + } +} + +// TestRouteVia_nil客戶端走退路 與既有 RouteDuration 的 nil 行為一致。 +func TestRouteVia_nil客戶端走退路(t *testing.T) { + var c *Client + _, distM, err := c.RouteVia(context.Background(), []Point{taipeiMain, songshan}) + if err != nil { + t.Fatalf("nil client 應走退路而非報錯:%v", err) + } + if distM <= 0 { + t.Fatalf("退路里程應為正數,得到 %d", distM) + } +} diff --git a/internal/service/tracking.go b/internal/service/tracking.go index 315eb82..1f1d7a6 100644 --- a/internal/service/tracking.go +++ b/internal/service/tracking.go @@ -39,6 +39,7 @@ type TrackingService struct { fees *FeeSettings osrm *osrmclient.Client reports *repository.ReportRepository + stops *repository.RideStopRepository etaMinInterval time.Duration etaDistThreshold float64 @@ -93,6 +94,12 @@ func (s *TrackingService) SetReports(reports *repository.ReportRepository) { s.reports = reports } +// SetStops 注入停靠點 repo,完成計費時改用全程多點路線(N5);可選—— +// 未注入時多停靠點行程會退回兩點直達路線(會低估繞路,但不會失敗)。 +func (s *TrackingService) SetStops(stops *repository.RideStopRepository) { + s.stops = stops +} + // publish nil-safe 事件發佈 func (s *TrackingService) publish(rec events.Recipient, ev events.Event) { if s.publisher == nil { @@ -248,6 +255,61 @@ func billableDistanceM(trackM, routeM int) int { return trackM } +// routeDistanceM 計費用的路線里程(公尺);-1 =無路線可用(呼叫端改用軌跡里程)。 +// +// 多停靠點行程(N5 拍板 2026-07-16)走**全程實際路線**:起點 → 各停靠點 → 最終目的地, +// **含繞路**。司機真的開了那些路,繞路不該做白工;用「起點→終點」的直達路線會嚴重低估。 +// +// **已跳過的停靠點不計入**(2026-07-17 拍板的衍生結論):乘客沒出現、司機沒去那站, +// 就沒開那段路,計入等於收乘客沒走的路的錢。軌跡那側本來就自然反映(沒去就沒軌跡)。 +// +// 單點訂單、未注入停靠點 repo、或跳過後不足兩點時,一律退回現行的兩點直達路線。 +func (s *TrackingService) routeDistanceM(ctx context.Context, ride *model.Ride) int { + if s.osrm == nil { + return -1 + } + if pts := s.billableStopPoints(ride.ID); len(pts) >= 2 { + _, routeM, err := s.osrm.RouteVia(ctx, pts) + if err == nil { + log.Info().Int64("ride_id", ride.ID).Int("stops", len(pts)).Int("route_m", routeM). + Msg("計費里程改用全程多點路線(多停靠點行程)") + return routeM + } + log.Error().Err(err).Int64("ride_id", ride.ID).Msg("多點路線計算失敗,退回兩點直達路線") + } + if ride.DropoffPoint == nil { + return -1 + } + _, routeM, _ := s.osrm.RouteDuration(ctx, + ride.PickupPoint.Lat, ride.PickupPoint.Lng, + ride.DropoffPoint.Lat, ride.DropoffPoint.Lng) + return routeM +} + +// billableStopPoints 依序回傳「要計費」的停靠點座標——即未被跳過者。 +// 單點訂單或讀取失敗回 nil(呼叫端退回兩點路線)。 +// +// 不必另外把 ride.PickupPoint 補進去:N3 已保證 rides.pickup_point = 第一個 pickup stop、 +// dropoff_point = seq 最大的 dropoff stop,兩者本來就在 stops 裡。 +func (s *TrackingService) billableStopPoints(rideID int64) []osrmclient.Point { + if s.stops == nil { + return nil + } + stops, err := s.stops.ListByRide(rideID) + if err != nil { + log.Error().Err(err).Int64("ride_id", rideID).Msg("讀取停靠點失敗,計費改用兩點直達路線") + return nil + } + pts := make([]osrmclient.Point, 0, len(stops)) + for _, st := range stops { + if st.Skipped() { + continue // 沒去就沒開那段路 + } + pts = append(pts, osrmclient.Point{Lat: st.Point.Lat, Lng: st.Point.Lng}) + } + return pts +} + func (s *TrackingService) Complete(ctx context.Context, rideID, driverID int64) error { ride, err := s.rides.GetByID(rideID) if err != nil { @@ -257,15 +319,10 @@ func (s *TrackingService) Complete(ctx context.Context, rideID, driverID int64) return ErrForbidden } trackM, _ := s.rides.TrackDistanceM(rideID) - // F3 退路:GPS 軌跡里程可能為 0 或稀疏而偏低。有目的地座標且已注入 OSRM 時, - // 以 OSRM pickup→dropoff 路線里程作地板,計費里程取「軌跡 vs 路線」大者—— - // 軌跡真的長於路線=司機繞路,仍照實計;軌跡偏低則用路線里程補回。 - routeM := -1 - if s.osrm != nil && ride.DropoffPoint != nil { - _, routeM, _ = s.osrm.RouteDuration(ctx, - ride.PickupPoint.Lat, ride.PickupPoint.Lng, - ride.DropoffPoint.Lat, ride.DropoffPoint.Lng) - } + // F3 退路:GPS 軌跡里程可能為 0 或稀疏而偏低。以 OSRM 路線里程作地板, + // 計費里程取「軌跡 vs 路線」大者——軌跡真的長於路線=司機繞路,仍照實計; + // 軌跡偏低則用路線里程補回。**取大者的邏輯不變**(N5),只有 routeM 的算法要改。 + routeM := s.routeDistanceM(ctx, ride) distanceM := billableDistanceM(trackM, routeM) if routeM > trackM { log.Info().Int64("ride_id", rideID).Int("track_m", trackM).Int("route_m", routeM). diff --git a/internal/service/tracking_route_stops_test.go b/internal/service/tracking_route_stops_test.go new file mode 100644 index 0000000..2f87b94 --- /dev/null +++ b/internal/service/tracking_route_stops_test.go @@ -0,0 +1,224 @@ +package service + +import ( + "context" + "encoding/json" + "net/http" + "net/http/httptest" + "strings" + "sync" + "testing" + "time" + + "line-fleet-dispatch/internal/constants" + lineclient "line-fleet-dispatch/internal/line" + "line-fleet-dispatch/internal/model" + osrmclient "line-fleet-dispatch/internal/osrm" + "line-fleet-dispatch/internal/repository" +) + +// fakeOSRM 記錄收到的路徑請求,供斷言「送了哪些座標」。 +type fakeOSRM struct { + mu sync.Mutex + paths []string + distM float64 +} + +func newFakeOSRM(t *testing.T, distM float64) (*osrmclient.Client, *fakeOSRM) { + t.Helper() + f := &fakeOSRM{distM: distM} + srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + f.mu.Lock() + f.paths = append(f.paths, r.URL.Path) + f.mu.Unlock() + _ = json.NewEncoder(w).Encode(map[string]any{ + "code": "Ok", + "routes": []map[string]any{{"duration": 600.0, "distance": f.distM}}, + }) + })) + t.Cleanup(srv.Close) + return osrmclient.NewClient(srv.URL), f +} + +func (f *fakeOSRM) lastPath(t *testing.T) string { + t.Helper() + f.mu.Lock() + defer f.mu.Unlock() + if len(f.paths) == 0 { + t.Fatal("OSRM 未被呼叫") + } + return f.paths[len(f.paths)-1] +} + +// routeStopsFixture 一趟已上車的四停行程(A 上/B 上/A 下/B 下)。 +type routeStopsFixture struct { + svc *TrackingService + rides *repository.RideRepository + stops *repository.RideStopRepository + osrm *fakeOSRM + rideID int64 + driverID int64 + stopIDs []int64 +} + +func newRouteStopsFixture(t *testing.T, prefix string, withStops bool) *routeStopsFixture { + t.Helper() + db := newServiceTestDB(t) + redis := newServiceTestRedis(t) + drivers := repository.NewDriverRepository(db) + rides := repository.NewRideRepository(db) + tracks := repository.NewTrackRepository(db) + customers := repository.NewCustomerRepository(db) + stopsRepo := repository.NewRideStopRepository(db) + + cust, err := customers.FindOrCreateByLineUserID(prefix+"_cust", "乘客") + if err != nil { + t.Fatalf("建立乘客失敗:%v", err) + } + driver, err := drivers.FindOrCreate(prefix+"_drv", "司機") + if err != nil { + t.Fatalf("建立司機失敗:%v", err) + } + + now := time.Now() + dropoff := model.GeoPoint{Lat: 25.0339, Lng: 121.5645} + ride := &model.Ride{ + CustomerID: cust.ID, Status: constants.RideStatusRequested, + PickupPoint: model.GeoPoint{Lat: 25.0478, Lng: 121.5170}, PickupAddress: "台北車站", + DropoffPoint: &dropoff, DropoffAddress: "台北101", + RequestedAt: now, CreatedAt: now, UpdatedAt: now, + } + if err := rides.Create(ride); err != nil { + t.Fatalf("建立訂單失敗:%v", err) + } + + var ids []int64 + if withStops { + rows := []repository.StopRow{ + {Seq: 1, Kind: constants.StopKindPickup, Lat: 25.0478, Lng: 121.5170, PassengerLabel: "A"}, + {Seq: 2, Kind: constants.StopKindPickup, Lat: 25.0697, Lng: 121.5522, PassengerLabel: "B"}, + {Seq: 3, Kind: constants.StopKindDropoff, Lat: 25.0330, Lng: 121.5654, PassengerLabel: "A"}, + {Seq: 4, Kind: constants.StopKindDropoff, Lat: 25.0339, Lng: 121.5645, PassengerLabel: "B"}, + } + if err := stopsRepo.CreateForRide(ride.ID, rows); err != nil { + t.Fatalf("建立停靠點失敗:%v", err) + } + list, err := stopsRepo.ListByRide(ride.ID) + if err != nil { + t.Fatalf("讀停靠點失敗:%v", err) + } + for _, s := range list { + ids = append(ids, s.ID) + } + } + + if err := rides.AcceptRide(ride.ID, driver.ID, 300); err != nil { + t.Fatalf("接單失敗:%v", err) + } + if err := rides.UpdateStatus(ride.ID, constants.RideStatusPickedUp); err != nil { + t.Fatalf("上車失敗:%v", err) + } + + osrm, fake := newFakeOSRM(t, 12000) + svc := NewTrackingService(drivers, rides, tracks, redis, lineclient.NewClient(""), nil, 0, 0, nil) + svc.SetOSRM(osrm) + svc.SetStops(stopsRepo) + + return &routeStopsFixture{ + svc: svc, rides: rides, stops: stopsRepo, osrm: fake, + rideID: ride.ID, driverID: driver.ID, stopIDs: ids, + } +} + +// TestComplete_多停靠點走全程路線 N5:計費吃「起點 → 各停靠點 → 終點」的全程路線(含繞路), +// 不是「起點→最終目的地」的直達。 +func TestComplete_多停靠點走全程路線(t *testing.T) { + f := newRouteStopsFixture(t, "U_route_via", true) + + if err := f.svc.Complete(context.Background(), f.rideID, f.driverID); err != nil { + t.Fatalf("完成行程失敗:%v", err) + } + + // 送給 OSRM 的路徑應含全部四個停靠點的座標(依序)。 + path := f.osrm.lastPath(t) + for _, want := range []string{ + "121.517000,25.047800", // A 上 + "121.552200,25.069700", // B 上(繞去松山) + "121.565400,25.033000", // A 下 + "121.564500,25.033900", // B 下 + } { + if !strings.Contains(path, want) { + t.Fatalf("全程路線應含座標 %s:\n%s", want, path) + } + } +} + +// TestComplete_跳過的停靠點不計入計費路線 2026-07-17 拍板的衍生結論: +// 乘客沒出現、司機沒去那站,就沒開那段路——計入等於收乘客沒走的路的錢。 +func TestComplete_跳過的停靠點不計入計費路線(t *testing.T) { + f := newRouteStopsFixture(t, "U_route_skip", true) + + // B 沒出現 → 跳過 B 的上車點(seq=2,繞去松山那段)與下車點(seq=4)。 + stopSvc := NewRideStopService(f.rides, f.stops) + if err := stopSvc.MarkSkipped(f.driverID, f.rideID, f.stopIDs[1]); err != nil { + t.Fatalf("跳過失敗:%v", err) + } + if err := stopSvc.MarkSkipped(f.driverID, f.rideID, f.stopIDs[3]); err != nil { + t.Fatalf("跳過失敗:%v", err) + } + + if err := f.svc.Complete(context.Background(), f.rideID, f.driverID); err != nil { + t.Fatalf("完成行程失敗:%v", err) + } + + path := f.osrm.lastPath(t) + // 未跳過的兩站仍在。 + for _, want := range []string{"121.517000,25.047800", "121.565400,25.033000"} { + if !strings.Contains(path, want) { + t.Fatalf("未跳過的站應留在路線裡 %s:\n%s", want, path) + } + } + // 被跳過的站不得出現——否則就是收了乘客沒走的路的錢。 + for _, gone := range []string{"121.552200,25.069700", "121.564500,25.033900"} { + if strings.Contains(path, gone) { + t.Fatalf("已跳過的站不該計入計費路線 %s:\n%s", gone, path) + } + } +} + +// TestComplete_單點訂單維持兩點直達 N5 不得改變既有單點訂單的計費行為。 +func TestComplete_單點訂單維持兩點直達(t *testing.T) { + f := newRouteStopsFixture(t, "U_route_single", false) // 不建 stops + + if err := f.svc.Complete(context.Background(), f.rideID, f.driverID); err != nil { + t.Fatalf("完成行程失敗:%v", err) + } + + path := f.osrm.lastPath(t) + // 只有 pickup 與 dropoff 兩個座標,中間一個分號。 + if strings.Count(path, ";") != 1 { + t.Fatalf("單點訂單應走兩點直達路線:\n%s", path) + } + if !strings.Contains(path, "121.517000,25.047800") || !strings.Contains(path, "121.564500,25.033900") { + t.Fatalf("兩點路線座標錯誤:\n%s", path) + } +} + +// TestComplete_全部跳過時退回兩點 跳過後不足兩點 → 退回現行的兩點直達,不該失敗。 +func TestComplete_全部跳過時退回兩點(t *testing.T) { + f := newRouteStopsFixture(t, "U_route_allskip", true) + + stopSvc := NewRideStopService(f.rides, f.stops) + for _, id := range f.stopIDs[:3] { // 只留一站 → 不足兩點 + if err := stopSvc.MarkSkipped(f.driverID, f.rideID, id); err != nil { + t.Fatalf("跳過失敗:%v", err) + } + } + + if err := f.svc.Complete(context.Background(), f.rideID, f.driverID); err != nil { + t.Fatalf("完成行程不該失敗:%v", err) + } + if strings.Count(f.osrm.lastPath(t), ";") != 1 { + t.Fatalf("不足兩點時應退回兩點直達:\n%s", f.osrm.lastPath(t)) + } +}