102 lines
4.5 KiB
Markdown
102 lines
4.5 KiB
Markdown
# 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`
|
||
|