scottpan/huangjingfen
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix(fsgx): 直推积分奖励规则重大调整（问题3）

Browse Source 
- 移除 directCascadeActive 整体开关
- 创客(grade=1)仅 depth=0 时获得 reward_direct
- 云店及以上(grade>1)只需伞下关系即可获得级差 reward_direct
- 级差下限(lowerDirectReward)无论节点是否获奖均始终更新

Made-with: Cursor
This commit is contained in:
apple
2026-04-02 11:56:43 +08:00
parent 1c0cf5204f
commit 4351064013
1 changed files with 23 additions and 29 deletions
Download Patch File Download Diff File Expand all files Collapse all files

52
pro_v3.5.1/app/services/hjf/PointsRewardServices.php
View File

@@ -78,24 +78,20 @@ class PointsRewardServices extends BaseServices
/**
* 向上递归发放直推积分奖励（标准逐级级差）
*
* 算法：沿推荐链向上遍历，每个分销等级大于0的祖先获得
* max(0, 自身 direct_reward_points - 链中已见最高 direct_reward_points) * qty
* 非分销员（grade=0）跳过但继续向上传递，$lowerDirectReward 不变。
* 发放规则（fsgx 问题3）：
* - grade=0（非分销员）：跳过，不获奖，继续向上，$lowerDirectReward 不变
* - grade=1（创客）：仅当 depth=0（买家直接推荐人）才获得级差 reward_direct；
* depth>0 时不获奖，但其 direct_reward_points 仍计入级差下限
* - grade>1（云店/服务中心/合伙人）：无论 depth，只要在伞下链上就获得级差 reward_direct
*
* 直推关系约束（$directCascadeActive）：
* 当买家直接推荐人（depth=0）不是分销员（grade=0）时，直推级差链终止，
* 其所有上级祖先不得获得 reward_direct（不存在直推关系）。
* 伞下奖励（reward_umbrella）不受此约束，仍按自身开关独立发放。
*
* @param int $uid 当前被奖励用户
* @param int $fromUid 触发方（下级）用户 ID
* @param string $orderId 来源订单号
* @param int $lowerDirectReward 链中已被下级拿走的最高 direct_reward_points（级差下限）
* @param int $depth 递归深度（防止无限递归）
* @param int $orderDbId 订单表主键 id
* @param array $preUpgradeLevels 升级前各用户的 agent_level 快照 [uid => level_id]（B2）
* @param int $qty 报单商品数量，积分按数量倍乘（B3）
* @param bool $directCascadeActive 直推级差链是否仍然有效
* @param int $uid 当前被奖励用户
* @param int $fromUid 触发方（下级）用户 ID
* @param string $orderId 来源订单号
* @param int $lowerDirectReward 链中已被下级拿走的最高 direct_reward_points（级差下限）
* @param int $depth 递归深度（防止无限递归）
* @param int $orderDbId 订单表主键 id
* @param array $preUpgradeLevels 升级前各用户的 agent_level 快照 [uid => level_id]（B2）
* @param int $qty 报单商品数量，积分按数量倍乘（B3）
*/
private function propagateReward(
int $uid,
@@ -105,8 +101,7 @@ class PointsRewardServices extends BaseServices
int $depth = 0,
int $orderDbId = 0,
array $preUpgradeLevels = [],
int $qty = 1,
bool $directCascadeActive = true
int $qty = 1
): void {
if ($depth >= 10 || $uid <= 0) {
return;
@@ -124,20 +119,20 @@ class PointsRewardServices extends BaseServices
$grade = $this->agentLevelServices->getGradeByLevelId($agentLevelId);
if ($grade === 0) {
// 非分销员：跳过奖励，继续向上传递
// 若当前节点是买家的直接推荐人（depth=0），直推级差链从此中断：
// 上级祖先与买家之间没有直推关系，不应获得 reward_direct
$nextCascadeActive = ($depth === 0) ? false : $directCascadeActive;
// 非分销员：跳过奖励，继续向上传递，$lowerDirectReward 保持不变
if ($user['spread_uid']) {
$this->propagateReward((int)$user['spread_uid'], $uid, $orderId, $lowerDirectReward, $depth + 1, $orderDbId, $preUpgradeLevels, $qty, $nextCascadeActive);
$this->propagateReward((int)$user['spread_uid'], $uid, $orderId, $lowerDirectReward, $depth + 1, $orderDbId, $preUpgradeLevels, $qty);
}
return;
}
$directReward = $this->agentLevelServices->getDirectRewardPoints($agentLevelId);
// 直推级差：仅在直推链有效时发放（买家直接推荐人必须是分销员）
if ($directCascadeActive) {
// 创客(grade=1)必须是买家直推人(depth=0)才获得级差奖励；
// 高于创客(grade>1)则伞下关系即可获得级差奖励
$isEligibleForDirect = ($grade > 1) || ($grade === 1 && $depth === 0);
if ($isEligibleForDirect) {
$actual = max(0, $directReward - $lowerDirectReward) * $qty;
if ($actual > 0) {
$this->grantFrozenPoints(
@@ -170,7 +165,7 @@ class PointsRewardServices extends BaseServices
}
}
// 向上传递时，下限取当前节点与已有下限中的较大值，确保上级只拿增量
// 级差下限始终更新（不论本节点是否获奖），保证上级只拿增量差额
$nextLower = max($directReward, $lowerDirectReward);
if ($user['spread_uid']) {
$this->propagateReward(
@@ -181,8 +176,7 @@ class PointsRewardServices extends BaseServices
$depth + 1,
$orderDbId,
$preUpgradeLevels,
$qty,
$directCascadeActive
$qty
);
}
}