跳到主要内容

井云服务中心分销系统概述

📋 系统简介​

井云服务中心分销系统是一个基于多级分销模式的佣金计算与管理功能模块，集成在用户服务中。系统支持直推佣金和间推佣金的自动计算、用户分销等级管理、佣金记录管理、提现管理等功能。采用 Go 1.25.4 和 Kratos v2 框架构建，使用 Ent ORM 进行数据管理。

🎯 核心功能​

分销等级管理​

  • 创建和管理分销等级
  • 设置升级条件和佣金比例
  • 自动等级升级机制

佣金计算系统​

  • 多级佣金计算（支持二级分销）
  • 实时佣金统计
  • 详细的佣金记录追踪

提现管理​

  • 用户提现申请
  • 管理员审核流程
  • 多种提现方式支持

数据分析​

  • 分销数据统计
  • 业绩报表生成
  • 趋势分析

🏗️ 系统架构​

服务组件​

  • Gateway服务: 提供统一API接口 (HTTP 8000, gRPC 9000)
  • User服务: 处理分销业务逻辑 (gRPC 9002)
  • Cron服务: 定时检查和自动等级升级 (gRPC 9008)
  • PostgreSQL: 存储分销数据 (端口 5431)
  • RabbitMQ: 处理订单支付事件消息 (端口 5672)

核心流程​

  1. 用户注册 → 建立邀请关系
  2. 订单支付 → 触发佣金计算
  3. 佣金分配 → 更新用户余额
  4. 提现申请 → 管理员审核
  5. 定时检查 → 自动等级升级

📊 数据模型​

核心实体 (Ent Schema)​

  • DistributionLevel: 分销等级表 (distribution_levels)
  • CommissionRecord: 佣金记录表 (commission_records)
  • WithdrawalRecord: 提现记录表 (withdrawal_records)
  • UserTransaction: 用户交易记录表 (user_transactions)
  • UserDistributionConfig: 用户分销配置表 (user_distribution_configs)
  • UserDistributionLevel: 用户分销等级表 (user_distribution_levels)
  • DiscountCode: 优惠码表 (discount_codes)

关系说明​

  • 用户属于分销等级
  • 佣金记录关联订单和用户
  • 提现记录关联用户和状态

🔧 技术特性​

性能优化​

  • 高效的佣金计算算法
  • 批量数据处理
  • 缓存热点数据

安全保障​

  • 事务保证数据一致性
  • 权限控制和安全审计
  • 防刷单机制

扩展性​

  • 支持多级分销扩展
  • 灵活的佣金规则配置
  • 插件化功能模块

📈 业务价值​

用户激励​

  • 多级佣金激励用户推广
  • 等级体系提升用户粘性
  • 透明的佣金分配机制

运营效率​

  • 自动化的佣金计算
  • 完善的数据统计
  • 灵活的配置管理

商业模式​

  • 降低获客成本
  • 提升用户活跃度
  • 促进业务增长

🔗 相关文档​

最后更新：2025年12月