From 17d48ccec7e1b246be4da04cee31a19c09b52dd5 Mon Sep 17 00:00:00 2001 From: awei Date: Fri, 17 Jul 2026 11:20:03 +0800 Subject: [PATCH] =?UTF-8?q?feat(O6+P5):=20=E5=AF=B5=E7=89=A9=E8=BB=8A?= =?UTF-8?q?=E6=B8=85=E6=BD=94=E8=B2=BB=EF=BC=88=E8=A8=88=E8=B2=BB=EF=BC=8F?= =?UTF-8?q?=E8=90=BD=E5=B8=B3=EF=BC=8F=E5=A0=B1=E8=A1=A8=E5=88=86=E9=A0=85?= =?UTF-8?q?=EF=BC=89=EF=BC=8B=E4=B9=98=E5=AE=A2=E5=8F=AF=E8=AE=80=E8=B2=BB?= =?UTF-8?q?=E7=8E=87=E7=AB=AF=E9=BB=9E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit O6 計費:Quote 簽名改為 Quote(distanceM, requiredVehicleType) RideQuote。 刻意不留舊 wrapper——留了就是留一個「忘了帶車種=靜靜不收清潔費」的陷阱; 改簽名讓漏改的呼叫點編譯不過(產品碼只有 tracking.go 一處)。 cleaning_fee = floorNtd(fare × pet_cleaning_fee_bps / 10000) // 僅乘客指定 pet commission = floorNtd(fare × commission_bps / 10000) // 基準只有 fare driver_net = fare − commission + cleaning_fee // 清潔費全額歸司機 判斷依據是 rides.required_vehicle_type,不是 drivers.vehicle_type:Quote 只吃乘客 指定的車種,司機車種傳不進去。乘客沒指定寵物車卻剛好被派到寵物車司機時不得加收。 報表分項與計費同批(不可分開):daily_driver_earnings 加 cleaning_fee_cents, RollupRideDay/MonthlyDriverStats/DriverMonthlyEarnings 三段 SQL 同步。營業額維持 只含車資、應付總公司不受影響。net_cents 已含清潔費,不加分項欄則司機收入頁的 「營業額 − 手續費」對不上實得,破壞既有三端對帳。等式改為 「營業額 − 手續費 + 清潔費 = 實得」,測試直接釘住。 migration 000019:fleet_settings.pet_cleaning_fee_bps(CHECK 0..3000,上限進 DB)、 rides.cleaning_fee_cents(nullable,完成時定格)、daily_driver_earnings.cleaning_fee_cents。 ride.completed payload 加 cleaning_fee_cents,只在 >0 時帶(帶 0 會讓 App 顯示 一列「清潔費 NT$0」)。 P5:GET /api/customer/fees(customer JWT,唯讀)回 CustomerJSON()——另建白名單 map, 不是過濾 admin 的 JSON();過濾式寫法日後加欄位容易忘了濾。 順帶:抽出 newMigrateHandle test helper(可逆性測試共用),並把 P1 的可逆性測試 改用它。helper 註解記下「用版本而非 Steps(-1)」的理由。 驗收:build/vet/gofmt 綠;service 1069s、repository 619s、handler 47s、constants 全套通過。反向驗證 3 項皆確認 FAIL:清潔費計入抽成基準(手續費 2700→3300)、 CustomerJSON 改回 JSON()(手續費/月會費外洩)、Quote 改吃司機車種(未指定的乘客被加收)。 下游待同步(別的 repo,後果是少一個分項而非算錯錢):admin 費率頁與月報表分項欄、 App 完成卡分項與司機收入頁等式。 Co-Authored-By: Claude Opus 4.8 --- cmd/server/main.go | 2 + .../000019_add_pet_cleaning_fee.down.sql | 5 + .../000019_add_pet_cleaning_fee.up.sql | 20 ++ docs/TODO.md | 70 ++++++- internal/handler/admin.go | 5 +- internal/handler/customer.go | 21 ++ internal/model/models.go | 33 +-- internal/repository/migrate_handle_test.go | 54 +++++ .../report_billing_integration_test.go | 2 +- .../report_cleaning_fee_integration_test.go | 198 ++++++++++++++++++ internal/repository/repository.go | 61 ++++-- .../ride_required_vehicle_integration_test.go | 37 +--- internal/service/fee_settings.go | 80 +++++-- .../service/fee_settings_cleaning_test.go | 124 +++++++++++ internal/service/fee_settings_test.go | 33 ++- internal/service/lost_item_test.go | 4 +- internal/service/tracking.go | 21 +- .../service/tracking_cleaning_fee_test.go | 158 ++++++++++++++ 18 files changed, 820 insertions(+), 108 deletions(-) create mode 100644 db/migrations/000019_add_pet_cleaning_fee.down.sql create mode 100644 db/migrations/000019_add_pet_cleaning_fee.up.sql create mode 100644 internal/repository/migrate_handle_test.go create mode 100644 internal/repository/report_cleaning_fee_integration_test.go create mode 100644 internal/service/fee_settings_cleaning_test.go create mode 100644 internal/service/tracking_cleaning_fee_test.go diff --git a/cmd/server/main.go b/cmd/server/main.go index 597edb6..dc6a8c4 100644 --- a/cmd/server/main.go +++ b/cmd/server/main.go @@ -183,6 +183,7 @@ func main() { // 乘客認證:註冊/登入(line_user_id + 密碼 JWT) customerRegistry := service.NewCustomerRegistry(customerRepo) customerHandler := handler.NewCustomerHandler(customerRegistry, cfg.JWTSecret, cfg.JWTExpiryHours) + customerHandler.SetFeeSettings(feeSettings) // P5:乘客可讀的唯讀費率(白名單輸出) // Routes r.GET("/healthz", healthHandler.Healthz) @@ -204,6 +205,7 @@ func main() { customerAuthed.Use(middleware.CustomerAuth(cfg.JWTSecret)) { customerAuthed.POST("/rides", rideHandler.Create) + customerAuthed.GET("/customer/fees", customerHandler.Fees) customerAuthed.GET("/customer/rides/active", rideHandler.ActiveByCustomer) customerAuthed.GET("/customer/rides/:id", rideHandler.GetByCustomer) customerAuthed.POST("/rides/:id/cancel-by-customer", rideHandler.CancelByCustomer) diff --git a/db/migrations/000019_add_pet_cleaning_fee.down.sql b/db/migrations/000019_add_pet_cleaning_fee.down.sql new file mode 100644 index 0000000..b34b4f4 --- /dev/null +++ b/db/migrations/000019_add_pet_cleaning_fee.down.sql @@ -0,0 +1,5 @@ +-- DROP COLUMN 會自動連帶刪除依賴該欄位的 CHECK;DROP CONSTRAINT 是明示意圖(IF EXISTS,無害)。 +ALTER TABLE daily_driver_earnings DROP COLUMN IF EXISTS cleaning_fee_cents; +ALTER TABLE rides DROP COLUMN IF EXISTS cleaning_fee_cents; +ALTER TABLE fleet_settings DROP CONSTRAINT IF EXISTS chk_fleet_settings_pet_cleaning_fee_bps; +ALTER TABLE fleet_settings DROP COLUMN IF EXISTS pet_cleaning_fee_bps; diff --git a/db/migrations/000019_add_pet_cleaning_fee.up.sql b/db/migrations/000019_add_pet_cleaning_fee.up.sql new file mode 100644 index 0000000..2422962 --- /dev/null +++ b/db/migrations/000019_add_pet_cleaning_fee.up.sql @@ -0,0 +1,20 @@ +-- 寵物用車清潔費(O6):乘客指定 pet 車種的行程,在車資之上加收清潔費。 +-- 判斷依據是 rides.required_vehicle_type(乘客要什麼車),**不是** drivers.vehicle_type +-- (司機開什麼車)——乘客沒指定寵物車卻剛好被派到寵物車司機時不得加收。 + +-- 費率:比照 lost_item_fee_bps 的 bps 慣例。上限 30% 寫進 CHECK,不只靠 API 驗證: +-- 這是乘客實際被收的錢,設定寫錯的後果是超收。 +ALTER TABLE fleet_settings ADD COLUMN IF NOT EXISTS pet_cleaning_fee_bps INT NOT NULL DEFAULT 0; +ALTER TABLE fleet_settings DROP CONSTRAINT IF EXISTS chk_fleet_settings_pet_cleaning_fee_bps; +ALTER TABLE fleet_settings ADD CONSTRAINT chk_fleet_settings_pet_cleaning_fee_bps + CHECK (pet_cleaning_fee_bps >= 0 AND pet_cleaning_fee_bps <= 3000); + +-- 快照:完成時定格寫入(比照 fare/commission/net 的費率快照制,000012)。 +-- nullable——未完成/取消/舊資料為 NULL,與既有計費欄位語意一致。 +ALTER TABLE rides ADD COLUMN IF NOT EXISTS cleaning_fee_cents BIGINT; + +-- 報表分項(F5/F6/F7 的一致性延伸): +-- 「營業額」(revenue_cents) 維持只含車資,清潔費另立分項——它是清潔成本補償、不是營收, +-- 且不計入抽成(拍板 2026-07-16)。NOT NULL DEFAULT 0:彙總欄位一律有值, +-- 報表 SUM 不必處理 NULL。 +ALTER TABLE daily_driver_earnings ADD COLUMN IF NOT EXISTS cleaning_fee_cents BIGINT NOT NULL DEFAULT 0; diff --git a/docs/TODO.md b/docs/TODO.md index 7df9edf..44e2202 100644 --- a/docs/TODO.md +++ b/docs/TODO.md @@ -439,7 +439,52 @@ 司機列表顯示車種車牌;是否需要「車輛審核」狀態(pending/approved)待拍板—— 若需要,O3 的 gate 條件要改成「已審核」而非「有填」。 -- [ ] **O6. 寵物用車清潔費** ✅ **已定案(2026-07-16):比例加收,上限 30%** +- [x] **O6. 寵物用車清潔費** ✅ **已實作(2026-07-17,migration `000019`)**(定案 2026-07-16:比例加收,上限 30%) + + **計費**(`FeeSettings.Quote`):簽名改為 `Quote(distanceM int, requiredVehicleType string) RideQuote`。 + **刻意改簽名而不留舊 wrapper**——留了就是留一個「忘了帶車種=靜靜不收清潔費」的陷阱; + 改簽名讓漏改的呼叫點直接編譯不過(實測產品碼只有 `tracking.go` 一處,測試三處)。 + ``` + cleaning_fee = floorNtd(fare × pet_cleaning_fee_bps / 10000) // 僅乘客指定 pet;捨去(利乘客) + commission = floorNtd(fare × commission_bps / 10000) // 基準只有 fare,清潔費不計入抽成 + driver_net = fare − commission + cleaning_fee // 清潔費全額歸司機 + ``` + **判斷依據是 `rides.required_vehicle_type`,不是 `drivers.vehicle_type`**—— + `Quote` 只吃乘客指定的車種,司機車種根本傳不進去(型別層面就擋掉誤用)。 + + **報表分項(與計費同批,不可分開上線)**:`daily_driver_earnings` 加 `cleaning_fee_cents`; + `RollupRideDay`/`MonthlyDriverStats`/`DriverMonthlyEarnings` 三段 SQL 同步。 + 營業額(`revenue_cents`)**維持只含車資**;應付總公司=手續費+月會費,**不受清潔費影響**。 + **為什麼不能分兩批**:`net_cents` 來自 `driver_net_amount_cents`,該欄已含清潔費 → + 不同步加分項欄,司機收入頁的「營業額 − 手續費」就對不上實得(差額正是清潔費), + 破壞先前打通的三端對帳。等式因此改為 **營業額 − 手續費 + 清潔費 = 實得**(測試直接釘住這條式子)。 + + **資料**:`fleet_settings.pet_cleaning_fee_bps`(CHECK `0..3000`,上限進 DB 不只靠 API—— + 這是乘客實際被收的錢,寫錯就是超收)、`rides.cleaning_fee_cents`(nullable,完成時定格)、 + `daily_driver_earnings.cleaning_fee_cents`(NOT NULL DEFAULT 0,彙總欄一律有值)。 + 非寵物車行程寫 **0 而非 NULL**:「這趟沒加收」與「舊資料沒這個概念」是兩件事。 + + **乘客端可見**:`ride.completed` payload 加 `cleaning_fee_cents`,**只在 >0 時帶**—— + 帶 0 會讓 App 顯示一列「清潔費 NT$0」。 + + **驗收**:`go build`/`vet`/`gofmt` 綠。 + 單元:清潔費算式(釘住「不計入抽成」的具體數字——正確 2700、誤把清潔費計入基準則為 3300)、 + 只看乘客指定車種(`''`/sedan/suv/van7/accessible 皆不加收)、費率 0 不加收、捨去到整數元、 + 上限 `MaxPetCleaningFeeBps`、**P5 白名單**(`CustomerJSON` 只有一個欄位,內部費率一個都不能出現)。 + 整合(真 PostGIS + Redis):`TestComplete_指定寵物車落帳清潔費`(定格寫入+payload 分項)、 + **`TestComplete_寵物車司機載到未指定的乘客不加收`**(最容易寫錯的一條)、 + `TestCleaningFeeReports`(報表分項與等式)、`TestFleetSettingsPetCleaningFeeCap`(DB CHECK 擋 3001/負值)、 + `TestPetCleaningFeeMigrationReversible`。 + **反向驗證**:清潔費計入抽成基準 → 手續費變 3300,FAIL;`CustomerJSON` 改回 `JSON()` → + 手續費/月會費整組外洩,FAIL;`Quote` 改吃司機車種 → 未指定的乘客被加收,FAIL。 + **未驗**:docker compose 全服務 live E2E。 + + **下游待同步(本 repo 之外,兩端都會「少一個分項」而非算錯)**: + - admin:費率設定頁加 `pet_cleaning_fee_bps`;月報表加清潔費分項欄(`total_cleaning_fee_cents`)。 + - App:完成卡分項顯示(`CompletedRideSummary` 加 `cleaningFeeCents`); + 司機收入頁改用「營業額 − 手續費 + 清潔費 = 實得」(`GET /api/driver/earnings` 已回 `total_cleaning_fee_cents`)。 + + 原始定案內容如下(保留供對照): **規則** ✅ 觸發條件已拍板(2026-07-16):**依「乘客指定的車種」加收,不是依司機的車種**—— 乘客叫車時指定 `pet`(寵物用車)的行程,才在車資之上加收清潔費(見 **P. 乘客指定車種**)。 比例由後台設定,**硬上限 30%**(超過一律拒絕)。 @@ -607,7 +652,17 @@ 3. 實作時機:與 P3 同一批(P3 讓「找不到」變得可能發生,兩者不可分開上線—— 只上 P3 不上 P4,乘客會收到誤導性的泛用取消訊息)。 -- [ ] **P5. 乘客可讀的唯讀費率端點** ✅ **已定案(2026-07-16,採建議方案):新增專用端點** +- [x] **P5. 乘客可讀的唯讀費率端點** ✅ **已實作(2026-07-17)**(定案 2026-07-16:新增專用端點) + **`GET /api/customer/fees`**(customer JWT,唯讀)→ 目前只回 `pet_cleaning_fee_bps`。 + 回的是 `FeeSettings.CustomerJSON()`——**另建的白名單 map,不是把 admin 的 `JSON()` 過濾**。 + 理由如定案所述:過濾式寫法日後新增內部費率欄位時容易忘了濾,白名單預設什麼都不給。 + 讀記憶體快取(與 F4 同源),無額外 DB 負擔。 + 掛既有 `customerAuthed` 群組(`middleware.CustomerAuth`)。 + **驗收**:`TestCustomerJSON白名單` 逐一斷言 `commission_bps`/`monthly_membership_fee_cents`/ + 起步價/每公里/最低車資/遺失物費率**皆不得出現**,且欄位總數為 1。 + **反向驗證**:改成 `return s.JSON()` → 測試抓到 `commission_bps` 外洩,FAIL。 + + 原始定案內容如下(保留供對照): **`GET /api/customer/fees`**(customer JWT,唯讀):只回乘客該知道的欄位—— `pet_cleaning_fee_bps`(寵物車清潔費%);日後乘客需要知道的費率(如起步價,若要做預估)再逐一加入。 **白名單輸出,絕不可外洩** `commission_bps`(手續費)/`monthly_membership_fee_cents`(月會費) @@ -645,10 +700,13 @@ 清潔費依乘客指定車種、上限 30%、**不計入抽成**/不降級+取消原因明確化/customer fees 端點/ **電話明碼、僅該趟乘客可見**)——**N、O、P 規格完備,可開始實作**, 建議順序:O1→O2→O3(車輛地基)→ P1→P2→P3+P4(車種)→ O6+P5(清潔費)→ O4/O7(乘客可見)→ N(多停靠點,最大塊)。 - **進度:O1 ✅(2026-07-16)、O2 ✅、O3 ✅、P1 ✅、P2 ✅、P3 ✅、P4 ✅(皆 2026-07-17) - → **乘客指定車種整條鏈路已通**:建單帶車種 → 只派同車種 → 找不到就明確取消並帶機器可讀原因。 - 下一項建議 **O6+P5(清潔費)**——P 章節只剩 P5(`GET /api/customer/fees`), - 而 O6 的觸發條件(依 `rides.required_vehicle_type` 是否為 `pet`)現在已經存在了。** + **進度:O1 ✅(2026-07-16)、O2 ✅、O3 ✅、P1 ✅、P2 ✅、P3 ✅、P4 ✅、O6 ✅、P5 ✅(皆 2026-07-17) + → **P 章節全數完成**;O 章節只剩 **O4(乘客端可見車輛資訊)/O5(admin 呈現,可選)/ + O7(車輛快照+司機電話+留言板)**。 + 寵物車清潔費整條鏈路已通:乘客指定 pet → 只派寵物車 → 完成時依**乘客指定的車種**加收 → + 報表分項(營業額不含、抽成不含、全額歸司機)→ `ride.completed` 帶分項 → 乘客可查費率。 + 下一項建議 **O4+O7**(都是「乘客端可見的司機/車輛資訊」,共用 `ride.accepted` payload 與 + rides 快照欄,分開做會改到同一批地方兩次)。** 計費地基 **F1–F8+F3 里程退路+F9-1~F9-6+M 整數台幣 已全數合併進 main**,三端對帳與 F3/F9-3/F9-4 皆 docker E2E 驗過。 其餘皆屬「量體上升後才需」的大資料量最佳化,勿過早做: diff --git a/internal/handler/admin.go b/internal/handler/admin.go index 1d56a71..57c28d9 100644 --- a/internal/handler/admin.go +++ b/internal/handler/admin.go @@ -390,6 +390,8 @@ func (h *AdminHandler) PutFeeSettings(c *gin.Context) { CommissionBps *int64 `json:"commission_bps"` MonthlyMembershipFeeCents *int64 `json:"monthly_membership_fee_cents"` LostItemFeeBps *int64 `json:"lost_item_fee_bps"` + // PetCleaningFeeBps 寵物車清潔費%(O6):硬上限 3000(30%),超過回 400。 + PetCleaningFeeBps *int64 `json:"pet_cleaning_fee_bps"` } if err := c.ShouldBindJSON(&req); err != nil { c.JSON(http.StatusBadRequest, gin.H{"error": "參數錯誤"}) @@ -397,7 +399,8 @@ func (h *AdminHandler) PutFeeSettings(c *gin.Context) { } actorID := middleware.AdminIDFromCtx(c) if err := h.feeSettings.Update(req.BaseFareCents, req.PerKmFareCents, req.MinFareCents, - req.CommissionBps, req.MonthlyMembershipFeeCents, req.LostItemFeeBps, &actorID); err != nil { + req.CommissionBps, req.MonthlyMembershipFeeCents, req.LostItemFeeBps, + req.PetCleaningFeeBps, &actorID); err != nil { c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()}) return } diff --git a/internal/handler/customer.go b/internal/handler/customer.go index 54673f8..883e71b 100644 --- a/internal/handler/customer.go +++ b/internal/handler/customer.go @@ -13,6 +13,7 @@ import ( // CustomerHandler 乘客註冊與登入 type CustomerHandler struct { customers *service.CustomerRegistry + feeSettings *service.FeeSettings jwtSecret string jwtExpiryHours int } @@ -21,6 +22,26 @@ func NewCustomerHandler(customers *service.CustomerRegistry, jwtSecret string, j return &CustomerHandler{customers: customers, jwtSecret: jwtSecret, jwtExpiryHours: jwtExpiryHours} } +// SetFeeSettings 注入費率設定(供 GET /api/customer/fees);可選,比照 AdminHandler.SetFeeSettings。 +func (h *CustomerHandler) SetFeeSettings(fees *service.FeeSettings) { + h.feeSettings = fees +} + +// Fees GET /api/customer/fees(customer JWT,唯讀)——乘客該知道的費率(P5)。 +// 乘客在「選擇車種」UI 呼叫它,選寵物用車的當下就顯示「將加收清潔費 X%」, +// 而不是等行程完成才知道。 +// +// **白名單輸出**:回 FeeSettings.CustomerJSON(),不是把 admin 的 JSON() 過濾—— +// commission_bps(手續費)與 monthly_membership_fee_cents(月會費)是內部費率,絕不可外洩給乘客。 +// 讀記憶體快取(與 F4 同源),無額外 DB 負擔。 +func (h *CustomerHandler) Fees(c *gin.Context) { + if h.feeSettings == nil { + c.JSON(http.StatusServiceUnavailable, gin.H{"error": "費率查詢未啟用"}) + return + } + c.JSON(http.StatusOK, h.feeSettings.CustomerJSON()) +} + func (h *CustomerHandler) issueToken(id int64) (string, error) { return auth.GenerateToken("customer", id, h.jwtSecret, time.Duration(h.jwtExpiryHours)*time.Hour) } diff --git a/internal/model/models.go b/internal/model/models.go index e7fabb6..deef1bf 100644 --- a/internal/model/models.go +++ b/internal/model/models.go @@ -157,11 +157,14 @@ type Ride struct { // 這是清潔費(O6)加收與否的判斷依據——依**乘客要的車種**,不是司機開的車種。 RequiredVehicleType string `gorm:"column:required_vehicle_type;not null;default:''" json:"required_vehicle_type"` // 計費欄位:完成時定格寫入(費率快照制),一律以「分」儲存;未完成/取消為 nil。 - FareAmountCents *int64 `gorm:"column:fare_amount_cents" json:"fare_amount_cents"` - CommissionAmountCents *int64 `gorm:"column:commission_amount_cents" json:"commission_amount_cents"` - DriverNetAmountCents *int64 `gorm:"column:driver_net_amount_cents" json:"driver_net_amount_cents"` - CreatedAt time.Time `gorm:"not null" json:"created_at"` - UpdatedAt time.Time `gorm:"not null" json:"updated_at"` + FareAmountCents *int64 `gorm:"column:fare_amount_cents" json:"fare_amount_cents"` + CommissionAmountCents *int64 `gorm:"column:commission_amount_cents" json:"commission_amount_cents"` + DriverNetAmountCents *int64 `gorm:"column:driver_net_amount_cents" json:"driver_net_amount_cents"` + // CleaningFeeCents 寵物車清潔費(O6):僅 RequiredVehicleType == 'pet' 的行程才有值。 + // 不計入抽成、全額歸司機(DriverNetAmountCents 已含它);報表的「營業額」不含它。 + CleaningFeeCents *int64 `gorm:"column:cleaning_fee_cents" json:"cleaning_fee_cents"` + CreatedAt time.Time `gorm:"not null" json:"created_at"` + UpdatedAt time.Time `gorm:"not null" json:"updated_at"` } func (Ride) TableName() string { @@ -170,15 +173,17 @@ func (Ride) TableName() string { // FleetSettings 費率設定(單列,id 固定為 1)。金額以「分」儲存,手續費以 bps 儲存。 type FleetSettings struct { - ID int16 `gorm:"primaryKey" json:"-"` - BaseFareCents int64 `gorm:"column:base_fare_cents;not null" json:"base_fare_cents"` - PerKmFareCents int64 `gorm:"column:per_km_fare_cents;not null" json:"per_km_fare_cents"` - MinFareCents int64 `gorm:"column:min_fare_cents;not null" json:"min_fare_cents"` - CommissionBps int `gorm:"column:commission_bps;not null" json:"commission_bps"` - MonthlyMembershipFeeCents int64 `gorm:"column:monthly_membership_fee_cents;not null" json:"monthly_membership_fee_cents"` - LostItemFeeBps int `gorm:"column:lost_item_fee_bps;not null" json:"lost_item_fee_bps"` - UpdatedBy *int64 `gorm:"column:updated_by" json:"updated_by"` - UpdatedAt time.Time `gorm:"column:updated_at;not null" json:"updated_at"` + ID int16 `gorm:"primaryKey" json:"-"` + BaseFareCents int64 `gorm:"column:base_fare_cents;not null" json:"base_fare_cents"` + PerKmFareCents int64 `gorm:"column:per_km_fare_cents;not null" json:"per_km_fare_cents"` + MinFareCents int64 `gorm:"column:min_fare_cents;not null" json:"min_fare_cents"` + CommissionBps int `gorm:"column:commission_bps;not null" json:"commission_bps"` + MonthlyMembershipFeeCents int64 `gorm:"column:monthly_membership_fee_cents;not null" json:"monthly_membership_fee_cents"` + LostItemFeeBps int `gorm:"column:lost_item_fee_bps;not null" json:"lost_item_fee_bps"` + // PetCleaningFeeBps 寵物車清潔費%(O6):上限 3000(30%),由 DB CHECK 與 validateFeeSettings 雙重把關。 + PetCleaningFeeBps int `gorm:"column:pet_cleaning_fee_bps;not null" json:"pet_cleaning_fee_bps"` + UpdatedBy *int64 `gorm:"column:updated_by" json:"updated_by"` + UpdatedAt time.Time `gorm:"column:updated_at;not null" json:"updated_at"` } func (FleetSettings) TableName() string { diff --git a/internal/repository/migrate_handle_test.go b/internal/repository/migrate_handle_test.go new file mode 100644 index 0000000..7dd6779 --- /dev/null +++ b/internal/repository/migrate_handle_test.go @@ -0,0 +1,54 @@ +package repository + +import ( + "context" + "testing" + + "github.com/golang-migrate/migrate/v4" + _ "github.com/golang-migrate/migrate/v4/database/postgres" + _ "github.com/golang-migrate/migrate/v4/source/file" + tcpostgres "github.com/testcontainers/testcontainers-go/modules/postgres" + gormpostgres "gorm.io/driver/postgres" + "gorm.io/gorm" +) + +// newMigrateHandle 起真 PostGIS 容器、跑完整 migration,回傳 DB 連線與 migrate handle。 +// 給「可逆性測試」用——它們需要 migrate handle 才能 down 到指定版本, +// 而 newMigratedTestDB 只給 DB。Docker 不可用時跳過。 +// +// 可逆性測試請以**版本**表達意圖(m.Migrate(N)),不要用 m.Steps(-1): +// 後者卸的是最新的那個 migration,一旦有人在你之後新增 migration, +// 測試會安靜地改去驗別人的 down,你的 migration 反而失去覆蓋(O1 踩過,見 000018)。 +func newMigrateHandle(t *testing.T) (*gorm.DB, *migrate.Migrate) { + t.Helper() + ctx := context.Background() + container, err := tcpostgres.Run(ctx, "postgis/postgis:16-3.4", + tcpostgres.WithDatabase("test"), + tcpostgres.WithUsername("test"), + tcpostgres.WithPassword("test"), + tcpostgres.BasicWaitStrategies(), + ) + if err != nil { + t.Skipf("略過整合測試(Docker/testcontainers 不可用): %v", err) + } + t.Cleanup(func() { _ = container.Terminate(ctx) }) + + connStr, err := container.ConnectionString(ctx, "sslmode=disable") + if err != nil { + t.Fatalf("取得連線字串失敗: %v", err) + } + + m, err := migrate.New("file://../../db/migrations", connStr) + if err != nil { + t.Fatalf("建立 migrate 失敗: %v", err) + } + if err := m.Up(); err != nil && err != migrate.ErrNoChange { + t.Fatalf("up 失敗: %v", err) + } + + db, err := gorm.Open(gormpostgres.Open(connStr), &gorm.Config{}) + if err != nil { + t.Fatalf("連線失敗: %v", err) + } + return db, m +} diff --git a/internal/repository/report_billing_integration_test.go b/internal/repository/report_billing_integration_test.go index 7f45575..cd94952 100644 --- a/internal/repository/report_billing_integration_test.go +++ b/internal/repository/report_billing_integration_test.go @@ -165,7 +165,7 @@ func TestCompleteRideSnapshotsFare(t *testing.T) { } fare, commission, net := int64(18500), int64(2700), int64(15800) - if err := rides.CompleteRide(ride.ID, 5000, &fare, &commission, &net); err != nil { + if err := rides.CompleteRide(ride.ID, 5000, &fare, &commission, &net, nil); err != nil { t.Fatalf("CompleteRide 失敗:%v", err) } diff --git a/internal/repository/report_cleaning_fee_integration_test.go b/internal/repository/report_cleaning_fee_integration_test.go new file mode 100644 index 0000000..0c5e2cd --- /dev/null +++ b/internal/repository/report_cleaning_fee_integration_test.go @@ -0,0 +1,198 @@ +package repository + +import ( + "strings" + "testing" + + "github.com/golang-migrate/migrate/v4" + + "line-fleet-dispatch/internal/constants" + "line-fleet-dispatch/internal/model" +) + +// TestCleaningFeeReports O6 的報表分項:清潔費不進營業額、不進抽成,但含在司機實得裡。 +// 這是 F5/F6/F7 與 daily_driver_earnings 的一致性——少了分項欄,司機收入頁的 +// 「營業額 − 手續費」會對不上實得(差額正是清潔費)。 +func TestCleaningFeeReports(t *testing.T) { + db := newMigratedTestDB(t) + customers := NewCustomerRepository(db) + reports := NewReportRepository(db) + + cust, err := customers.FindOrCreateByLineUserID("U_clean", "寵物乘客") + if err != nil { + t.Fatalf("建立乘客失敗:%v", err) + } + driver := &model.Driver{ + LineUserID: "D_clean", Name: "寵物車司機", Status: 0, + VehicleType: constants.VehicleTypePet, PlateNumber: "CLEAN-01", + CreatedAt: billTestDay, UpdatedAt: billTestDay, + } + if err := db.Create(driver).Error; err != nil { + t.Fatalf("建立司機失敗:%v", err) + } + + // 兩筆已完成行程:一筆乘客指定寵物車(有清潔費),一筆沒指定(無清潔費)。 + // 兩筆都由同一位寵物車司機完成——這正是「依乘客指定車種、不依司機車種」的分界。 + type rideSpec struct { + requiredType string + fare, commission, net int64 + cleaning int64 + } + specs := []rideSpec{ + // 指定 pet:fare 18500、手續費 2700(基準只有 fare)、清潔費 3700、實得 18500−2700+3700 + {constants.VehicleTypePet, 18500, 2700, 19500, 3700}, + // 未指定:無清潔費,實得 = fare − commission + {"", 8500, 1200, 7300, 0}, + } + for _, s := range specs { + fare, commission, net, cleaning := s.fare, s.commission, s.net, s.cleaning + ride := &model.Ride{ + CustomerID: cust.ID, + DriverID: &driver.ID, + Status: constants.RideStatusCompleted, + PickupPoint: model.GeoPoint{Lat: 25.03, Lng: 121.56}, + PickupAddress: "台北車站", + RequiredVehicleType: s.requiredType, + RequestedAt: billTestDay, + CompletedAt: &billTestDay, + DistanceM: ptrInt(5000), + FareAmountCents: &fare, + CommissionAmountCents: &commission, + DriverNetAmountCents: &net, + CleaningFeeCents: &cleaning, + CreatedAt: billTestDay, + UpdatedAt: billTestDay, + } + if err := db.Create(ride).Error; err != nil { + t.Fatalf("建立已完成行程失敗:%v", err) + } + if err := reports.RollupRideDay(ride.ID); err != nil { + t.Fatalf("每日彙總 rollup 失敗:%v", err) + } + } + + wantRevenue := int64(18500 + 8500) // 27000——**不含**清潔費 + wantCommission := int64(2700 + 1200) // 3900——基準只有車資 + wantCleaning := int64(3700) // 只有指定 pet 的那筆 + wantNet := int64(19500 + 7300) // 26800——含清潔費 + + t.Run("月報表分項", func(t *testing.T) { + monthly, err := reports.MonthlyDriverStats(billTestMonth) + if err != nil { + t.Fatalf("月報表查詢失敗:%v", err) + } + if len(monthly) != 1 { + t.Fatalf("預期 1 位司機,得到 %d", len(monthly)) + } + m := monthly[0] + if m.TotalRevenueCents != wantRevenue { + t.Fatalf("營業額不該含清潔費:得到 %d,預期 %d", m.TotalRevenueCents, wantRevenue) + } + if m.TotalCommissionCents != wantCommission { + t.Fatalf("手續費不符:得到 %d,預期 %d", m.TotalCommissionCents, wantCommission) + } + if m.TotalCleaningFeeCents != wantCleaning { + t.Fatalf("清潔費分項不符:得到 %d,預期 %d", m.TotalCleaningFeeCents, wantCleaning) + } + if m.DriverNetCents != wantNet { + t.Fatalf("司機實得應含清潔費:得到 %d,預期 %d", m.DriverNetCents, wantNet) + } + // 應付總公司=手續費+月會費,**不受清潔費影響**(本測試無會費帳單 → 0)。 + if m.OwedToHqCents != wantCommission { + t.Fatalf("應付總公司不該受清潔費影響:得到 %d,預期 %d", m.OwedToHqCents, wantCommission) + } + }) + + t.Run("司機收入分項與等式", func(t *testing.T) { + earn, err := reports.DriverMonthlyEarnings(driver.ID, billTestMonth) + if err != nil { + t.Fatalf("司機收入查詢失敗:%v", err) + } + if earn.TotalRevenueCents != wantRevenue || earn.TotalCommissionCents != wantCommission || + earn.TotalCleaningFeeCents != wantCleaning || earn.DriverNetCents != wantNet { + t.Fatalf("司機收入分項不符:%+v", earn) + } + // 司機收入頁靠這條等式呈現;少了清潔費分項就對不起來。 + if got := earn.TotalRevenueCents - earn.TotalCommissionCents + earn.TotalCleaningFeeCents; got != earn.DriverNetCents { + t.Fatalf("等式失效:營業額 %d − 手續費 %d + 清潔費 %d = %d,但實得為 %d", + earn.TotalRevenueCents, earn.TotalCommissionCents, earn.TotalCleaningFeeCents, + got, earn.DriverNetCents) + } + }) +} + +// TestFleetSettingsPetCleaningFeeCap O6:上限 30% 寫進 DB CHECK,不只靠 API 驗證。 +// 這是乘客實際被收的錢,設定寫錯的後果是超收。 +func TestFleetSettingsPetCleaningFeeCap(t *testing.T) { + db := newMigratedTestDB(t) + + // 邊界值 3000(30%)應可寫入。 + if err := db.Exec(`UPDATE fleet_settings SET pet_cleaning_fee_bps = 3000 WHERE id = 1`).Error; err != nil { + t.Fatalf("3000 bps(上限)應為合法值:%v", err) + } + err := db.Exec(`UPDATE fleet_settings SET pet_cleaning_fee_bps = 3001 WHERE id = 1`).Error + if err == nil { + t.Fatal("超過 30% 的清潔費率不該寫得進去") + } + if !strings.Contains(strings.ToLower(err.Error()), "chk_fleet_settings_pet_cleaning_fee_bps") { + t.Fatalf("應由 chk_fleet_settings_pet_cleaning_fee_bps 擋下,實際錯誤:%v", err) + } + if err := db.Exec(`UPDATE fleet_settings SET pet_cleaning_fee_bps = -1 WHERE id = 1`).Error; err == nil { + t.Fatal("負的清潔費率不該寫得進去") + } +} + +// TestPetCleaningFeeMigrationReversible P1 之後的第二個 migration:驗 000019 可逆。 +func TestPetCleaningFeeMigrationReversible(t *testing.T) { + db, m := newMigrateHandle(t) + defer m.Close() + + hasColumn := func(table, col string) bool { + var n int64 + db.Raw(`SELECT count(*) FROM information_schema.columns + WHERE table_name=? AND column_name=?`, table, col).Scan(&n) + return n > 0 + } + hasConstraint := func(name string) bool { + var n int64 + db.Raw(`SELECT count(*) FROM pg_constraint WHERE conname=?`, name).Scan(&n) + return n > 0 + } + + for _, tc := range []struct{ table, col string }{ + {"fleet_settings", "pet_cleaning_fee_bps"}, + {"rides", "cleaning_fee_cents"}, + {"daily_driver_earnings", "cleaning_fee_cents"}, + } { + if !hasColumn(tc.table, tc.col) { + t.Fatalf("up 後 %s 應有欄位 %s", tc.table, tc.col) + } + } + if !hasConstraint("chk_fleet_settings_pet_cleaning_fee_bps") { + t.Fatal("up 後應有清潔費上限 CHECK") + } + + // 以版本表達意圖(比照 P1):日後在 O6 之後再加 migration,這個測試仍驗 O6 的 down。 + if err := m.Migrate(18); err != nil && err != migrate.ErrNoChange { + t.Fatalf("down 到 version 18 失敗:%v", err) + } + for _, tc := range []struct{ table, col string }{ + {"fleet_settings", "pet_cleaning_fee_bps"}, + {"rides", "cleaning_fee_cents"}, + {"daily_driver_earnings", "cleaning_fee_cents"}, + } { + if hasColumn(tc.table, tc.col) { + t.Fatalf("down 後 %s 不應還有欄位 %s", tc.table, tc.col) + } + } + if hasConstraint("chk_fleet_settings_pet_cleaning_fee_bps") { + t.Fatal("down 後不應還有清潔費 CHECK") + } + + if err := m.Up(); err != nil && err != migrate.ErrNoChange { + t.Fatalf("再次 up 失敗:%v", err) + } + if !hasColumn("rides", "cleaning_fee_cents") || !hasConstraint("chk_fleet_settings_pet_cleaning_fee_bps") { + t.Fatal("再次 up 後 O6 的欄位與 CHECK 應全部回來") + } +} diff --git a/internal/repository/repository.go b/internal/repository/repository.go index 3335881..c5c1abb 100644 --- a/internal/repository/repository.go +++ b/internal/repository/repository.go @@ -356,8 +356,10 @@ func (r *RideRepository) MarkPickedUp(id int64) error { }).Error } -// CompleteRide 完成行程並定格計費欄位(fare/commission/net 為 nil 時該欄位不寫入,維持 NULL)。 -func (r *RideRepository) CompleteRide(id int64, distanceM int, fareCents, commissionCents, driverNetCents *int64) error { +// CompleteRide 完成行程並定格計費欄位(各欄為 nil 時不寫入,維持 NULL)。 +// cleaningFeeCents 為寵物車清潔費(O6):非寵物車行程算出來是 0,仍會寫入—— +// 「這趟沒加收(0)」與「舊資料沒有這個概念(NULL)」是兩件事,報表分項要分得出來。 +func (r *RideRepository) CompleteRide(id int64, distanceM int, fareCents, commissionCents, driverNetCents, cleaningFeeCents *int64) error { now := time.Now() updates := map[string]interface{}{ "status": constants.RideStatusCompleted, @@ -374,6 +376,9 @@ func (r *RideRepository) CompleteRide(id int64, distanceM int, fareCents, commis if driverNetCents != nil { updates["driver_net_amount_cents"] = *driverNetCents } + if cleaningFeeCents != nil { + updates["cleaning_fee_cents"] = *cleaningFeeCents + } return r.db.Model(&model.Ride{}).Where("id = ? AND status = ?", id, constants.RideStatusPickedUp). Updates(updates).Error } @@ -521,27 +526,37 @@ func (r *ReportRepository) DailyDriverStats(date string) ([]DailyDriverReport, e // MonthlyDriverReport 月營運報表每司機一列。MembershipFeeCents / OwedToHqCents // 屬「應付總公司」語意,由 handler 依當前費率補上(repo 只回聚合數字)。 type MonthlyDriverReport struct { - DriverID int64 `json:"driver_id"` - DriverName string `json:"driver_name"` - TripCount int `json:"trip_count"` - TotalRevenueCents int64 `json:"total_revenue_cents"` - TotalCommissionCents int64 `json:"total_commission_cents"` - DriverNetCents int64 `json:"driver_net_cents"` - MembershipFeeCents int64 `json:"membership_fee_cents"` - OwedToHqCents int64 `json:"owed_to_hq_cents"` + DriverID int64 `json:"driver_id"` + DriverName string `json:"driver_name"` + TripCount int `json:"trip_count"` + // TotalRevenueCents 營業額=車資合計,**不含清潔費**(O6)。 + TotalRevenueCents int64 `json:"total_revenue_cents"` + TotalCommissionCents int64 `json:"total_commission_cents"` + // TotalCleaningFeeCents 寵物車清潔費合計(O6):不計入營業額與抽成,全額歸司機。 + // DriverNetCents 已含它,故「營業額 − 手續費 + 清潔費 = 實得」。 + TotalCleaningFeeCents int64 `json:"total_cleaning_fee_cents"` + DriverNetCents int64 `json:"driver_net_cents"` + MembershipFeeCents int64 `json:"membership_fee_cents"` + // OwedToHqCents 應付總公司=手續費+月會費,**不受清潔費影響**。 + OwedToHqCents int64 `json:"owed_to_hq_cents"` } // RollupRideDay 於行程完成後,重算該行程所屬 (司機, 台北日) 的彙總桶(F9-3)。 // 以「重算整桶」而非「+1 增量」實作——冪等、永遠等於 rides 的即時聚合,可安全重跑、自我修復。 func (r *ReportRepository) RollupRideDay(rideID int64) error { + // revenue_cents 只含車資(fare)——清潔費(O6)另立 cleaning_fee_cents 分項, + // 它是清潔成本補償、不是營收,且不計入抽成。net_cents 讀 driver_net_amount_cents, + // 該欄本身已含清潔費(fare − commission + cleaning),故「營業額 − 手續費 ≠ 實得」, + // 差額正是清潔費——報表要靠分項欄才能讓等式重新成立。 return r.db.Exec(` - INSERT INTO daily_driver_earnings (driver_id, day, trip_count, revenue_cents, commission_cents, net_cents, updated_at) + INSERT INTO daily_driver_earnings (driver_id, day, trip_count, revenue_cents, commission_cents, net_cents, cleaning_fee_cents, updated_at) SELECT r2.driver_id, (r2.completed_at AT TIME ZONE 'Asia/Taipei')::date AS day, COUNT(*)::int, COALESCE(SUM(r2.fare_amount_cents), 0)::bigint, COALESCE(SUM(r2.commission_amount_cents), 0)::bigint, COALESCE(SUM(r2.driver_net_amount_cents), 0)::bigint, + COALESCE(SUM(r2.cleaning_fee_cents), 0)::bigint, NOW() FROM rides r2 JOIN rides r1 ON r1.id = ? @@ -549,11 +564,12 @@ func (r *ReportRepository) RollupRideDay(rideID int64) error { AND (r2.completed_at AT TIME ZONE 'Asia/Taipei')::date = (r1.completed_at AT TIME ZONE 'Asia/Taipei')::date GROUP BY r2.driver_id, (r2.completed_at AT TIME ZONE 'Asia/Taipei')::date ON CONFLICT (driver_id, day) DO UPDATE SET - trip_count = EXCLUDED.trip_count, - revenue_cents = EXCLUDED.revenue_cents, - commission_cents = EXCLUDED.commission_cents, - net_cents = EXCLUDED.net_cents, - updated_at = NOW() + trip_count = EXCLUDED.trip_count, + revenue_cents = EXCLUDED.revenue_cents, + commission_cents = EXCLUDED.commission_cents, + net_cents = EXCLUDED.net_cents, + cleaning_fee_cents = EXCLUDED.cleaning_fee_cents, + updated_at = NOW() `, rideID, constants.RideStatusCompleted).Error } @@ -574,6 +590,7 @@ func (r *ReportRepository) MonthlyDriverStats(month string) ([]MonthlyDriverRepo SUM(dde.trip_count)::int AS trip_count, SUM(dde.revenue_cents)::bigint AS total_revenue_cents, SUM(dde.commission_cents)::bigint AS total_commission_cents, + SUM(dde.cleaning_fee_cents)::bigint AS total_cleaning_fee_cents, SUM(dde.net_cents)::bigint AS driver_net_cents, COALESCE(MAX(mi.amount_cents), 0)::bigint AS membership_fee_cents, SUM(dde.commission_cents)::bigint + COALESCE(MAX(mi.amount_cents), 0)::bigint AS owed_to_hq_cents @@ -589,11 +606,16 @@ func (r *ReportRepository) MonthlyDriverStats(month string) ([]MonthlyDriverRepo // DriverEarnings 單一司機當月收入聚合(F7)。MembershipFeeCents 讀自帳本快照(見下)。 type DriverEarnings struct { - TripCount int `json:"trip_count"` + TripCount int `json:"trip_count"` + // TotalRevenueCents 營業額=車資合計,**不含清潔費**(O6)。 TotalRevenueCents int64 `json:"total_revenue_cents"` TotalCommissionCents int64 `json:"total_commission_cents"` - DriverNetCents int64 `json:"driver_net_cents"` - MembershipFeeCents int64 `json:"membership_fee_cents"` + // TotalCleaningFeeCents 寵物車清潔費合計(O6):不計入營業額與抽成,全額歸司機。 + // 司機收入頁的等式因此是「營業額 − 手續費 + 清潔費 = 實得」——少了這個分項, + // DriverNetCents 會莫名比「營業額 − 手續費」多一截。 + TotalCleaningFeeCents int64 `json:"total_cleaning_fee_cents"` + DriverNetCents int64 `json:"driver_net_cents"` + MembershipFeeCents int64 `json:"membership_fee_cents"` } // DriverMonthlyEarnings 查單一司機當月收入(F7)。month 為 YYYY-MM。 @@ -608,6 +630,7 @@ func (r *ReportRepository) DriverMonthlyEarnings(driverID int64, month string) ( COALESCE(SUM(trip_count), 0)::int AS trip_count, COALESCE(SUM(revenue_cents), 0)::bigint AS total_revenue_cents, COALESCE(SUM(commission_cents), 0)::bigint AS total_commission_cents, + COALESCE(SUM(cleaning_fee_cents), 0)::bigint AS total_cleaning_fee_cents, COALESCE(SUM(net_cents), 0)::bigint AS driver_net_cents, COALESCE( (SELECT amount_cents FROM membership_invoices WHERE driver_id = ? AND period = ?), diff --git a/internal/repository/ride_required_vehicle_integration_test.go b/internal/repository/ride_required_vehicle_integration_test.go index 644fe35..ce8675b 100644 --- a/internal/repository/ride_required_vehicle_integration_test.go +++ b/internal/repository/ride_required_vehicle_integration_test.go @@ -1,17 +1,11 @@ package repository import ( - "context" "strings" "testing" "time" "github.com/golang-migrate/migrate/v4" - _ "github.com/golang-migrate/migrate/v4/database/postgres" - _ "github.com/golang-migrate/migrate/v4/source/file" - tcpostgres "github.com/testcontainers/testcontainers-go/modules/postgres" - gormpostgres "gorm.io/driver/postgres" - "gorm.io/gorm" "line-fleet-dispatch/internal/model" ) @@ -82,38 +76,9 @@ func TestRideRequiredVehicleTypeSchema(t *testing.T) { // P1 migration 可逆性:up → down 到 O1 為止 → 再 up。 // down 寫壞平常沒人發現,等到要 rollback 才炸。 func TestRideRequiredVehicleMigrationReversible(t *testing.T) { - ctx := context.Background() - container, err := tcpostgres.Run(ctx, "postgis/postgis:16-3.4", - tcpostgres.WithDatabase("test"), - tcpostgres.WithUsername("test"), - tcpostgres.WithPassword("test"), - tcpostgres.BasicWaitStrategies(), - ) - if err != nil { - t.Skipf("略過整合測試(Docker/testcontainers 不可用): %v", err) - } - t.Cleanup(func() { _ = container.Terminate(ctx) }) - - connStr, err := container.ConnectionString(ctx, "sslmode=disable") - if err != nil { - t.Fatalf("取得連線字串失敗: %v", err) - } - - m, err := migrate.New("file://../../db/migrations", connStr) - if err != nil { - t.Fatalf("建立 migrate 失敗: %v", err) - } + db, m := newMigrateHandle(t) defer m.Close() - if err := m.Up(); err != nil && err != migrate.ErrNoChange { - t.Fatalf("up 失敗: %v", err) - } - - db, err := gorm.Open(gormpostgres.Open(connStr), &gorm.Config{}) - if err != nil { - t.Fatalf("連線失敗: %v", err) - } - hasColumn := func() bool { var n int64 db.Raw(`SELECT count(*) FROM information_schema.columns diff --git a/internal/service/fee_settings.go b/internal/service/fee_settings.go index e9c75c1..d5edacc 100644 --- a/internal/service/fee_settings.go +++ b/internal/service/fee_settings.go @@ -4,6 +4,7 @@ import ( "errors" "sync" + "line-fleet-dispatch/internal/constants" "line-fleet-dispatch/internal/model" "line-fleet-dispatch/internal/repository" ) @@ -24,6 +25,7 @@ type FeeSettings struct { commissionBps int monthlyMembershipFeeCents int64 lostItemFeeBps int + petCleaningFeeBps int } // NewFeeSettings 自 DB 載入費率設定到記憶體快取。 @@ -40,6 +42,7 @@ func NewFeeSettings(repo *repository.FeeSettingsRepository) (*FeeSettings, error commissionBps: row.CommissionBps, monthlyMembershipFeeCents: row.MonthlyMembershipFeeCents, lostItemFeeBps: row.LostItemFeeBps, + petCleaningFeeBps: row.PetCleaningFeeBps, }, nil } @@ -54,9 +57,30 @@ func (s *FeeSettings) JSON() map[string]int64 { "commission_bps": int64(s.commissionBps), "monthly_membership_fee_cents": s.monthlyMembershipFeeCents, "lost_item_fee_bps": int64(s.lostItemFeeBps), + "pet_cleaning_fee_bps": int64(s.petCleaningFeeBps), } } +// CustomerJSON 乘客可讀的費率(P5)——**白名單輸出,不是把 JSON() 過濾**。 +// 另建一份的理由:過濾式寫法在日後新增內部費率欄位時,很容易忘了把它加進黑名單而外洩; +// 白名單預設什麼都不給,新欄位不會自己跑出來。 +// 絕不可包含 commission_bps(手續費)/monthly_membership_fee_cents(月會費)等內部費率。 +func (s *FeeSettings) CustomerJSON() map[string]int64 { + s.mu.RLock() + defer s.mu.RUnlock() + return map[string]int64{ + // 乘客選寵物用車時要當場看到加價(P5)。 + "pet_cleaning_fee_bps": int64(s.petCleaningFeeBps), + } +} + +// PetCleaningFeeBps 寵物車清潔費%(bps)。 +func (s *FeeSettings) PetCleaningFeeBps() int { + s.mu.RLock() + defer s.mu.RUnlock() + return s.petCleaningFeeBps +} + // LostItemFeeBps 遺失物處理費%(bps),供協尋單建立時快照。 func (s *FeeSettings) LostItemFeeBps() int { s.mu.RLock() @@ -71,31 +95,49 @@ func (s *FeeSettings) MonthlyMembershipFeeCents() int64 { return s.monthlyMembershipFeeCents } -// Quote 依實際里程(公尺)計算車資、手續費、司機實得(皆為「分」,但一律落在整數元)。 +// RideQuote 一趟行程的定格計費(皆為「分」,一律落在整數元)。 +type RideQuote struct { + FareCents int64 + CommissionCents int64 + CleaningFeeCents int64 + DriverNetCents int64 +} + +// Quote 依實際里程(公尺)與**乘客指定的車種**計算定格計費。 +// +// fare = max(min_fare, roundNtd(base + round(per_km × 距離公尺 / 1000))) // 車資四捨五入到整數元 +// cleaning_fee = floorNtd(fare × pet_cleaning_fee_bps / 10000) // 僅 requiredVehicleType=='pet';捨去到整數元(利乘客) +// commission = floorNtd(fare × commission_bps / 10000) // **基準只有 fare**,清潔費不計入抽成 +// driver_net = fare − commission + cleaning_fee // 清潔費全額歸司機(清潔成本補償,非營收) // -// fare = max(min_fare, roundNtd(base + round(per_km × 距離公尺 / 1000))) // 車資四捨五入到整數元 -// commission = floorNtd(fare × bps / 10000) // 手續費無條件捨去到整數元 -// driver_net = fare − commission +// requiredVehicleType 取自 `rides.required_vehicle_type`(乘客要什麼車), +// **不可傳司機的 vehicle_type**——乘客沒指定寵物車、卻剛好被派到寵物車司機時不得加收, +// 那位乘客沒有要求寵物服務(O6 拍板 2026-07-16)。 // // 台幣無小數:所有金額都是整數元(分為 100 的倍數),支付/報表不會出現不可支付的小數 // (min_fare 由設定輸入,本身已是整數元)。距離為 0 時 fare 會落到 min_fare,不會算成 0; // 呼叫端(TrackingService.Complete)已對軌跡稀疏/缺失做退路——以 OSRM pickup→dropoff 路線里程 // 作地板(見 billableDistanceM),故傳進來的 distanceM 通常已是「軌跡 vs 路線」的較大者。 -func (s *FeeSettings) Quote(distanceM int) (fareCents, commissionCents, driverNetCents int64) { +func (s *FeeSettings) Quote(distanceM int, requiredVehicleType string) RideQuote { s.mu.RLock() - base, perKm, minFare, bps := s.baseFareCents, s.perKmFareCents, s.minFareCents, s.commissionBps + base, perKm, minFare := s.baseFareCents, s.perKmFareCents, s.minFareCents + bps, cleaningBps := s.commissionBps, s.petCleaningFeeBps s.mu.RUnlock() if distanceM < 0 { distanceM = 0 } - fareCents = roundNtd(base + roundDiv(perKm*int64(distanceM), 1000)) - if fareCents < minFare { - fareCents = minFare + q := RideQuote{} + q.FareCents = roundNtd(base + roundDiv(perKm*int64(distanceM), 1000)) + if q.FareCents < minFare { + q.FareCents = minFare } - commissionCents = floorNtd(fareCents * int64(bps) / 10000) - driverNetCents = fareCents - commissionCents - return + if requiredVehicleType == constants.VehicleTypePet { + q.CleaningFeeCents = floorNtd(q.FareCents * int64(cleaningBps) / 10000) + } + q.CommissionCents = floorNtd(q.FareCents * int64(bps) / 10000) + q.DriverNetCents = q.FareCents - q.CommissionCents + q.CleaningFeeCents + return q } // roundDiv 非負整數四捨五入除法(a >= 0, b > 0)。 @@ -123,7 +165,7 @@ func floorNtd(cents int64) int64 { } // Update 覆寫費率設定(nil 欄位表示不變),先驗證、寫 DB,再更新快取。 -func (s *FeeSettings) Update(baseFareCents, perKmFareCents, minFareCents, commissionBps, monthlyMembershipFeeCents, lostItemFeeBps, updatedBy *int64) error { +func (s *FeeSettings) Update(baseFareCents, perKmFareCents, minFareCents, commissionBps, monthlyMembershipFeeCents, lostItemFeeBps, petCleaningFeeBps, updatedBy *int64) error { s.mu.Lock() defer s.mu.Unlock() @@ -134,6 +176,7 @@ func (s *FeeSettings) Update(baseFareCents, perKmFareCents, minFareCents, commis CommissionBps: s.commissionBps, MonthlyMembershipFeeCents: s.monthlyMembershipFeeCents, LostItemFeeBps: s.lostItemFeeBps, + PetCleaningFeeBps: s.petCleaningFeeBps, UpdatedBy: updatedBy, } if baseFareCents != nil { @@ -154,6 +197,9 @@ func (s *FeeSettings) Update(baseFareCents, perKmFareCents, minFareCents, commis if lostItemFeeBps != nil { next.LostItemFeeBps = int(*lostItemFeeBps) } + if petCleaningFeeBps != nil { + next.PetCleaningFeeBps = int(*petCleaningFeeBps) + } if err := validateFeeSettings(next); err != nil { return err @@ -167,9 +213,15 @@ func (s *FeeSettings) Update(baseFareCents, perKmFareCents, minFareCents, commis s.commissionBps = next.CommissionBps s.monthlyMembershipFeeCents = next.MonthlyMembershipFeeCents s.lostItemFeeBps = next.LostItemFeeBps + s.petCleaningFeeBps = next.PetCleaningFeeBps return nil } +// MaxPetCleaningFeeBps 寵物車清潔費硬上限 30%(O6 拍板 2026-07-16)。 +// 同一上限也寫在 DB CHECK(chk_fleet_settings_pet_cleaning_fee_bps): +// 這裡擋是為了回 400 給後台,DB 擋是最後防線(這是乘客實際被收的錢,寫錯就是超收)。 +const MaxPetCleaningFeeBps = 3000 + func validateFeeSettings(s model.FleetSettings) error { const maxFare = int64(1_000_000) // 單筆金額上限 1 萬元(分) const maxMembership = int64(100_000_000) // 月會費上限 100 萬元(分) @@ -186,6 +238,8 @@ func validateFeeSettings(s model.FleetSettings) error { return ErrInvalidFeeSettings case s.LostItemFeeBps < 0 || s.LostItemFeeBps > 10000: return ErrInvalidFeeSettings + case s.PetCleaningFeeBps < 0 || s.PetCleaningFeeBps > MaxPetCleaningFeeBps: + return ErrInvalidFeeSettings default: return nil } diff --git a/internal/service/fee_settings_cleaning_test.go b/internal/service/fee_settings_cleaning_test.go new file mode 100644 index 0000000..58e3504 --- /dev/null +++ b/internal/service/fee_settings_cleaning_test.go @@ -0,0 +1,124 @@ +package service + +import ( + "testing" + + "line-fleet-dispatch/internal/constants" +) + +// newFeeSettingsWithCleaning 白箱組出含清潔費率的快取。 +func newFeeSettingsWithCleaning(base, perKm, minFare int64, bps, cleaningBps int) *FeeSettings { + return &FeeSettings{ + baseFareCents: base, + perKmFareCents: perKm, + minFareCents: minFare, + commissionBps: bps, + petCleaningFeeBps: cleaningBps, + } +} + +// TestQuote寵物車清潔費 O6 的算式:清潔費依 fare 比例、捨去到整數元,且**不計入抽成**。 +func TestQuote寵物車清潔費(t *testing.T) { + // 起步 85 元、每公里 20 元、手續費 15%、清潔費 20%。 + fs := newFeeSettingsWithCleaning(8500, 2000, 8500, 1500, 2000) + + // 5km → fare = 8500 + 20*5 元 = 18500 + q := fs.Quote(5000, constants.VehicleTypePet) + + if q.FareCents != 18500 { + t.Fatalf("fare 應為 18500,得到 %d", q.FareCents) + } + // 清潔費 = floorNtd(18500 * 2000/10000) = floorNtd(3700) = 3700 + if q.CleaningFeeCents != 3700 { + t.Fatalf("清潔費應為 3700,得到 %d", q.CleaningFeeCents) + } + // 抽成基準**只有 fare**:floorNtd(18500*0.15=2775) = 2700。 + // 若誤把清潔費計入基準,會變成 floorNtd(22200*0.15=3330)=3300。 + if q.CommissionCents != 2700 { + t.Fatalf("手續費基準應只含車資(預期 2700),得到 %d——清潔費不計入抽成", q.CommissionCents) + } + // 清潔費全額歸司機:18500 − 2700 + 3700 = 19500 + if q.DriverNetCents != 19500 { + t.Fatalf("司機實得應為 19500(fare−commission+cleaning),得到 %d", q.DriverNetCents) + } + for label, v := range map[string]int64{ + "fare": q.FareCents, "commission": q.CommissionCents, + "cleaning": q.CleaningFeeCents, "net": q.DriverNetCents, + } { + if v%100 != 0 { + t.Fatalf("%s=%d 不是整數元(應為 100 的倍數)", label, v) + } + } +} + +// TestQuote清潔費只看乘客指定車種 O6 最關鍵的語意:加收依 rides.required_vehicle_type, +// **不是** drivers.vehicle_type。乘客沒指定寵物車、卻剛好被派到寵物車司機時不得加收—— +// 那位乘客沒有要求寵物服務。Quote 只吃乘客指定的車種,司機車種根本傳不進來。 +func TestQuote清潔費只看乘客指定車種(t *testing.T) { + fs := newFeeSettingsWithCleaning(8500, 2000, 8500, 1500, 2000) + + for _, vType := range []string{"", constants.VehicleTypeSedan, constants.VehicleTypeSUV, + constants.VehicleTypeVan7, constants.VehicleTypeAccessible} { + q := fs.Quote(5000, vType) + if q.CleaningFeeCents != 0 { + t.Fatalf("乘客指定 %q 時不該有清潔費,得到 %d", vType, q.CleaningFeeCents) + } + // 沒有清潔費時,回到原本的等式。 + if q.DriverNetCents != q.FareCents-q.CommissionCents { + t.Fatalf("無清潔費時 net 應為 fare−commission,得到 %d", q.DriverNetCents) + } + } +} + +// TestQuote清潔費率為零 後台未設定清潔費(預設 0)時,指定寵物車也不加收。 +func TestQuote清潔費率為零(t *testing.T) { + fs := newFeeSettingsWithCleaning(8500, 2000, 8500, 1500, 0) + q := fs.Quote(5000, constants.VehicleTypePet) + if q.CleaningFeeCents != 0 { + t.Fatalf("費率為 0 時不該加收,得到 %d", q.CleaningFeeCents) + } +} + +// TestQuote清潔費捨去到整數元 台幣無小數:清潔費捨去(利乘客)。 +func TestQuote清潔費捨去到整數元(t *testing.T) { + // fare = 8500;清潔費 = 8500 * 777/10000 = 660.45 分 → floorNtd → 600(NT$6) + fs := newFeeSettingsWithCleaning(8500, 2000, 8500, 1500, 777) + q := fs.Quote(0, constants.VehicleTypePet) + if q.FareCents != 8500 { + t.Fatalf("fare 應為 8500,得到 %d", q.FareCents) + } + if q.CleaningFeeCents != 600 { + t.Fatalf("清潔費應捨去到 600,得到 %d", q.CleaningFeeCents) + } +} + +// TestCustomerJSON白名單 P5:乘客可讀的費率絕不可外洩內部費率。 +func TestCustomerJSON白名單(t *testing.T) { + fs := &FeeSettings{ + baseFareCents: 8500, + perKmFareCents: 2000, + minFareCents: 8500, + commissionBps: 1500, + monthlyMembershipFeeCents: 300000, + lostItemFeeBps: 1000, + petCleaningFeeBps: 2000, + } + got := fs.CustomerJSON() + + if got["pet_cleaning_fee_bps"] != 2000 { + t.Fatalf("乘客應讀得到清潔費率,得到 %v", got) + } + // 白名單的重點:內部費率一個都不能出現。 + for _, leaked := range []string{ + "commission_bps", // 手續費——乘客不該知道平台抽多少 + "monthly_membership_fee_cents", // 月會費——司機與平台之間的事 + "base_fare_cents", "per_km_fare_cents", "min_fare_cents", "lost_item_fee_bps", + } { + if _, ok := got[leaked]; ok { + t.Fatalf("CustomerJSON 外洩了內部費率 %q:%v", leaked, got) + } + } + if len(got) != 1 { + t.Fatalf("CustomerJSON 應只有白名單欄位,得到 %v", got) + } +} diff --git a/internal/service/fee_settings_test.go b/internal/service/fee_settings_test.go index c055bc9..7492c02 100644 --- a/internal/service/fee_settings_test.go +++ b/internal/service/fee_settings_test.go @@ -37,11 +37,16 @@ func TestQuote(t *testing.T) { } for _, tc := range cases { t.Run(tc.name, func(t *testing.T) { - fare, comm, net := fs.Quote(tc.distanceM) + // 不指定車種("")=無清潔費,維持 O6 之前的計費語意。 + q := fs.Quote(tc.distanceM, "") + fare, comm, net := q.FareCents, q.CommissionCents, q.DriverNetCents if fare != tc.wantFare || comm != tc.wantComm || net != tc.wantNet { t.Fatalf("Quote(%d) = (fare=%d, comm=%d, net=%d),預期 (%d, %d, %d)", tc.distanceM, fare, comm, net, tc.wantFare, tc.wantComm, tc.wantNet) } + if q.CleaningFeeCents != 0 { + t.Fatalf("未指定車種不該有清潔費,得到 %d", q.CleaningFeeCents) + } if fare != comm+net { t.Fatalf("fare(%d) 應等於 commission(%d)+net(%d)", fare, comm, net) } @@ -58,12 +63,12 @@ func TestQuote(t *testing.T) { func TestQuoteMinFareFloor(t *testing.T) { // 最低車資高於起步價:距離 0 時 fare 應為 min_fare。 fs := newFeeSettingsForTest(5000, 2000, 12000, 1000, 0) - fare, comm, net := fs.Quote(0) - if fare != 12000 { - t.Fatalf("min_fare floor 失效:fare=%d,預期 12000", fare) + q := fs.Quote(0, "") + if q.FareCents != 12000 { + t.Fatalf("min_fare floor 失效:fare=%d,預期 12000", q.FareCents) } - if comm != 1200 || net != 10800 { - t.Fatalf("commission/net 錯誤:comm=%d net=%d,預期 1200/10800", comm, net) + if q.CommissionCents != 1200 || q.DriverNetCents != 10800 { + t.Fatalf("commission/net 錯誤:comm=%d net=%d,預期 1200/10800", q.CommissionCents, q.DriverNetCents) } } @@ -72,17 +77,25 @@ func TestValidateFeeSettingsRejectsOutOfRange(t *testing.T) { fs := newFeeSettingsForTest(8500, 2000, 8500, 1500, 300000) neg := int64(-1) - if err := fs.Update(&neg, nil, nil, nil, nil, nil, nil); err != ErrInvalidFeeSettings { + if err := fs.Update(&neg, nil, nil, nil, nil, nil, nil, nil); err != ErrInvalidFeeSettings { t.Fatalf("負起步價應被拒,got %v", err) } tooHighBps := int64(10001) - if err := fs.Update(nil, nil, nil, &tooHighBps, nil, nil, nil); err != ErrInvalidFeeSettings { + if err := fs.Update(nil, nil, nil, &tooHighBps, nil, nil, nil, nil); err != ErrInvalidFeeSettings { t.Fatalf("手續費 bps > 10000 應被拒,got %v", err) } - if err := fs.Update(nil, nil, nil, nil, nil, &tooHighBps, nil); err != ErrInvalidFeeSettings { + if err := fs.Update(nil, nil, nil, nil, nil, &tooHighBps, nil, nil); err != ErrInvalidFeeSettings { t.Fatalf("遺失物處理費 bps > 10000 應被拒,got %v", err) } - if err := fs.Update(nil, nil, nil, nil, nil, &neg, nil); err != ErrInvalidFeeSettings { + if err := fs.Update(nil, nil, nil, nil, nil, &neg, nil, nil); err != ErrInvalidFeeSettings { t.Fatalf("負遺失物處理費 bps 應被拒,got %v", err) } + // O6:清潔費上限 30%(3000 bps)——這是乘客實際被收的錢,超過一律拒絕。 + overCap := int64(MaxPetCleaningFeeBps + 1) + if err := fs.Update(nil, nil, nil, nil, nil, nil, &overCap, nil); err != ErrInvalidFeeSettings { + t.Fatalf("清潔費 bps > 3000 應被拒,got %v", err) + } + if err := fs.Update(nil, nil, nil, nil, nil, nil, &neg, nil); err != ErrInvalidFeeSettings { + t.Fatalf("負清潔費 bps 應被拒,got %v", err) + } } diff --git a/internal/service/lost_item_test.go b/internal/service/lost_item_test.go index b184a0d..dce53bb 100644 --- a/internal/service/lost_item_test.go +++ b/internal/service/lost_item_test.go @@ -46,7 +46,7 @@ func TestLostItemFlow(t *testing.T) { t.Fatalf("標記上車失敗:%v", err) } fare, comm, net := int64(10000), int64(1500), int64(8500) - if err := rides.CompleteRide(ride.ID, 3000, &fare, &comm, &net); err != nil { + if err := rides.CompleteRide(ride.ID, 3000, &fare, &comm, &net, nil); err != nil { t.Fatalf("完成行程失敗:%v", err) } @@ -81,7 +81,7 @@ func TestLostItemFlow(t *testing.T) { // 快照制:調高處理費% 後,既有協尋單金額不變 newBps := int64(2000) - if err := fees.Update(nil, nil, nil, nil, nil, &newBps, nil); err != nil { + if err := fees.Update(nil, nil, nil, nil, nil, &newBps, nil, nil); err != nil { t.Fatalf("更新處理費%%失敗:%v", err) } reloaded, err := svc.GetForRide(events.RoleCustomer, owner.ID, ride.ID) diff --git a/internal/service/tracking.go b/internal/service/tracking.go index f3e8b03..315eb82 100644 --- a/internal/service/tracking.go +++ b/internal/service/tracking.go @@ -272,14 +272,18 @@ func (s *TrackingService) Complete(ctx context.Context, rideID, driverID int64) Msg("計費里程改用 OSRM 路線里程(軌跡里程偏低)") } - // 費率快照:完成當下依當前費率算好車資/手續費/實得,定格寫進本筆 ride。 - // 未注入費率設定時(如部分測試)三者留 NULL,不影響完成流程。 - var fareCents, commissionCents, driverNetCents *int64 + // 費率快照:完成當下依當前費率算好車資/手續費/清潔費/實得,定格寫進本筆 ride。 + // 未注入費率設定時(如部分測試)一律留 NULL,不影響完成流程。 + // + // 清潔費依 **ride.RequiredVehicleType**(乘客指定的車種),**不是** driver.VehicleType: + // 乘客沒指定寵物車、卻剛好被派到寵物車司機時不得加收——那位乘客沒有要求寵物服務(O6 拍板)。 + var fareCents, commissionCents, driverNetCents, cleaningFeeCents *int64 if s.fees != nil { - f, c, n := s.fees.Quote(distanceM) - fareCents, commissionCents, driverNetCents = &f, &c, &n + q := s.fees.Quote(distanceM, ride.RequiredVehicleType) + fareCents, commissionCents = &q.FareCents, &q.CommissionCents + driverNetCents, cleaningFeeCents = &q.DriverNetCents, &q.CleaningFeeCents } - if err := s.rides.CompleteRide(rideID, distanceM, fareCents, commissionCents, driverNetCents); err != nil { + if err := s.rides.CompleteRide(rideID, distanceM, fareCents, commissionCents, driverNetCents, cleaningFeeCents); err != nil { return err } // F9-3:重算該 (司機,日) 的預聚合彙總(冪等)。best-effort——rides 仍是真源, @@ -297,6 +301,11 @@ func (s *TrackingService) Complete(ctx context.Context, rideID, driverID int64) if fareCents != nil { completedPayload["fare_amount_cents"] = *fareCents // 供乘客端完成卡顯示車資(E2) } + // 清潔費分項(O6):完成卡不可只給總額,要能拆出「車資 NT$X + 清潔費 NT$Y」。 + // 只在真的有加收時帶(>0)——沒加收卻帶 0 會讓 App 顯示一列「清潔費 NT$0」。 + if cleaningFeeCents != nil && *cleaningFeeCents > 0 { + completedPayload["cleaning_fee_cents"] = *cleaningFeeCents + } s.publish(events.Recipient{Role: events.RoleCustomer, ID: ride.CustomerID}, events.Event{ Type: events.TypeRideCompleted, RideID: rideID, diff --git a/internal/service/tracking_cleaning_fee_test.go b/internal/service/tracking_cleaning_fee_test.go new file mode 100644 index 0000000..c4e664b --- /dev/null +++ b/internal/service/tracking_cleaning_fee_test.go @@ -0,0 +1,158 @@ +package service + +import ( + "context" + "strconv" + "testing" + "time" + + "line-fleet-dispatch/internal/constants" + "line-fleet-dispatch/internal/events" + lineclient "line-fleet-dispatch/internal/line" + "line-fleet-dispatch/internal/model" + "line-fleet-dispatch/internal/repository" +) + +// cents 供失敗訊息顯示金額;直接 %v 印 *int64 會印出指標位址,對除錯毫無幫助。 +func cents(p *int64) string { + if p == nil { + return "nil" + } + return strconv.FormatInt(*p, 10) +} + +// completeFixture 建一趟「已上車」的行程,司機一律開寵物車—— +// 用來分辨清潔費是看乘客指定的車種,還是看司機的車。 +func completeFixture(t *testing.T, prefix, requiredVehicleType string, cleaningBps int) ( + *TrackingService, *repository.RideRepository, *fakePublisher, int64, int64, +) { + t.Helper() + db := newServiceTestDB(t) + redis := newServiceTestRedis(t) + drivers := repository.NewDriverRepository(db) + rides := repository.NewRideRepository(db) + tracks := repository.NewTrackRepository(db) + customers := repository.NewCustomerRepository(db) + fp := &fakePublisher{} + + 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) + } + // 司機開的是寵物車——但這**不該**影響計費。 + if err := drivers.UpdateVehicle(driver.ID, constants.VehicleTypePet, prefix+"-PET"); err != nil { + t.Fatalf("設定車輛失敗:%v", err) + } + + now := time.Now() + ride := &model.Ride{ + CustomerID: cust.ID, + Status: constants.RideStatusRequested, + PickupPoint: model.GeoPoint{Lat: 25.03, Lng: 121.56}, + PickupAddress: "台北車站", + RequiredVehicleType: requiredVehicleType, + RequestedAt: now, + CreatedAt: now, + UpdatedAt: now, + } + if err := rides.Create(ride); err != nil { + t.Fatalf("建立訂單失敗:%v", err) + } + 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) + } + + svc := NewTrackingService(drivers, rides, tracks, redis, lineclient.NewClient(""), nil, 0, 0, fp) + // 起步 85 元、每公里 20 元、最低 85 元、手續費 15%。 + svc.SetFeeSettings(newFeeSettingsWithCleaning(8500, 2000, 8500, 1500, cleaningBps)) + return svc, rides, fp, ride.ID, driver.ID +} + +// TestComplete_指定寵物車落帳清潔費 O6 端到端:完成時定格寫入 cleaning_fee_cents, +// 且 driver_net 含清潔費、commission 不含。 +func TestComplete_指定寵物車落帳清潔費(t *testing.T) { + svc, rides, fp, rideID, driverID := completeFixture(t, "U_clean_pet", constants.VehicleTypePet, 2000) + + if err := svc.Complete(context.Background(), rideID, driverID); err != nil { + t.Fatalf("完成行程失敗:%v", err) + } + + got, err := rides.GetByID(rideID) + if err != nil { + t.Fatalf("重讀訂單失敗:%v", err) + } + // 無軌跡、無 OSRM → 距離 0 → fare 落到 min_fare 8500。 + if got.FareAmountCents == nil || *got.FareAmountCents != 8500 { + t.Fatalf("車資應為 8500,得到 %s", cents(got.FareAmountCents)) + } + // 清潔費 = floorNtd(8500 * 20%) = 1700 + if got.CleaningFeeCents == nil || *got.CleaningFeeCents != 1700 { + t.Fatalf("清潔費應定格為 1700,得到 %s", cents(got.CleaningFeeCents)) + } + // 手續費基準只有車資:floorNtd(8500*15%=1275) = 1200 + if got.CommissionAmountCents == nil || *got.CommissionAmountCents != 1200 { + t.Fatalf("手續費應為 1200(基準不含清潔費),得到 %s", cents(got.CommissionAmountCents)) + } + // 實得 = 8500 − 1200 + 1700 = 9000 + if got.DriverNetAmountCents == nil || *got.DriverNetAmountCents != 9000 { + t.Fatalf("司機實得應為 9000(含清潔費),得到 %s", cents(got.DriverNetAmountCents)) + } + + // 乘客端完成卡要能分項顯示「車資 + 清潔費」,不能只給總額。 + var completed *events.Event + for i := range fp.recv { + if fp.recv[i].Ev.Type == events.TypeRideCompleted && fp.recv[i].Rec.Role == events.RoleCustomer { + ev := fp.recv[i].Ev + completed = &ev + break + } + } + if completed == nil { + t.Fatal("應發出 ride.completed 給乘客") + } + if completed.Payload["fare_amount_cents"] != int64(8500) { + t.Fatalf("payload 車資錯誤:%v", completed.Payload) + } + if completed.Payload["cleaning_fee_cents"] != int64(1700) { + t.Fatalf("payload 應帶清潔費分項:%v", completed.Payload) + } +} + +// TestComplete_寵物車司機載到未指定的乘客不加收 O6 最關鍵的語意: +// 加收依 rides.required_vehicle_type,**不是** drivers.vehicle_type。 +// 這位乘客沒指定寵物車(未指定=不過濾車種),只是剛好被派到寵物車司機——不得加收。 +func TestComplete_寵物車司機載到未指定的乘客不加收(t *testing.T) { + svc, rides, fp, rideID, driverID := completeFixture(t, "U_clean_nonpet", "", 2000) + + if err := svc.Complete(context.Background(), rideID, driverID); err != nil { + t.Fatalf("完成行程失敗:%v", err) + } + + got, err := rides.GetByID(rideID) + if err != nil { + t.Fatalf("重讀訂單失敗:%v", err) + } + if got.CleaningFeeCents == nil || *got.CleaningFeeCents != 0 { + t.Fatalf("乘客沒指定寵物車就不該加收清潔費(司機開什麼車無關),得到 %s", cents(got.CleaningFeeCents)) + } + // 實得回到 fare − commission = 8500 − 1200 + if got.DriverNetAmountCents == nil || *got.DriverNetAmountCents != 7300 { + t.Fatalf("無清潔費時實得應為 7300,得到 %s", cents(got.DriverNetAmountCents)) + } + + // 沒加收就不該帶這個鍵——帶 0 會讓 App 顯示一列「清潔費 NT$0」。 + for i := range fp.recv { + if fp.recv[i].Ev.Type == events.TypeRideCompleted && fp.recv[i].Rec.Role == events.RoleCustomer { + if _, ok := fp.recv[i].Ev.Payload["cleaning_fee_cents"]; ok { + t.Fatalf("未加收時不該帶 cleaning_fee_cents:%v", fp.recv[i].Ev.Payload) + } + } + } +}