fix(invitation): 线下提号接入邀请返利并补发历史漏发,返利比例文案改读配置

- 线下提号(admin_pickups)不走订单结账流程,此前完全不发邀请返利;现于 Complete() 内按号主利润对半基数发放卖家侧返利
- 迁移 000086:invitation_rebate_ledgers 增加 source 列,唯一键调整为 (source, order_id, trade_role),支持提号来源且保持幂等
- 新增 cmd/rebate-backfill 幂等补发脚本:默认预演,加 -apply 才写库
- 返利阶段文案不再写死 60%/30%/15%,改为按本次实际生效比例生成(钱包流水备注同步修正)
- 前台邀请页阶段标签/横幅/空态文案、移动端个人中心入口文案均改读接口配置,并修掉合法 0% 比例被 || 覆盖成 60% 的问题
- 新增单测:提号返利发放与幂等、cycleLabel 跟随后台配置
This commit is contained in:
yml2213
2026-10-13 15:12:54 +08:00
parent 0d6a7786a4
commit ead58417e0
12 changed files with 658 additions and 22 deletions
@@ -289,3 +289,141 @@ func TestCrossSiteDistributionRebate(t *testing.T) {
t.Fatalf("卖家端跨站返利错误: siteID=%d, amount=%d", sellerLedger.DistributionSiteID, sellerLedger.RebateAmountCent)
}
}
// cycleLabel 的比例必须来自实际生效配置,改配置后文案要跟着变,
// 否则钱包流水备注会与后台比例不一致(历史缺陷)。
func TestCycleLabelFollowsConfiguredRate(t *testing.T) {
cases := []struct {
cycle string
rate float64
want string
}{
{CycleFirstMonth, 0.60, "首月奖励 60%"},
{CycleFirstMonth, 0.50, "首月奖励 50%"},
{CycleFirstMonth, 0.80, "首月奖励 80%"},
{CycleSecondMonth, 0.30, "次月奖励 30%"},
{CycleSecondMonth, 0.25, "次月奖励 25%"},
{CycleSubsequent, 0.15, "长期奖励 15%"},
{CycleSubsequent, 0.125, "长期奖励 12.5%"},
{CycleSubsequent, 0, "长期奖励 0%"},
}
for _, c := range cases {
if got := cycleLabel(c.cycle, c.rate); got != c.want {
t.Fatalf("cycleLabel(%s, %v) = %q, want %q", c.cycle, c.rate, got, c.want)
}
}
}
// 线下提号返利与租赁订单卖家侧共用同一个入口 AwardSellerSideRebateTx:
// 这里验证金额计算正确,且同一来源单据重复调用不会重复入账
// (唯一键 source+order_id+trade_role 保证幂等,补发脚本重跑安全)。
func TestAwardSellerSideRebateTxAwardsOncePerSource(t *testing.T) {
db := setupTestDB(t)
inviterCode := "inv9001"
inviter := model.User{
Phone: "13800009001",
Nickname: "提号邀请人",
RealnameStatus: "verified",
Status: "active",
InviteCode: &inviterCode,
}
if err := db.Create(&inviter).Error; err != nil {
t.Fatalf("创建邀请人失败: %v", err)
}
seller := model.User{
Phone: "13800009002",
Nickname: "提号号主",
RealnameStatus: "verified",
Status: "active",
}
if err := db.Create(&seller).Error; err != nil {
t.Fatalf("创建号主失败: %v", err)
}
verifiedAt := time.Now().AddDate(0, 0, -2) // 距结算 2 天 => 首月 60%
if err := db.Create(&model.UserInvitation{
InviterID: inviter.ID,
InviteeID: seller.ID,
InviteCode: inviterCode,
Status: StatusActive,
VerifiedAt: &verifiedAt,
}).Error; err != nil {
t.Fatalf("创建邀请关系失败: %v", err)
}
input := SellerSideRebateInput{
Source: RebateSourcePickup,
SourceID: 900001,
SourceNo: "PK-REBATE-TEST-1",
SellerID: seller.ID,
GrossBasisCent: 10000,
BasisCent: 5000,
SiteID: 0,
SettledAt: time.Now(),
RemarkPrefix: "邀请卖家提号返利",
}
apply := func() int64 {
t.Helper()
var amount int64
if err := db.Transaction(func(tx *gorm.DB) error {
got, err := AwardSellerSideRebateTx(tx, input)
amount = got
return err
}); err != nil {
t.Fatalf("发放提号返利失败: %v", err)
}
return amount
}
// 单边基数 5000,首月 60% => 3000 分
if got := apply(); got != 3000 {
t.Fatalf("首次发放金额 = %d, want 3000", got)
}
var rebate model.InvitationRebateLedger
if err := db.Where("source = ? AND order_id = ? AND trade_role = 'seller'", RebateSourcePickup, input.SourceID).
First(&rebate).Error; err != nil {
t.Fatalf("未找到提号返利流水: %v", err)
}
if rebate.InviterID != inviter.ID || rebate.InviteeID != seller.ID || rebate.OrderNo != input.SourceNo {
t.Fatalf("返利流水字段错误: %+v", rebate)
}
if rebate.CycleStage != CycleFirstMonth || rebate.DaysSinceVerified != 2 {
t.Fatalf("返利档位错误: cycle=%s, days=%d", rebate.CycleStage, rebate.DaysSinceVerified)
}
// 同来源同角色重复调用必须跳过,不重复写流水、不重复入账
if got := apply(); got != 0 {
t.Fatalf("重复调用应幂等跳过, got %d", got)
}
var ledgerCount int64
if err := db.Model(&model.InvitationRebateLedger{}).
Where("source = ? AND order_id = ?", RebateSourcePickup, input.SourceID).
Count(&ledgerCount).Error; err != nil {
t.Fatalf("统计返利流水失败: %v", err)
}
if ledgerCount != 1 {
t.Fatalf("返利流水条数 = %d, want 1", ledgerCount)
}
var walletCount int64
if err := db.Model(&model.WalletLedger{}).
Where("biz_type = ? AND biz_no = ?", "invite_rebate", input.SourceNo).
Count(&walletCount).Error; err != nil {
t.Fatalf("统计钱包流水失败: %v", err)
}
if walletCount != 1 {
t.Fatalf("钱包流水条数 = %d, want 1", walletCount)
}
var account model.WalletAccount
if err := db.Where("user_id = ? AND distribution_site_id = 0", inviter.ID).First(&account).Error; err != nil {
t.Fatalf("未找到邀请人钱包账户: %v", err)
}
if account.AvailableBalanceCent != 3000 {
t.Fatalf("邀请人可用余额 = %d, want 3000", account.AvailableBalanceCent)
}
}