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
96 lines
3.2 KiB
PHP
96 lines
3.2 KiB
PHP
<?php
|
|
declare(strict_types=1);
|
|
|
|
namespace app\jobs\hjf;
|
|
|
|
use app\dao\hjf\QueuePoolDao;
|
|
use app\dao\user\UserBillDao;
|
|
use app\dao\user\UserDao;
|
|
use crmeb\basic\BaseJobs;
|
|
use crmeb\traits\QueueTrait;
|
|
use think\facade\Db;
|
|
use think\facade\Log;
|
|
|
|
/**
|
|
* 公排退款异步 Job
|
|
*
|
|
* 由 QueuePoolServices::checkAndTriggerRefund() 派发。
|
|
* 执行流程:
|
|
* 1. 二次检查记录状态(防止重复退款)
|
|
* 2. 在数据库事务中:标记记录已退款 + 写入用户余额 + 写 user_bill 流水
|
|
*
|
|
* Class QueueRefundJob
|
|
* @package app\jobs\hjf
|
|
*/
|
|
class QueueRefundJob extends BaseJobs
|
|
{
|
|
use QueueTrait;
|
|
|
|
/**
|
|
* 执行退款
|
|
*
|
|
* @param int $queueId eb_queue_pool.id
|
|
* @param int $uid 用户 ID
|
|
* @param float $amount 退款金额
|
|
* @param int $batchNo 批次号
|
|
* @return bool
|
|
*/
|
|
public function doJob(int $queueId, int $uid, float $amount, int $batchNo): bool
|
|
{
|
|
try {
|
|
/** @var QueuePoolDao $queueDao */
|
|
$queueDao = app()->make(QueuePoolDao::class);
|
|
|
|
// 二次检查:防止重复退款
|
|
$record = $queueDao->get($queueId);
|
|
if (!$record || (int)$record['status'] === 1) {
|
|
Log::info("[QueueRefund] 记录 {$queueId} 已退款或不存在,跳过");
|
|
return true;
|
|
}
|
|
|
|
Db::transaction(function () use ($queueId, $uid, $amount, $batchNo, $queueDao) {
|
|
// 1. 标记公排记录为已退款
|
|
$queueDao->markRefunded($queueId, $batchNo);
|
|
|
|
// 2. 写入用户余额(使用 bcadd 避免浮点误差)
|
|
/** @var UserDao $userDao */
|
|
$userDao = app()->make(UserDao::class);
|
|
$user = $userDao->get($uid);
|
|
if (!$user) {
|
|
throw new \RuntimeException("用户 {$uid} 不存在");
|
|
}
|
|
$newMoney = bcadd((string)$user['now_money'], (string)$amount, 2);
|
|
$userDao->update($uid, ['now_money' => $newMoney], 'uid');
|
|
|
|
// 3. 写 user_bill 流水记录
|
|
/** @var UserBillDao $billDao */
|
|
$billDao = app()->make(UserBillDao::class);
|
|
$billDao->save([
|
|
'uid' => $uid,
|
|
'link_id' => $queueId,
|
|
'pm' => 1,
|
|
'title' => '公排退款',
|
|
'type' => 'queue_refund',
|
|
'category' => 'now_money',
|
|
'number' => $amount,
|
|
'balance' => $newMoney,
|
|
'mark' => "公排触发退款,批次#{$batchNo}",
|
|
'status' => 1,
|
|
'add_time' => time(),
|
|
]);
|
|
});
|
|
|
|
Log::info("[QueueRefund] 退款成功 uid={$uid} amount={$amount} batch={$batchNo}");
|
|
} catch (\Throwable $e) {
|
|
response_log_write([
|
|
'message' => '公排退款失败: ' . $e->getMessage(),
|
|
'file' => $e->getFile(),
|
|
'line' => $e->getLine(),
|
|
]);
|
|
return false;
|
|
}
|
|
|
|
return true;
|
|
}
|
|
}
|