From 4351064013efa196f643af7e7762c5b0dce1d394 Mon Sep 17 00:00:00 2001 From: apple Date: Thu, 2 Apr 2026 11:56:43 +0800 Subject: [PATCH] =?UTF-8?q?fix(fsgx):=20=E7=9B=B4=E6=8E=A8=E7=A7=AF?= =?UTF-8?q?=E5=88=86=E5=A5=96=E5=8A=B1=E8=A7=84=E5=88=99=E9=87=8D=E5=A4=A7?= =?UTF-8?q?=E8=B0=83=E6=95=B4=EF=BC=88=E9=97=AE=E9=A2=983=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 移除 directCascadeActive 整体开关 - 创客(grade=1)仅 depth=0 时获得 reward_direct - 云店及以上(grade>1)只需伞下关系即可获得级差 reward_direct - 级差下限(lowerDirectReward)无论节点是否获奖均始终更新 Made-with: Cursor --- .../app/services/hjf/PointsRewardServices.php | 52 ++++++++----------- 1 file changed, 23 insertions(+), 29 deletions(-) diff --git a/pro_v3.5.1/app/services/hjf/PointsRewardServices.php b/pro_v3.5.1/app/services/hjf/PointsRewardServices.php index cce8711a..ceb8b257 100644 --- a/pro_v3.5.1/app/services/hjf/PointsRewardServices.php +++ b/pro_v3.5.1/app/services/hjf/PointsRewardServices.php @@ -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 ); } }