ycc-proxy-server/distributeNormalAgentBonus配置项说明.md

distributeNormalAgentBonus 函数使用的配置项说明

函数位置

ycc-proxy-server/app/main/api/internal/service/agentService.go:254-478

使用的配置项列表

1. direct_parent_amount_normal

• 配置键：direct_parent_amount_normal
• 类型：浮点数（float64）
• 默认值：2.0元
• 使用位置：第376行
• 用途：普通代理给直接上级普通代理的返佣金额
• 使用场景：
  • 当直接上级是普通代理时使用
  • 无论后续层级有多少普通代理，这部分金额只给推广人的直接上级
• 示例：等级加成6元，给直接上级普通代理2元

2. direct_parent_amount_gold

• 配置键：direct_parent_amount_gold
• 类型：浮点数（float64）
• 默认值：3.0元
• 使用位置：第326行
• 用途：普通代理给直接上级黄金代理的返佣金额
• 使用场景：
  • 当直接上级是黄金代理时使用
  • 这部分金额给直接上级黄金代理，剩余部分继续向上分配给钻石上级
• 示例：等级加成6元，给直接上级黄金代理3元，剩余3元给钻石上级

3. max_gold_rebate_amount

• 配置键：max_gold_rebate_amount
• 类型：浮点数（float64）
• 默认值：3.0元
• 使用位置：第492行
• 用途：普通代理给黄金上级的最大返佣金额
• 使用场景：
  • 当直接上级是普通代理，且只有黄金上级（没有钻石上级）时使用
  • 即使剩余金额超过这个值，也只能给黄金上级最多这个金额，超出部分归平台
• 示例：剩余4元，最大限额3元，则给黄金3元，剩余1元归平台

4. level_2_bonus

• 配置键：level_2_bonus
• 类型：整数（int64），从配置读取时转换为浮点数计算
• 默认值：3元
• 使用位置：第438行（通过 getLevelBonus(ctx, 2) 调用）
• 用途：黄金代理的等级加成
• 使用场景：
  • 用于计算等级加成的差（普通等级加成 - 黄金等级加成）
  • 当直接上级是普通代理，且上级链中有黄金和钻石时，用于计算给黄金的返佣金额
• 计算逻辑：
  • 等级加成差 = 普通等级加成（6元）- 黄金等级加成（3元）= 3元
  • 给黄金的金额 = 等级加成差（3元）- 已给普通的部分（2元）= 1元

5. level_1_bonus

• 配置键：level_1_bonus
• 类型：整数（int64）
• 默认值：6元
• 使用位置：通过 amount 参数传入（在 AgentProcess 中通过 getLevelBonus(ctx, 1) 获取）
• 用途：普通代理的等级加成
• 说明：
  • 不在 distributeNormalAgentBonus 函数中直接读取
  • 作为 amount 参数传入函数
  • 这是需要分配的总额

配置项使用总结表

配置键	默认值	使用场景	代码行号
direct_parent_amount_normal	2.0元	直接上级是普通代理时，给直接上级的返佣金额	376
direct_parent_amount_gold	3.0元	直接上级是黄金代理时，给直接上级的返佣金额	326
max_gold_rebate_amount	3.0元	只有黄金上级（无钻石）时，给黄金的最大返佣金额	492
level_2_bonus	3元	黄金代理等级加成，用于计算等级加成差	438
level_1_bonus	6元	普通代理等级加成，通过参数传入	-

配置项在代码中的调用关系

AgentProcess (处理订单)
  ↓
  调用 getLevelBonus(ctx, agent.Level) 获取普通代理等级加成
  ↓
  传入 distributeNormalAgentBonus(amount=6元, ...)
  ↓
  在函数内使用：
    1. getRebateConfigFloat("direct_parent_amount_normal", 2.0)  # 第376行
    2. getRebateConfigFloat("direct_parent_amount_gold", 3.0)    # 第326行
    3. getRebateConfigFloat("max_gold_rebate_amount", 3.0)       # 第492行
    4. getLevelBonus(ctx, 2) -> 读取 level_2_bonus              # 第438行

注意事项

1. 所有配置项都支持动态配置：如果配置不存在，会使用默认值
2. 配置读取失败会记录日志：确保配置问题时可以追踪
3. 配置值的类型转换：
   • 返佣配置直接使用浮点数（支持小数）
   • 等级加成从配置读取时为整数，计算时转换为浮点数
4. 配置项命名规范：
   • 返佣配置使用描述性名称：direct_parent_amount_normal、direct_parent_amount_gold、max_gold_rebate_amount
   • 等级加成配置使用数字后缀：level_1_bonus、level_2_bonus