Files
huangjingfen/pro_v3.5.1_副本/app/jobs/hjf/QueueRefundJob.php
apple 434aa8c69d feat(fsgx): 完成全部24项开发任务 Phase1-7
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
2026-03-23 22:32:19 +08:00

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