package settle // bill_test.go S2-D4:出账引擎单测——**阶梯结算单测(S2 显式验收项)**: // 恰好落档/跨档/无阶梯回退时间线价;时间线月中调价按日分档;上家三口径 // (billing_mode);生成幂等重算覆盖/已结拒;结账状态机+SettleRecord;导出。 // D4-0 口径(Q1~Q6 用户批准方案默认)见 price.go 头注。 import ( "bytes" "context" "testing" "time" "gorm.io/gorm" "go-sms/internal/model/entity" errs "go-sms/internal/pkg/errors" ) // newBillDB 内存库 + 出账全家桶表。 // settle_upstream 手动建表:idx_period 与 settle_customer 同名,glebarez // 索引名全库唯一不查重(同 recharge_test 方言坑);无索引版读写零影响。 func newBillDB(t *testing.T) *gorm.DB { t.Helper() db := newConsumeDB(t) if err := db.AutoMigrate( &entity.AccountPrice{}, &entity.ChannelPrice{}, &entity.ChannelChannel{}, &entity.SettleLadder{}, &entity.SettleCustomer{}, &entity.SettleRecord{}, ); err != nil { t.Fatal(err) } if err := db.Exec(`CREATE TABLE IF NOT EXISTS settle_upstream ( id INTEGER PRIMARY KEY AUTOINCREMENT, settle_no TEXT, upstream_id INTEGER NOT NULL, period TEXT, success_count INTEGER DEFAULT 0, amount REAL DEFAULT 0, status INTEGER DEFAULT 0, created_at DATETIME DEFAULT CURRENT_TIMESTAMP, UNIQUE(upstream_id, period))`).Error; err != nil { t.Fatal(err) } return db } // seedCustomerData 账号1:价 11-01 起 0.10、11-15 起 0.20(月中调价); // 消耗 11-10 succ=100(fee 忽略)、11-20 succ=50 → 金额=100*0.10+50*0.20=20。 func seedCustomerData(t *testing.T, db *gorm.DB) { t.Helper() seedTime := func(day string) time.Time { d, _ := time.ParseInLocation("2006-01-02", day, time.Local) return d } if err := db.Create(&[]entity.AccountPrice{ {AccountID: 1, Business: "sms", Price: 0.10, EffectiveAt: seedTime("2026-11-01")}, {AccountID: 1, Business: "sms", Price: 0.20, EffectiveAt: seedTime("2026-11-15")}, }).Error; err != nil { t.Fatal(err) } if err := db.Create(&[]entity.BillingConsumeLog{ {AccountID: 1, Business: "sms", StatDate: seedTime("2026-11-10"), SuccessCount: 100}, {AccountID: 1, Business: "sms", StatDate: seedTime("2026-11-20"), SuccessCount: 50}, }).Error; err != nil { t.Fatal(err) } } // TestBill_Customer_Generate 基础出账:时间线月中调价按日分档。 func TestBill_Customer_Generate(t *testing.T) { db := newBillDB(t) seedCustomerData(t, db) svc := NewService(db) ctx := context.Background() res, err := svc.GenerateCustomerBills(ctx, "2026-11") if err != nil { t.Fatal(err) } if res.Generated != 1 || res.Recalculated != 0 { t.Fatalf("首生成错: %+v", res) } var bill entity.SettleCustomer db.First(&bill) if bill.SettleNo != "SC202611-1" || bill.Period != "2026-11" || bill.Status != 0 { t.Fatalf("单头错: %+v", bill) } if bill.SuccessCount != 150 || !feq(bill.Amount, 20.0) { t.Fatalf("金额错: succ=%d amount=%v(期望 150/20.0=100*0.10+50*0.20)", bill.SuccessCount, bill.Amount) } // 幂等重算:覆盖更新不新增行。 res, err = svc.GenerateCustomerBills(ctx, "2026-11") if err != nil || res.Generated != 0 || res.Recalculated != 1 { t.Fatalf("重算错: %+v err=%v", res, err) } var n int64 db.Model(&entity.SettleCustomer{}).Count(&n) if n != 1 { t.Fatalf("行数=%d 期望 1", n) } // 状态机:0→1→2+SettleRecord;终态拒重算;非法迁移 039。 if err := svc.ConfirmCustomerBill(ctx, bill.ID); err != nil { t.Fatal(err) } rec, err := svc.SettleCustomerBill(ctx, bill.ID, "bank", "ops", "test") if err != nil { t.Fatal(err) } if rec.Direction != 1 || rec.SettleNo != "SC202611-1" || !feq(rec.Amount, 20.0) { t.Fatalf("SettleRecord 错: %+v", rec) } if res, _ = svc.GenerateCustomerBills(ctx, "2026-11"); res.Skipped != 1 { t.Fatalf("已结应 skipped=1: %+v", res) } if err := svc.ConfirmCustomerBill(ctx, bill.ID); !isErr(err, errs.OrderStatusConflict) { t.Fatalf("已结 confirm 应 ISC:039: %v", err) } if _, err := svc.SettleCustomerBill(ctx, bill.ID, "", "", ""); !isErr(err, errs.OrderStatusConflict) { t.Fatalf("重复 settle 应 ISC:039: %v", err) } var recs int64 db.Model(&entity.SettleRecord{}).Count(&recs) if recs != 1 { t.Fatalf("SettleRecord 行数=%d 期望 1(终态幂等)", recs) } } // TestBill_Customer_Ladder **阶梯结算单测(S2 显式验收项)**: // 档位 [0→0.05, 1000→0.04];恰好落档/跨档/无阶梯回退;整月覆写口径(Q2)。 func TestBill_Customer_Ladder(t *testing.T) { db := newBillDB(t) seedCustomerData(t, db) // 月量 150;时间线金额 20.0 if err := db.Create(&[]entity.SettleLadder{ {OwnerType: "account", OwnerID: 1, TierFrom: 0, Price: 0.05}, {OwnerType: "account", OwnerID: 1, TierFrom: 1000, Price: 0.04}, }).Error; err != nil { t.Fatal(err) } svc := NewService(db) ctx := context.Background() // 月量 150 → 首档 0.05 → 整月覆写 150*0.05=7.5(非时间线 20.0)。 if _, err := svc.GenerateCustomerBills(ctx, "2026-11"); err != nil { t.Fatal(err) } var bill entity.SettleCustomer db.First(&bill) if !feq(bill.Amount, 7.5) { t.Fatalf("首档覆写错: amount=%v 期望 7.5", bill.Amount) } // 恰好落档:月量 1000 → 二档 0.04 → 40.0(边界含下限)。 d20, _ := time.ParseInLocation("2006-01-02", "2026-11-20", time.Local) db.Model(&entity.BillingConsumeLog{}).Where("stat_date = ?", d20). Update("success_count", 900) // 100+900=1000 if _, err := svc.GenerateCustomerBills(ctx, "2026-11"); err != nil { t.Fatal(err) } db.First(&bill) if bill.SuccessCount != 1000 || !feq(bill.Amount, 40.0) { t.Fatalf("恰好落档错: succ=%d amount=%v 期望 1000/40.0", bill.SuccessCount, bill.Amount) } // 删除阶梯 → 回退时间线价(Q2:无阶梯回退)。 db.Where("1=1").Delete(&entity.SettleLadder{}) if _, err := svc.GenerateCustomerBills(ctx, "2026-11"); err != nil { t.Fatal(err) } db.First(&bill) expect := 100*0.10 + 900*0.20 // 11-10 价 0.10 + 11-20 价 0.20 if !feq(bill.Amount, expect) { t.Fatalf("无阶梯回退错: amount=%v 期望 %v", bill.Amount, expect) } } // TestBill_Upstream 上家三口径(Q3)+归并(Q4)+结账(direction=2)。 func TestBill_Upstream(t *testing.T) { db := newBillDB(t) seedTime := func(day string) time.Time { d, _ := time.ParseInLocation("2006-01-02", day, time.Local) return d } // 上家 10:通道1(success)+通道2(all);上家 20:通道3(success_unknown)。 if err := db.Create(&[]entity.ChannelChannel{ {Model: entity.Model{ID: 1}, Name: "c1", Code: "C1", UpstreamID: 10, BillingMode: "success"}, {Model: entity.Model{ID: 2}, Name: "c2", Code: "C2", UpstreamID: 10, BillingMode: "all"}, {Model: entity.Model{ID: 3}, Name: "c3", Code: "C3", UpstreamID: 20, BillingMode: "success_unknown"}, {Model: entity.Model{ID: 4}, Name: "c4", Code: "C4", UpstreamID: 0}, // 未绑上家 }).Error; err != nil { t.Fatal(err) } if err := db.Create(&[]entity.ChannelPrice{ {ChannelID: 1, Price: 0.03, EffectiveAt: seedTime("2026-11-01")}, {ChannelID: 2, Price: 0.02, EffectiveAt: seedTime("2026-11-01")}, {ChannelID: 3, Price: 0.05, EffectiveAt: seedTime("2026-11-01")}, }).Error; err != nil { t.Fatal(err) } if err := db.Create(&[]entity.StatsChannelDaily{ {ChannelID: 1, StatDate: seedTime("2026-11-10"), SubmitCount: 100, SuccessCount: 80, FailCount: 10, UnknownCount: 10}, {ChannelID: 2, StatDate: seedTime("2026-11-10"), SubmitCount: 100, SuccessCount: 80, FailCount: 10, UnknownCount: 10}, {ChannelID: 3, StatDate: seedTime("2026-11-10"), SubmitCount: 100, SuccessCount: 80, FailCount: 10, UnknownCount: 10}, {ChannelID: 4, StatDate: seedTime("2026-11-10"), SubmitCount: 50, SuccessCount: 50}, }).Error; err != nil { t.Fatal(err) } svc := NewService(db) ctx := context.Background() res, err := svc.GenerateUpstreamBills(ctx, "2026-11") if err != nil || res.Generated != 2 { t.Fatalf("上家生成错: %+v err=%v(期望 2:uid10/20;通道4未绑不入)", res, err) } var b10, b20 entity.SettleUpstream db.Where("upstream_id = ?", int64(10)).First(&b10) db.Where("upstream_id = ?", int64(20)).First(&b20) // 上家10:通道1 success=80×0.03=2.4 + 通道2 all=100×0.02=2.0 → 4.4/计费180。 if b10.SuccessCount != 180 || !feq(b10.Amount, 4.4) { t.Fatalf("上家10 三口径错: count=%d amount=%v 期望 180/4.4", b10.SuccessCount, b10.Amount) } // 上家20:success_unknown=80+10=90×0.05=4.5。 if b20.SuccessCount != 90 || !feq(b20.Amount, 4.5) { t.Fatalf("上家20 口径错: count=%d amount=%v 期望 90/4.5", b20.SuccessCount, b20.Amount) } // 结账 direction=2 + 金额快照(状态机 0→1→2)。 if err := svc.ConfirmUpstreamBill(ctx, b10.ID); err != nil { t.Fatal(err) } rec, err := svc.SettleUpstreamBill(ctx, b10.ID, "bank", "ops", "up") if err != nil { t.Fatal(err) } if rec.Direction != 2 || rec.SettleNo != b10.SettleNo || !feq(rec.Amount, 4.4) { t.Fatalf("上家 SettleRecord 错: %+v", rec) } // 导出:字节流非空(XLSX 魔数 PK)。 data, name, err := svc.ExportUpstreamBillXLSX(ctx, b20.ID) if err != nil || len(data) < 100 || name != b20.SettleNo+".xlsx" { t.Fatalf("上家导出错: len=%d name=%s err=%v", len(data), name, err) } if !bytes.HasPrefix(data, []byte("PK")) { t.Fatalf("XLSX 魔数错: % x", data[:2]) } } // TestBill_CustomerDetailAndExport 按天明细+导出。 func TestBill_CustomerDetailAndExport(t *testing.T) { db := newBillDB(t) seedCustomerData(t, db) svc := NewService(db) ctx := context.Background() if _, err := svc.GenerateCustomerBills(ctx, "2026-11"); err != nil { t.Fatal(err) } bill, err := svc.GetCustomerBill(ctx, 1) if err != nil { t.Fatal(err) } days, err := svc.CustomerBillDays(ctx, bill) if err != nil || len(days) != 2 { t.Fatalf("按天明细错: %v err=%v", days, err) } if days[0].Day != "2026-11-10" || days[0].SuccessCount != 100 || !feq(days[0].Amount, 10.0) { t.Fatalf("明细行1错: %+v", days[0]) } if days[1].SuccessCount != 50 || !feq(days[1].Amount, 10.0) { t.Fatalf("明细行2错: %+v(50×0.20)", days[1]) } data, name, err := svc.ExportCustomerBillXLSX(ctx, bill.ID) if err != nil || !bytes.HasPrefix(data, []byte("PK")) || name != "SC202611-1.xlsx" { t.Fatalf("导出错: len=%d name=%s err=%v", len(data), name, err) } } // TestLadder_CRUD 档位 CRUD+重复档拒绝。 func TestLadder_CRUD(t *testing.T) { db := newBillDB(t) svc := NewService(db) ctx := context.Background() if err := svc.CreateLadder(ctx, &entity.SettleLadder{OwnerType: "account", OwnerID: 1, TierFrom: 0, Price: 0.05}); err != nil { t.Fatal(err) } // 同 owner 同 tier_from → 400。 if err := svc.CreateLadder(ctx, &entity.SettleLadder{OwnerType: "account", OwnerID: 1, TierFrom: 0, Price: 0.04}); !isErr(err, errs.InvalidParam) { t.Fatalf("重复档应 400: %v", err) } // 非法 owner_type。 if err := svc.CreateLadder(ctx, &entity.SettleLadder{OwnerType: "xx", OwnerID: 1, TierFrom: 0, Price: 1}); !isErr(err, errs.InvalidParam) { t.Fatalf("非法 owner 应 400: %v", err) } // 更新价格 + 删除。 p := 0.045 if err := svc.UpdateLadder(ctx, 1, nil, &p); err != nil { t.Fatal(err) } list, err := svc.ListLadders(ctx, "account", 1) if err != nil || len(list) != 1 || !feq(list[0].Price, 0.045) { t.Fatalf("档位列表错: %+v err=%v", list, err) } if err := svc.DeleteLadder(ctx, 1); err != nil { t.Fatal(err) } if err := svc.DeleteLadder(ctx, 1); !isErr(err, errs.NotFound) { t.Fatalf("重复删应 404: %v", err) } }