Skip to content

feat(N5): 計費改吃全程實際路線(OSRM 多 waypoint,排除已跳過的站) - #35

Merged
thothawei merged 1 commit into
mainfrom
claude/n5-multi-waypoint-fare
Jul 17, 2026
Merged

thothawei merged 1 commit into
mainfrom
claude/n5-multi-waypoint-fare

Conversation

@thothawei

Copy link
Copy Markdown
Owner

Stacked PR:base 是 #34。合併順序:#30 → #31 → #32 → #33 → #34 → 本 PR。

N 章節最後一批。至此 N、O、P 三章全數完成,只剩 O5(可選、待拍板)。

OSRM 多 waypoint

osrm.Client.RouteVia(ctx, []Point):URL 依序串接所有座標(; 分隔、lng,lat 順序)。

OSRM 的 /route/v1 本來就支援多座標,是我們的 client 只開放兩點(TODO 已盤點出這個缺口)。

  • 既有兩點 RouteDuration 完全不動——派單 ETA 與 F3 既有行為不受影響
  • Point 型別自訂而非用 model.GeoPoint:osrm 是最底層的外部服務 client,不該依賴領域模型

fallbackVia 逐段累加

OSRM 掛掉時逐段 haversine×1.4 再取和。只算頭尾會把繞路全部漏掉,退路里程退化成直達距離;billableDistanceM 取「軌跡 vs 路線」大者時就只剩軌跡可用,軌跡稀疏(F3)便嚴重低估車資。

計費路線

TrackingService.routeDistanceM:有未跳過的停靠點(≥2)走全程多點路線,否則退回現行兩點直達(相容單點訂單)。billableDistanceM 取大者的邏輯完全不變——只有 routeM 的算法改了。

已跳過的停靠點不計入(2026-07-17 拍板「司機可跳過」的衍生結論):沒去就沒開那段路,計入等於收乘客沒走的路的錢。軌跡那側本來就自然反映(沒去就沒軌跡)。跳過後不足兩點時退回兩點直達,不會失敗。

不必把 ride.PickupPoint 另外補進路線:N3 已保證 rides.pickup_point = 第一個 pickup stop、dropoff_point = seq 最大的 dropoff stop,兩者本來就在 stops 裡——補了會重複計算那一段。

車資公式本身(起步+每公里、整數元、快照制、min_fare 地板)完全不變。

驗收(實際跑過)

  • go build / go vet / gofmt 綠;service 1478s、repository 637s、handler 49s、constants、osrm 全套通過。
  • 單元(internal/osrm,無需容器):URL 依序串接且為 lng,lat、點數不足回 ErrTooFewPoints、OSRM 掛掉時逐段累加(繞路 > 直達,且等於手動逐段和)、nil client 走退路。
  • 整合(真 PostGIS + fake OSRM 伺服器,斷言實際送出的座標而非只看回傳數字):多停靠點走全程路線、跳過的站不計入、單點訂單維持兩點直達、全部跳過時退回兩點。
  • 反向驗證:拿掉 st.Skipped() 過濾 → 已跳過的座標出現在計費路線,FAIL;fallbackVia 改成只算頭尾 → 繞路(7040) = 直達(7040),繞路被漏掉,FAIL。

未驗:docker compose 起全服務的 live E2E(含真 OSRM)。

N/O/P 三章完成後的後端能力

司機填車輛才能接單 → 乘客指定車種(可帶多乘客/多停靠點)→ 只派同車種、找不到明確取消 → 司機看得到全程、可標記到站/跳過 → 完成時依全程實際路線(排除已跳過)計費、依乘客指定車種加收清潔費、報表分項 → 乘客看得到車種車牌與司機電話、對話無時間限制。

下一步:補下游 UI

後端已跑在兩端前面很遠,做完的能力在 admin 與 App 都還看不到:

  • admin:費率頁 pet_cleaning_fee_bps、月報表清潔費分項欄、(O5 若要做)車輛審核。
  • App:司機車輛設定頁+強制跳轉、乘客端車種選擇+清潔費預告、完成卡分項、司機收入頁等式改「營業額 − 手續費 + 清潔費 = 實得」、多停靠點編輯與司機端全程顯示。

衍生風險(尚無解):乘客建單時看不到預估車資,而繞路越多車資越高。若要「先報價」需要一支以全程路線試算的報價 API,目前沒有。

🤖 Generated with Claude Code

@thothawei
thothawei force-pushed the claude/n4-n6-n7-stops-visibility branch 2 times, most recently from f08ba00 to 3d48786 Compare July 17, 2026 06:36
@thothawei
thothawei force-pushed the claude/n5-multi-waypoint-fare branch from 0c0552b to 0386d9a Compare July 17, 2026 06:37
@thothawei
thothawei changed the base branch from claude/n4-n6-n7-stops-visibility to main July 17, 2026 06:37
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 <noreply@anthropic.com>
@thothawei
thothawei force-pushed the claude/n5-multi-waypoint-fare branch from 0386d9a to 872e209 Compare July 17, 2026 06:38
@thothawei
thothawei merged commit 419b6b3 into main Jul 17, 2026
1 check passed
thothawei added a commit that referenced this pull request Jul 27, 2026
- docs/TODO.md 的 S 段補 admin 可見性(SummaryByDrivers 批次彙總、
  /admin/drivers 帶 rating_avg/rating_count、/admin/rides/:id 帶 rating),
  含 docker compose 實打數字。
- README 端點表補 /api/customer/rides/estimate、/api/customer/rides/:id/rating、
  /api/admin/drivers/:id/vehicle-review,並標明 admin 兩支端點多帶的欄位。
- **修正 README「規劃中(尚未實作)」的過期資訊**:N/O/P 與寵物車清潔費、
  司機聯絡方式早已實作並合併(PR #35–#43),該段卻仍寫「都還沒實作」。
  改寫成實際剩下的項目,逐條寫明是量體、產品決策還是外部資源卡住。

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
@thothawei
thothawei deleted the claude/n5-multi-waypoint-fare branch July 28, 2026 00:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant