feat(invitation): 实现邀请返利系统、专属注册落地页与分成管理
- 数据库与数据模型:新增 migration 000081,支持用户专属邀请码、被邀请人绑定与实名时间戳;新增邀请返利配置表与结算明细表 - 业务与结算逻辑:实现首月 60%、次月 30%、往后 15% 阶梯返利算法;买卖双向独立寻源并根据订单平台利润 50% 单边基准核算;与终态订单结算和钱包可用余额强幂等联动 - 分销站点支持:支持主站与加盟分站独立配置返利比例;跨站交易按照收号端与售卖端独立出资,资金互不侵蚀 - 前端交互与入口: - 新增专属短链注册落地页 /i/:code,自动带入并锁定邀请码,引导实名认证 - 个人中心与移动端新增邀请返利看板(专属码、推广链接、统计面板、好友记录与返利流水明细) - 管理后台新增邀请返利管理(比例配置、邀请关系与返利流水审计) - 验证方式: - 通过 repository_test.go 单元测试(阶梯区间、实名激活、跨站多方分流验证) - 通过 npm run format、npm run check 与 scripts/check.sh 全量门禁校验
This commit is contained in:
@@ -0,0 +1,62 @@
|
||||
package model
|
||||
|
||||
import "time"
|
||||
|
||||
// UserInvitation 用户邀请绑定关系表
|
||||
type UserInvitation struct {
|
||||
ID uint64 `gorm:"primaryKey" json:"id"`
|
||||
InviterID uint64 `gorm:"not null;index:idx_user_invitations_inviter" json:"inviter_id"`
|
||||
InviteeID uint64 `gorm:"not null;uniqueIndex:uk_user_invitations_invitee" json:"invitee_id"`
|
||||
DistributionSiteID uint64 `gorm:"not null;default:0" json:"distribution_site_id"`
|
||||
InviteCode string `gorm:"size:32;not null;default:''" json:"invite_code"`
|
||||
Status string `gorm:"size:32;not null;default:'pending';index:idx_user_invitations_inviter" json:"status"` // pending/active/invalid
|
||||
VerifiedAt *time.Time `json:"verified_at,omitempty"`
|
||||
CreatedAt time.Time `json:"created_at"`
|
||||
UpdatedAt time.Time `json:"updated_at"`
|
||||
}
|
||||
|
||||
func (UserInvitation) TableName() string {
|
||||
return "user_invitations"
|
||||
}
|
||||
|
||||
// InvitationRebateConfig 邀请返利比例配置表(主站或分销站点)
|
||||
type InvitationRebateConfig struct {
|
||||
ID uint64 `gorm:"primaryKey" json:"id"`
|
||||
DistributionSiteID uint64 `gorm:"not null;uniqueIndex:uk_invitation_rebate_configs_site" json:"distribution_site_id"` // 0=主站
|
||||
FirstMonthRate float64 `gorm:"type:decimal(6,4);not null;default:0.6000" json:"first_month_rate"`
|
||||
SecondMonthRate float64 `gorm:"type:decimal(6,4);not null;default:0.3000" json:"second_month_rate"`
|
||||
SubsequentRate float64 `gorm:"type:decimal(6,4);not null;default:0.1500" json:"subsequent_rate"`
|
||||
Enabled bool `gorm:"not null;default:true" json:"enabled"`
|
||||
CreatedAt time.Time `json:"created_at"`
|
||||
UpdatedAt time.Time `json:"updated_at"`
|
||||
}
|
||||
|
||||
func (InvitationRebateConfig) TableName() string {
|
||||
return "invitation_rebate_configs"
|
||||
}
|
||||
|
||||
// InvitationRebateLedger 邀请返利结算记录明细表
|
||||
type InvitationRebateLedger struct {
|
||||
ID uint64 `gorm:"primaryKey" json:"id"`
|
||||
OrderID uint64 `gorm:"not null;uniqueIndex:uk_invitation_rebate_order_role,priority:1" json:"order_id"`
|
||||
OrderNo string `gorm:"size:64;not null" json:"order_no"`
|
||||
DistributionSiteID uint64 `gorm:"not null;default:0;index:idx_invitation_rebate_site" json:"distribution_site_id"`
|
||||
InviterID uint64 `gorm:"not null;index:idx_invitation_rebate_inviter" json:"inviter_id"`
|
||||
InviteeID uint64 `gorm:"not null" json:"invitee_id"`
|
||||
TradeRole string `gorm:"size:16;not null;uniqueIndex:uk_invitation_rebate_order_role,priority:2" json:"trade_role"` // buyer / seller
|
||||
OrderProfitBasisCent int64 `gorm:"not null;default:0" json:"order_profit_basis_cent"`
|
||||
SingleSideBasisCent int64 `gorm:"not null;default:0" json:"single_side_basis_cent"`
|
||||
RateApplied float64 `gorm:"type:decimal(6,4);not null;default:0" json:"rate_applied"`
|
||||
DaysSinceVerified int `gorm:"not null;default:0" json:"days_since_verified"`
|
||||
CycleStage string `gorm:"size:32;not null;default:''" json:"cycle_stage"` // first_month / second_month / subsequent
|
||||
RebateAmountCent int64 `gorm:"not null;default:0" json:"rebate_amount_cent"`
|
||||
WalletLedgerNo string `gorm:"size:64;not null;default:''" json:"wallet_ledger_no"`
|
||||
Status string `gorm:"size:32;not null;default:'settled'" json:"status"` // settled / cancelled
|
||||
SettledAt time.Time `gorm:"index:idx_invitation_rebate_inviter;index:idx_invitation_rebate_site" json:"settled_at"`
|
||||
CreatedAt time.Time `json:"created_at"`
|
||||
UpdatedAt time.Time `json:"updated_at"`
|
||||
}
|
||||
|
||||
func (InvitationRebateLedger) TableName() string {
|
||||
return "invitation_rebate_ledgers"
|
||||
}
|
||||
@@ -19,10 +19,13 @@ type User struct {
|
||||
// 默认值对齐迁移 000052 的 users.token_version DEFAULT 0。
|
||||
TokenVersion int64 `gorm:"not null;default:0" json:"-"`
|
||||
// 注册归因:注册时由前端携带的推广短码。
|
||||
RegisterTrackCode string `gorm:"size:64;index:idx_users_register_track_code" json:"register_track_code,omitempty"`
|
||||
LastLoginAt *time.Time `json:"last_login_at"`
|
||||
CreatedAt time.Time `json:"created_at"`
|
||||
UpdatedAt time.Time `json:"updated_at"`
|
||||
RegisterTrackCode string `gorm:"size:64;index:idx_users_register_track_code" json:"register_track_code,omitempty"`
|
||||
InviteCode *string `gorm:"size:32;uniqueIndex:uk_users_invite_code" json:"invite_code,omitempty"`
|
||||
InvitedByID uint64 `gorm:"not null;default:0;index:idx_users_invited_by_id" json:"invited_by_id,omitempty"`
|
||||
InviteVerifiedAt *time.Time `json:"invite_verified_at,omitempty"`
|
||||
LastLoginAt *time.Time `json:"last_login_at"`
|
||||
CreatedAt time.Time `json:"created_at"`
|
||||
UpdatedAt time.Time `json:"updated_at"`
|
||||
}
|
||||
|
||||
func (User) TableName() string {
|
||||
|
||||
Reference in New Issue
Block a user