Phase1 后端核心:
- 新增 fsgx_v1.sql 迁移脚本(is_queue_goods/frozen_points/available_points/no_assess)
- SystemConfigServices 返佣设置扩展(周期人数/分档比例/范围/时机)
- StoreOrderCreateServices 周期循环佣金计算
- StoreOrderTakeServices 佣金发放后同步冻结积分
- StoreProductServices/StoreProduct 保存 is_queue_goods
Phase2 后端接口:
- GET /api/hjf/brokerage/progress 佣金周期进度
- GET /api/hjf/assets/overview 资产总览
- HjfPointsServices 每日 frozen_points 0.4‰ 释放定时任务
- PUT /adminapi/hjf/member/{uid}/no_assess 不考核接口
- GET /adminapi/hjf/points/release_log 积分日志接口
Phase3 前端清理:
- hjfCustom.js 路由精简(仅保留 points/log)
- hjfQueue.js/hjfMember.js API 清理/重定向至 CRMEB 原生接口
- pages.json 公排→推荐佣金/佣金记录/佣金规则
Phase4-5 前端改造:
- queue/status.vue 推荐佣金进度页整体重写
- 商品详情/订单确认/支付结果页文案与逻辑改造
- 个人中心/资产页/引导页/规则页文案改造
- HjfQueueProgress/HjfRefundNotice/HjfAssetCard 组件改造
- 推广中心嵌入佣金进度摘要
- hjfMockData.js 全量更新(公排字段→佣金字段)
Phase6 Admin 增强:
- 用户列表新增 frozen_points/available_points 列及不考核操作按钮
- hjfPoints.js USE_MOCK=false 对接真实积分日志接口
Phase7 配置文档:
- docs/fsgx-phase7-config-checklist.md 后台配置与全链路验收清单
Made-with: Cursor
88 lines
3.4 KiB
PHP
88 lines
3.4 KiB
PHP
<?php
|
||
declare(strict_types=1);
|
||
|
||
namespace app\jobs\hjf;
|
||
|
||
use app\services\hjf\MemberLevelServices;
|
||
use app\services\hjf\PointsRewardServices;
|
||
use app\services\hjf\QueuePoolServices;
|
||
use crmeb\basic\BaseJobs;
|
||
use crmeb\traits\QueueTrait;
|
||
use think\exception\ValidateException;
|
||
use think\facade\Log;
|
||
|
||
/**
|
||
* 报单商品支付成功异步处理 Job
|
||
*
|
||
* 触发时机:Pay 监听器检测到 is_queue_goods=1 时派发。
|
||
*
|
||
* 执行流程:
|
||
* 1. 调用 QueuePoolServices::enqueue() 将订单写入公排池
|
||
* (内部含 Redis 分布式锁 + 退款触发检测)
|
||
* 2. 调用 PointsRewardServices::reward() 沿推荐链发放级差积分
|
||
* 3. 调用 MemberLevelServices::checkUpgrade() 检查下单用户上级链是否触发等级升级
|
||
*
|
||
* Class HjfOrderPayJob
|
||
* @package app\jobs\hjf
|
||
*/
|
||
class HjfOrderPayJob extends BaseJobs
|
||
{
|
||
use QueueTrait;
|
||
|
||
/**
|
||
* @param int $uid 下单用户 ID
|
||
* @param string $orderId 订单号(eb_store_order.order_id)
|
||
* @param float $amount 报单金额(默认 3600.00)
|
||
* @return bool
|
||
*/
|
||
public function doJob(int $uid, string $orderId, float $amount = 3600.00): bool
|
||
{
|
||
try {
|
||
// 1. 公排入队
|
||
/** @var QueuePoolServices $queueServices */
|
||
$queueServices = app()->make(QueuePoolServices::class);
|
||
$queueServices->enqueue($uid, $orderId, $amount);
|
||
Log::info("[HjfOrderPay] 公排入队成功 uid={$uid} orderId={$orderId}");
|
||
} catch (ValidateException $e) {
|
||
// 锁竞争导致入队失败,重新投递到队列(延迟5秒)
|
||
Log::warning("[HjfOrderPay] 入队被锁,延迟重试 uid={$uid} orderId={$orderId}: " . $e->getMessage());
|
||
static::dispatchSece(5, [$uid, $orderId, $amount]);
|
||
return true;
|
||
} catch (\Throwable $e) {
|
||
Log::error("[HjfOrderPay] 公排入队异常 uid={$uid} orderId={$orderId}: " . $e->getMessage());
|
||
return false;
|
||
}
|
||
|
||
try {
|
||
// 2. 积分奖励(级差发放)
|
||
/** @var PointsRewardServices $pointsServices */
|
||
$pointsServices = app()->make(PointsRewardServices::class);
|
||
$pointsServices->reward($uid, $orderId);
|
||
Log::info("[HjfOrderPay] 积分奖励发放完成 uid={$uid} orderId={$orderId}");
|
||
} catch (\Throwable $e) {
|
||
// 积分发放失败不阻塞主流程,记录错误即可
|
||
Log::error("[HjfOrderPay] 积分奖励失败 uid={$uid} orderId={$orderId}: " . $e->getMessage());
|
||
}
|
||
|
||
try {
|
||
// 3. 触发推荐链等级升级检查(对买家本人及其直推上级)
|
||
/** @var MemberLevelServices $levelServices */
|
||
$levelServices = app()->make(MemberLevelServices::class);
|
||
$levelServices->checkUpgrade($uid);
|
||
|
||
// 同时检查直推上级(支付行为可能满足上级的伞下业绩门槛)
|
||
$spreadUid = (int)\think\facade\Db::name('user')
|
||
->where('uid', $uid)
|
||
->value('spread_uid');
|
||
if ($spreadUid > 0) {
|
||
$levelServices->checkUpgrade($spreadUid);
|
||
}
|
||
Log::info("[HjfOrderPay] 等级升级检查完成 uid={$uid}");
|
||
} catch (\Throwable $e) {
|
||
Log::error("[HjfOrderPay] 等级升级检查失败 uid={$uid}: " . $e->getMessage());
|
||
}
|
||
|
||
return true;
|
||
}
|
||
}
|