直间推收益机制.md 4.4 KB
直间推收益机制
1. 概述
直间推收益机制是团队模块的核心功能之一，通过建立用户间的推荐关系，在团队成员产生收益时，按照一定比例分配给上级推荐人，形成多层级的收益分成体系，鼓励用户发展团队，形成良性的社交生态。
2. 推荐关系定义
2.1 直推关系
用户A直接推荐用户B注册，则用户A是用户B的直推上级（直接推荐人）。直推关系是一级关系，直接存储在数据库中。
2.2 间推关系
用户A推荐用户B，用户B推荐用户C，则用户A是用户C的间推上级。间推关系是多级关系，可以通过直推关系递归计算得到，或通过缓存优化查询性能。
2.3 团队成员
用户的所有直推和间推下级构成该用户的团队。团队规模是衡量用户影响力的重要指标，也是达人等级评定的主要依据。
3. 收益分成比例
3.1 直推分成比例
直推上级获得下级收益的5%。这一比例固定不变，不受达人等级影响。
例如：用户B收获农作物获得100单位收益，其直推上级用户A将获得5单位分成收益。
3.2 间推分成比例
间推分成比例与达人等级相关，具体如下：
| 达人等级 | 名称 | 间推分成比例 |
|---|---|---|
| 0 | 非达人 | 0% |
| 1 | 初级达人 | 1% |
| 2 | 中级达人 | 1.5% |
| 3 | 高级达人 | 2% |
| 4 | 资深达人 | 2.5% |
| 5 | 顶级达人 | 3% |
例如：用户C收获农作物获得100单位收益，其间推上级用户A若为顶级达人，将获得3单位分成收益。
3.3 分成范围限制
间推分成仅对20代以内的团队成员有效。超过20代的间推关系不产生收益分成。
这一限制是为了控制收益分配的深度，避免过度分散收益，同时也是出于系统性能考虑。
4. 收益来源类型
4.1 农场收获收益
当团队成员在农场收获作物时，系统会根据收获数量计算分成收益。
收益计算公式：
- 直推分成 = 收获数量 × 5%
- 间推分成 = 收获数量 × 达人等级对应分成比例
4.2 其他可能的收益来源
系统设计支持扩展其他收益来源类型，如：
- 任务完成奖励
- 活动参与奖励
- 商店销售收益
每种收益来源可以配置不同的分成规则。
5. 收益分成流程
5.1 收益产生
- 用户完成收益产生动作（如收获农作物）
- 系统记录原始收益
- 触发收益分成事件
5.2 分成计算
- 获取用户的所有上级（直推和间推）
- 根据推荐关系类型和达人等级计算分成比例
- 计算每个上级的分成金额
5.3 分成发放
- 记录分成收益明细
- 将分成收益添加到上级账户
- 通知上级收到团队收益
6. 示例场景
假设推荐链为：A → B → C → D（A推荐B，B推荐C，C推荐D）
当D收获农作物获得1000单位收益时：
- C作为D的直推上级，获得：1000 × 5% = 50单位
- B作为D的间推上级（假设B是中级达人），获得：1000 × 1.5% = 15单位
- A作为D的间推上级（假设A是顶级达人），获得：1000 × 3% = 30单位
总分成：50 + 15 + 30 = 95单位（占原始收益的9.5%）
7. 注意事项
- 收益上限：系统可能设置单次分成的上限，防止极端情况下的过度分成
- 最小分成单位：分成计算结果会四舍五入到最小单位，避免出现小数
- 分成记录：所有分成操作都会详细记录，便于用户查询和系统审计
- 达人等级变化：当用户达人等级变化时，将立即影响其间推分成比例
- 推荐关系变更：推荐关系一旦建立，通常不允许变更，以维护系统稳定性
8. 与其他模块的交互
8.1 与Farm模块交互
- 监听Farm模块的作物收获事件
- 获取收获数量和作物类型
- 计算并分配团队收益
8.2 与User模块交互
- 获取用户基本信息
- 验证用户状态和权限
8.3 与GameItems模块交互
- 将分成收益添加到用户物品库
- 记录收益来源和分成比例
9. 总结
直间推收益机制是团队系统的核心功能，通过合理的分成比例设计，既鼓励用户发展直接下级，也激励用户提升达人等级以获得更高的间推分成。这种多层级的收益分成体系，有效促进了用户社交网络的扩展和活跃度的提升，是游戏社交生态的重要支撑。