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:
@@ -24,6 +24,7 @@ import (
|
||||
"hfb_sys/backend/internal/modules/dispute"
|
||||
"hfb_sys/backend/internal/modules/distribution"
|
||||
filemodule "hfb_sys/backend/internal/modules/file"
|
||||
"hfb_sys/backend/internal/modules/invitation"
|
||||
"hfb_sys/backend/internal/modules/listing"
|
||||
"hfb_sys/backend/internal/modules/mohong"
|
||||
"hfb_sys/backend/internal/modules/notification"
|
||||
@@ -239,6 +240,18 @@ func New(cfg config.Config, deps Dependencies, logger *zap.Logger) *gin.Engine {
|
||||
withdrawalService := withdrawal.NewService(withdrawalRepo)
|
||||
withdrawalHandler := withdrawal.NewHandler(withdrawalService)
|
||||
|
||||
var invitationRepo *invitation.Repository
|
||||
var invitationService *invitation.Service
|
||||
var invitationHandler *invitation.Handler
|
||||
if deps.DB != nil {
|
||||
invitationRepo = invitation.NewRepository(deps.DB)
|
||||
invitationService = invitation.NewService(invitationRepo)
|
||||
invitationHandler = invitation.NewHandler(invitationService)
|
||||
if authHandler != nil {
|
||||
authHandler.SetInvitationBinder(invitationService)
|
||||
}
|
||||
}
|
||||
|
||||
// 支付配置管理
|
||||
var paymentConfigRepo *paymentconfig.Repository
|
||||
var paymentConfigService *paymentconfig.Service
|
||||
@@ -477,6 +490,18 @@ func New(cfg config.Config, deps Dependencies, logger *zap.Logger) *gin.Engine {
|
||||
api.PUT("/me", requireAuth, userHandler.UpdateMe)
|
||||
api.PUT("/password", requireAuth, authHandler.SetPassword)
|
||||
|
||||
if invitationHandler != nil {
|
||||
api.GET("/invitations/code-info", invitationHandler.GetInviteInfo)
|
||||
api.GET("/invitations/code-info/:code", invitationHandler.GetInviteInfo)
|
||||
|
||||
userInvites := api.Group("/user/invitations", requireAuth)
|
||||
{
|
||||
userInvites.GET("/summary", invitationHandler.UserSummary)
|
||||
userInvites.GET("/records", invitationHandler.ListMyInvitedUsers)
|
||||
userInvites.GET("/rebates", invitationHandler.ListMyRebates)
|
||||
}
|
||||
}
|
||||
|
||||
listingRoutes := api.Group("/listings")
|
||||
{
|
||||
listingRoutes.GET("", listingHandler.ListPublic)
|
||||
@@ -687,6 +712,10 @@ func New(cfg config.Config, deps Dependencies, logger *zap.Logger) *gin.Engine {
|
||||
adminRoutes.POST("/distribution/sites/:id/withdrawals", requirePerm("distribution:settlement_manage"), distributionHandler.ApplySiteWithdrawal)
|
||||
adminRoutes.GET("/distribution/sites/:id/withdrawals", requirePerm("distribution:settlement_view"), distributionHandler.ListSiteWithdrawals)
|
||||
adminRoutes.GET("/distribution/sites/:id/analytics", requirePerm("distribution:site_view"), distributionHandler.GetDashboardAnalytics)
|
||||
if invitationHandler != nil {
|
||||
adminRoutes.GET("/distribution/sites/:id/invitation-config", requirePerm("distribution:site_view"), invitationHandler.AdminGetConfig)
|
||||
adminRoutes.PUT("/distribution/sites/:id/invitation-config", requirePerm("distribution:site_manage"), invitationHandler.AdminUpdateConfig)
|
||||
}
|
||||
adminRoutes.GET("/distribution/sites/:id/qrcodes", requirePerm("qrcode:view"), chatHandler.ListSiteQrCodesHandler)
|
||||
adminRoutes.GET("/distribution/sites/:id/qrcodes/stats", requirePerm("qrcode:view"), chatHandler.GetSiteQrCodeStatsHandler)
|
||||
adminRoutes.POST("/distribution/sites/:id/qrcodes/batch", requirePerm("qrcode:manage"), chatHandler.BatchCreateSiteQrCodeHandler)
|
||||
@@ -870,6 +899,13 @@ func New(cfg config.Config, deps Dependencies, logger *zap.Logger) *gin.Engine {
|
||||
adminRoutes.PUT("/tracking-links/:id", requirePerm("ad_tracking:manage"), adTrackingHandler.Update)
|
||||
adminRoutes.PUT("/tracking-links/:id/status", requirePerm("ad_tracking:manage"), adTrackingHandler.UpdateStatus)
|
||||
|
||||
if invitationHandler != nil {
|
||||
adminRoutes.GET("/invitations/configs", requirePerm("distribution:site_view"), invitationHandler.AdminGetConfig)
|
||||
adminRoutes.PUT("/invitations/configs", requirePerm("distribution:site_manage"), invitationHandler.AdminUpdateConfig)
|
||||
adminRoutes.GET("/invitations", requirePerm("distribution:site_view"), invitationHandler.AdminInvitations)
|
||||
adminRoutes.GET("/invitations/rebates", requirePerm("distribution:settlement_view"), invitationHandler.AdminRebates)
|
||||
}
|
||||
|
||||
registerAdminManagementRoutes(adminRoutes, requirePerm, adminManagementHandlers{
|
||||
chat: chatHandler, supportGroup: supportGroupHandler, role: adminRoleHandler,
|
||||
admin: adminMgrHandler, announcement: announcementHandler,
|
||||
|
||||
Reference in New Issue
Block a user