yml2213
984433f866
- 数据库与数据模型：新增 migration 000081，支持用户专属邀请码、被邀请人绑定与实名时间戳；新增邀请返利配置表与结算明细表 - 业务与结算逻辑：实现首月 60%、次月 30%、往后 15% 阶梯返利算法；买卖双向独立寻源并根据订单平台利润 50% 单边基准核算；与终态订单结算和钱包可用余额强幂等联动 - 分销站点支持：支持主站与加盟分站独立配置返利比例；跨站交易按照收号端与售卖端独立出资，资金互不侵蚀 - 前端交互与入口： - 新增专属短链注册落地页 /i/:code，自动带入并锁定邀请码，引导实名认证 - 个人中心与移动端新增邀请返利看板（专属码、推广链接、统计面板、好友记录与返利流水明细） - 管理后台新增邀请返利管理（比例配置、邀请关系与返利流水审计） - 验证方式： - 通过 repository_test.go 单元测试（阶梯区间、实名激活、跨站多方分流验证） - 通过 npm run format、npm run check 与 scripts/check.sh 全量门禁校验
63 lines
3.7 KiB
Go
63 lines
3.7 KiB
Go
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"
|
|
}
|