跟单交易与佣金系统文档

一、跟单/带单逻辑

1. 角色说明

2. 跟单模式

3. 跟单流程

用户选择带单员 → 投入跟单金额 → 系统扣除合约账户余额
                              ↓
                    创建跟单记录(copy_trade)
                              ↓
              带单员创建订单 → 系统自动为跟单用户创建跟单订单
                              ↓
                    订单平仓 → 计算盈亏、手续费、分成
                              ↓
                    更新跟单资金池 → 生成佣金记录

4. 1:1 跟单计算

跟单订单与带单员订单使用相同的交易参数：

• 金额(amount)：与带单员订单相同
• 保证金(margin)：amount / leverage
• 手续费(fee)：amount × taker_fee × 2
• 盈亏计算：
  • 做多：profit = amount × (close_price / entry_price - 1)
  • 做空：profit = amount × (1 - close_price / entry_price)
• 净收益：net_profit = profit - fee - profit_share

5. 跟单资金池

每个跟单记录维护一个资金池（current_amount）：

• 开始跟单时：current_amount = 投入金额
• 每笔订单平仓后：current_amount = current_amount - fee + profit - profit_share
• 普通模式：current_amount < 最低跟单金额时强制退出
• 保本模式：到期时如果 current_amount < 初始金额，需要赔付

二、管理员操作流程

1. 带单员管理

路径：后台 → 跟单管理 → 带单员管理

2. 创建带单订单

路径：后台 → 跟单管理 → 带单员管理 → 添加订单

操作步骤：

1. 选择带单员
2. 选择交易币种
3. 设置订单参数（方向、杠杆、金额、开仓价、平仓价）
4. 提交后系统自动：
   • 创建带单员的合约订单（已平仓状态）
   • 为所有跟单用户创建跟单订单
   • 计算每个跟单用户的盈亏
   • 生成佣金记录

3. 保本赔付

路径：后台 → 跟单管理 → 带单员管理 → 赔付

触发条件：保本跟单到期且 current_amount < 初始金额

操作步骤：

1. 点击"赔付"按钮
2. 系统显示需要赔付的金额
3. 确认后系统自动：
   • 将赔付金额加入用户合约账户
   • 记录赔付流水
   • 更新跟单状态为已到期

三、佣金系统

1. 佣金类型

2. 级差佣金计算

计算基数：跟单订单的手续费（fee_amount）

计算公式：

级差比例 = 当前上级佣金比例 - 下级中最高佣金比例
佣金金额 = 手续费 × 级差比例

示例：

• 用户A（V3，佣金比例25%）邀请了用户B（V2，佣金比例15%）
• 用户B邀请了用户C（V1，佣金比例10%）
• 用户C跟单产生手续费 100 USDT

佣金分配：

• 用户B获得：100 × (15% - 0%) = 15 USDT（C是V1，下级最高比例为0）
• 用户A获得：100 × (25% - 15%) = 10 USDT（级差 = 25% - 15%）

3. 平级奖计算

当用户有同级别的直推下级时，可获得该下级佣金的一定比例作为平级奖。

计算公式：

平级奖 = 下级佣金 × 平级奖比例（默认10%）

4. 用户等级

等级根据活跃跟单人数自动计算：

四、佣金结算流程

1. 结算周期

佣金采用周结算制度，每周日12:00执行结算。

2. 佣金状态

3. 手动结算流程

路径：后台 → 佣金管理 → 结算管理

步骤1：创建结算批次

1. 点击"创建批次"按钮
2. 系统显示本周待结算的记录数和金额
3. 确认后创建结算批次（状态：待处理）

步骤2：执行结算

1. 在列表中找到待处理的批次
2. 点击"执行结算"按钮
3. 系统自动：
   • 将佣金发放到用户资金账户（USDT）
   • 记录资金流水
   • 更新佣金记录状态为已结算
   • 更新用户累计佣金和待结算佣金