diff --git a/internal/handler/driver.go b/internal/handler/driver.go index f0bf540..343a309 100644 --- a/internal/handler/driver.go +++ b/internal/handler/driver.go @@ -140,17 +140,32 @@ func (h *DriverHandler) Earnings(c *gin.Context) { c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) return } - // 會費以 membership_invoices 帳本快照為單一真源(repo 讀出),不再用即時費率—— - // 未產生帳單者為 0;應付總公司 = 手續費 + 帳本會費。與月報表 F6 同源、不會分歧。 - c.JSON(http.StatusOK, gin.H{ - "month": month, - "trip_count": e.TripCount, - "total_revenue_cents": e.TotalRevenueCents, - "total_commission_cents": e.TotalCommissionCents, - "driver_net_cents": e.DriverNetCents, - "membership_fee_cents": e.MembershipFeeCents, - "owed_to_hq_cents": e.TotalCommissionCents + e.MembershipFeeCents, - }) + c.JSON(http.StatusOK, driverEarningsJSON(month, e)) +} + +// driverEarningsJSON 組裝司機收入回應(F7)。 +// +// 抽成純函式是為了讓「回應含哪些欄位」可被單元測試釘住——這支手動逐欄組 map, +// repo 的 struct 新增欄位時**不會**自動出現在回應裡(O6 的清潔費分項就這樣漏過一次, +// 由 live E2E 才抓到)。 +// +// 會費以 membership_invoices 帳本快照為單一真源(repo 讀出),不再用即時費率—— +// 未產生帳單者為 0;應付總公司 = 手續費 + 帳本會費,**不受清潔費影響**。與月報表 F6 同源。 +// +// total_cleaning_fee_cents(O6)**不可省略**:driver_net 已含清潔費,少了這個分項, +// 司機收入頁的「營業額 − 手續費」就對不上實得(差額正是清潔費,司機會看到憑空多出一截)。 +// 正確等式:**營業額 − 手續費 + 清潔費 = 實得**。 +func driverEarningsJSON(month string, e repository.DriverEarnings) gin.H { + return gin.H{ + "month": month, + "trip_count": e.TripCount, + "total_revenue_cents": e.TotalRevenueCents, + "total_commission_cents": e.TotalCommissionCents, + "total_cleaning_fee_cents": e.TotalCleaningFeeCents, + "driver_net_cents": e.DriverNetCents, + "membership_fee_cents": e.MembershipFeeCents, + "owed_to_hq_cents": e.TotalCommissionCents + e.MembershipFeeCents, + } } // Online POST /api/driver/online — 顯式上線(設為待命,重新進入派單池) diff --git a/internal/handler/driver_earnings_json_test.go b/internal/handler/driver_earnings_json_test.go new file mode 100644 index 0000000..4ddaa54 --- /dev/null +++ b/internal/handler/driver_earnings_json_test.go @@ -0,0 +1,58 @@ +package handler + +import ( + "testing" + + "line-fleet-dispatch/internal/repository" +) + +// TestDriverEarningsJSON 釘住司機收入回應的欄位(F7/O6)。 +// +// 這支 handler 手動逐欄組 map——repo 的 struct 新增欄位時**不會**自動出現在回應裡。 +// O6 的清潔費分項就這樣漏過一次:repository 層的 SQL 與 struct 都加了、整合測試也綠, +// 但 API 回應少了 total_cleaning_fee_cents,直到 live E2E 才抓到。 +func TestDriverEarningsJSON(t *testing.T) { + // 一趟指定寵物車的行程:車資 215、手續費 32(基準只有車資)、清潔費 43、實得 226。 + e := repository.DriverEarnings{ + TripCount: 1, + TotalRevenueCents: 21500, + TotalCommissionCents: 3200, + TotalCleaningFeeCents: 4300, + DriverNetCents: 22600, + MembershipFeeCents: 300000, + } + got := driverEarningsJSON("2026-07", e) + + t.Run("清潔費分項不可缺", func(t *testing.T) { + v, ok := got["total_cleaning_fee_cents"] + if !ok { + t.Fatal("回應必須含 total_cleaning_fee_cents,否則司機收入頁的等式對不上") + } + if v != int64(4300) { + t.Fatalf("清潔費分項錯誤:%v", v) + } + }) + + t.Run("等式成立:營業額 − 手續費 + 清潔費 = 實得", func(t *testing.T) { + rev := got["total_revenue_cents"].(int64) + comm := got["total_commission_cents"].(int64) + clean := got["total_cleaning_fee_cents"].(int64) + net := got["driver_net_cents"].(int64) + if rev-comm+clean != net { + t.Fatalf("等式失敗:%d − %d + %d = %d,但實得為 %d", rev, comm, clean, rev-comm+clean, net) + } + }) + + t.Run("應付總公司不受清潔費影響", func(t *testing.T) { + // =手續費 + 月會費;清潔費全額歸司機,不進這條。 + if got["owed_to_hq_cents"] != int64(3200+300000) { + t.Fatalf("應付總公司錯誤:%v", got["owed_to_hq_cents"]) + } + }) + + t.Run("營業額不含清潔費", func(t *testing.T) { + if got["total_revenue_cents"] != int64(21500) { + t.Fatalf("營業額不該含清潔費:%v", got["total_revenue_cents"]) + } + }) +}