From 9805ba6a91349278d1d4a123470c233ed47d8775 Mon Sep 17 00:00:00 2001 From: awei Date: Fri, 17 Jul 2026 14:51:31 +0800 Subject: [PATCH] =?UTF-8?q?fix(O6):=20=E5=8F=B8=E6=A9=9F=E6=94=B6=E5=85=A5?= =?UTF-8?q?=20API=20=E6=BC=8F=E5=9B=9E=20total=5Fcleaning=5Ffee=5Fcents?= =?UTF-8?q?=EF=BC=88live=20E2E=20=E6=8A=93=E5=88=B0=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit GET /api/driver/earnings 手動逐欄組 gin.H,O6 加在 repository.DriverEarnings 上的 清潔費分項沒被列進去 → 司機收入頁會看到「營業額 21500 − 手續費 3200 = 18300」, 但實得 22600,憑空多出 4300(正是清潔費)。 為什麼測試沒抓到:O6 的整合測試只覆蓋到 repository 層(SQL 與 struct 都對), handler 的 JSON 組裝沒有任何測試。admin 月報表直接回 struct(有 json tag)故不受影響, 只有這支手動組 map 的漏了。 修正:補上欄位,並把組裝抽成純函式 driverEarningsJSON 讓它可被單元測試釘住。 新增 TestDriverEarningsJSON:清潔費分項不可缺、等式「營業額 − 手續費 + 清潔費 = 實得」 成立、應付總公司不受清潔費影響、營業額不含清潔費。 反向驗證:拿掉該欄位 → 測試 FAIL。 live E2E 驗證(docker compose 全服務 + 真 OSRM):修復後回應含 total_cleaning_fee_cents =4300,等式 21500−3200+4300=22600 成立。 Co-Authored-By: Claude Opus 4.8 --- internal/handler/driver.go | 37 ++++++++---- internal/handler/driver_earnings_json_test.go | 58 +++++++++++++++++++ 2 files changed, 84 insertions(+), 11 deletions(-) create mode 100644 internal/handler/driver_earnings_json_test.go 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"]) + } + }) +}