2 Commits

Author SHA1 Message Date
apple
d94fea8215 fix(uniapp): 小程序非余额提现成功跳转 user_cash/status
- MP-WEIXIN 与 H5/APP 一致,避免支付宝等提现后误进 user_spread_money
- docs: fsgx-issues-0402-1、0330-1 补充

Made-with: Cursor
2026-04-02 12:25:56 +08:00
apple
4351064013 fix(fsgx): 直推积分奖励规则重大调整(问题3)
- 移除 directCascadeActive 整体开关
- 创客(grade=1)仅 depth=0 时获得 reward_direct
- 云店及以上(grade>1)只需伞下关系即可获得级差 reward_direct
- 级差下限(lowerDirectReward)无论节点是否获奖均始终更新

Made-with: Cursor
2026-04-02 11:56:43 +08:00
5 changed files with 50 additions and 40 deletions

View File

@@ -5,14 +5,26 @@
检查UID=30创客是否有直推积分奖励如果有是不对的原因UID=34UID=30都是创客分销员一个订单在同一个级别的分销员只能获得一次直推积分奖励且是直推关系。
## 分销员的**直推积分奖励**问题2
- case1: 当前用户UID=2推荐UID=46推荐UID=47现在UID=47购买的报单商品订单情况下目前数据库中有订单和用户数据验证如下
- **已检查**case1: 当前用户UID=2推荐UID=46推荐UID=47现在UID=47购买的报单商品订单情况下目前数据库中有订单和用户数据验证如下
检查UID=46是创客
UID=2是否有直推积分奖励如果没有是不对的原因UID=2分销等级>UID=46,是应该获得直推积分奖励的差额部分,使用**直推积分奖励**的递归计算方法,逐一查询上级的直推积分奖励**直到最高分销等级结束**
检查UID=46还不是创客
UID=2是否有直推积分奖励如果有是不对的原因不是直推关系
- case2: 当前用户UID=46推荐UID=47推荐UID=48现在UID=48购买的报单商品订单情况下目前数据库中有订单和用户数据验证如下
- **已检查**case2: 当前用户UID=46推荐UID=47推荐UID=48现在UID=48购买的报单商品订单情况下目前数据库中有订单和用户数据验证如下
检查UID=46应该没有直推积分奖励才对因为UID=46不是UID=48的直接推荐人
- **直推积分奖励**落库的时候一定要检查直推关系。
- **已检查** **直推积分奖励**落库的时候一定要检查直推关系。
## 分销员的**直推积分奖励**问题3
- **重大调整** **直推积分奖励**落库的时候,上级的分销等级是创客的时候检查必须是直推关系才发放积分奖励, 如果分销员级别大于创客则不需要是直推关系,只要是伞下关系就可以获得级差的**积分奖励**(级差的积分奖励同样更新到“直推积分奖励”的表字段中)。
- 范氏国香mysql47.94.76.64用户推荐关系uid=1->uid=2->uid=54->uid=55->uid=56,
用户行为发生目前数据库中有订单和用户数据Uid=55和Uid=56有2笔最新的购买报单商品的订单记录后检查uid=1和Uid=2的直推积分奖励情况.
## 新增**伞下积分奖励**开关功能
- **已修复**新增伞下积分奖励开关功能,默认是关闭的

View File

@@ -0,0 +1,4 @@
# 测试问题
## 提现页面pages/users/user_cash/index
- 选择支付宝提现点击“立即提现”提交后跳转到pages/users/user_spread_money/index?type=1

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
);
}
}

View File

@@ -90,7 +90,7 @@
说明: <text class="num">每笔佣金的冻结期为{{userInfo.broken_day}}到期后可提现</text>
</view>
<view class='tip tip-warning'>
温馨提示: <text class="num">公排退款提现需收取 <text class="fee">{{withdraw_fee}}%</text> 手续费实际到账金额以扣除手续费后为准</text>
温馨提示: <text class="num">提现需收取 <text class="fee">{{withdraw_fee}}%</text> 手续费实际到账金额以扣除手续费后为准</text>
</view>
</view>
<button formType="submit" class='bnt bg-color'>立即提现</button>
@@ -121,7 +121,7 @@
说明: <text class="num">每笔佣金的冻结期为{{userInfo.broken_day}}到期后可提现</text>
</view>
<view class='tip tip-warning'>
温馨提示: <text class="num">公排退款提现需收取 <text class="fee">{{withdraw_fee}}%</text> 手续费实际到账金额以扣除手续费后为准</text>
温馨提示: <text class="num">提现需收取 <text class="fee">{{withdraw_fee}}%</text> 手续费实际到账金额以扣除手续费后为准</text>
</view>
</view>
<button formType="submit" class='bnt bg-color'>立即提现</button>
@@ -171,7 +171,7 @@
说明: <text class="num">每笔佣金的冻结期为{{userInfo.broken_day}}到期后可提现</text>
</view>
<view class='tip tip-warning'>
温馨提示: <text class="num">公排退款提现需收取 <text class="fee">{{withdraw_fee}}%</text> 手续费实际到账金额以扣除手续费后为准</text>
温馨提示: <text class="num">提现需收取 <text class="fee">{{withdraw_fee}}%</text> 手续费实际到账金额以扣除手续费后为准</text>
</view>
</view>
<button formType="submit" class='bnt bg-color'>立即提现</button>
@@ -227,7 +227,7 @@
说明: <text class="num">每笔佣金的冻结期为{{userInfo.broken_day}}到期后可提现</text>
</view>
<view class='tip tip-warning'>
温馨提示: <text class="num">公排退款提现需收取 <text class="fee">{{withdraw_fee}}%</text> 手续费实际到账金额以扣除手续费后为准</text>
温馨提示: <text class="num">提现需收取 <text class="fee">{{withdraw_fee}}%</text> 手续费实际到账金额以扣除手续费后为准</text>
</view>
</view>
<button formType="submit" class='bnt bg-color'>立即提现</button>
@@ -563,7 +563,7 @@
title: res.msg,
icon: 'success'
}, {
url: '/pages/users/user_spread_money/index',
url: '/pages/users/user_cash/status',
tab: 2
});
}

View File

@@ -167,7 +167,7 @@
说明: <text class="num">每笔佣金的冻结期为{{userInfo.broken_day}}到期后可提现</text>
</view>
<view class='tip tip-warning'>
温馨提示: <text class="num">公排退款提现需收取 <text class="fee">{{withdraw_fee}}%</text> 手续费实际到账金额以扣除手续费后为准</text>
温馨提示: <text class="num">提现需收取 <text class="fee">{{withdraw_fee}}%</text> 手续费实际到账金额以扣除手续费后为准</text>
</view>
</view>
<button formType="submit" class='bnt bg-color'>立即提现</button>
@@ -223,7 +223,7 @@
说明: <text class="num">每笔佣金的冻结期为{{userInfo.broken_day}}到期后可提现</text>
</view>
<view class='tip tip-warning'>
温馨提示: <text class="num">公排退款提现需收取 <text class="fee">{{withdraw_fee}}%</text> 手续费实际到账金额以扣除手续费后为准</text>
温馨提示: <text class="num">提现需收取 <text class="fee">{{withdraw_fee}}%</text> 手续费实际到账金额以扣除手续费后为准</text>
</view>
</view>
<button formType="submit" class='bnt bg-color'>立即提现</button>
@@ -559,7 +559,7 @@
title: res.msg,
icon: 'success'
}, {
url: '/pages/users/user_spread_money/index',
url: '/pages/users/user_cash/status',
tab: 2
});
}