feat(fsgx): HJF queue merge, brokerage timing, cycle commission, points release

- Add HJF jobs, services, DAOs, models, admin/API controllers, release command
- Respect brokerage_timing (on_pay vs confirm); dispatch HjfOrderPayJob for queue goods
- Queue-only cycle commission and position index fix in StoreOrderCreateServices
- UserBill income types: frozen_points_brokerage, frozen_points_release
- Timer: fsgx_release_frozen_points -> PointsReleaseServices
- Agent tasks: no_assess filtering for direct/umbrella counts
- Migrations: queue_pool, points_release_log, fsgx_v1 checklist updates
- Admin/uniapp: crontab preset, membership level, user list, finance routes, docs

Made-with: Cursor
This commit is contained in:
apple
2026-03-24 11:59:09 +08:00
parent 434aa8c69d
commit 76ccb24679
59 changed files with 2902 additions and 237 deletions

View File

@@ -0,0 +1,80 @@
<?php
declare(strict_types=1);
namespace app\jobs\hjf;
use app\services\agent\AgentLevelServices;
use app\services\hjf\PointsRewardServices;
use app\services\hjf\QueuePoolServices;
use app\services\user\UserServices;
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() 将订单写入公排池
* 2. 调用 PointsRewardServices::reward() 沿推荐链发放级差积分
* 3. 调用 AgentLevelServices::checkUserLevelFinish() 检查升级
* (复用 CRMEB 分销等级升级流程,已支持 HJF 任务类型 6/7/8
*
* Class HjfOrderPayJob
* @package app\jobs\hjf
*/
class HjfOrderPayJob extends BaseJobs
{
use QueueTrait;
public function doJob(int $uid, string $orderId, float $amount = 3600.00): bool
{
try {
/** @var QueuePoolServices $queueServices */
$queueServices = app()->make(QueuePoolServices::class);
$queueServices->enqueue($uid, $orderId, $amount);
Log::info("[HjfOrderPay] 公排入队成功 uid={$uid} orderId={$orderId}");
} catch (ValidateException $e) {
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 {
/** @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 {
/** @var UserServices $userServices */
$userServices = app()->make(UserServices::class);
$userInfo = $userServices->getUserCacheInfo($uid);
$spreadUid = $userInfo ? (int)($userInfo['spread_uid'] ?? 0) : 0;
$twoSpreadUid = 0;
if ($spreadUid > 0 && $oneUserInfo = $userServices->getUserCacheInfo($spreadUid)) {
$twoSpreadUid = $userServices->getSpreadUid($spreadUid, $oneUserInfo, false);
}
$uids = array_unique([$uid, $spreadUid, $twoSpreadUid]);
/** @var AgentLevelServices $agentLevelServices */
$agentLevelServices = app()->make(AgentLevelServices::class);
$agentLevelServices->checkUserLevelFinish($uid, $uids);
Log::info("[HjfOrderPay] 等级升级检查完成 uid={$uid}");
} catch (\Throwable $e) {
Log::error("[HjfOrderPay] 等级升级检查失败 uid={$uid}: " . $e->getMessage());
}
return true;
}
}

View File

@@ -0,0 +1,39 @@
<?php
declare(strict_types=1);
namespace app\jobs\hjf;
use app\services\agent\AgentLevelServices;
use crmeb\basic\BaseJobs;
use crmeb\traits\QueueTrait;
/**
* 会员等级异步检查 Job改造复用版
*
* 委托给 AgentLevelServices::checkUserLevelFinish() 复用 CRMEB 分销等级升级流程。
*
* Class MemberLevelCheckJob
* @package app\jobs\hjf
*/
class MemberLevelCheckJob extends BaseJobs
{
use QueueTrait;
public function doJob(int $uid): bool
{
try {
/** @var AgentLevelServices $levelServices */
$levelServices = app()->make(AgentLevelServices::class);
$levelServices->checkUserLevelFinish($uid);
} catch (\Throwable $e) {
response_log_write([
'message' => "会员等级检查失败 uid={$uid}: " . $e->getMessage(),
'file' => $e->getFile(),
'line' => $e->getLine(),
]);
return false;
}
return true;
}
}

View File

@@ -0,0 +1,47 @@
<?php
declare(strict_types=1);
namespace app\jobs\hjf;
use app\services\hjf\PointsReleaseServices;
use crmeb\basic\BaseJobs;
use crmeb\traits\QueueTrait;
use think\facade\Log;
/**
* 积分每日释放 Job
*
* 由定时任务crontab 或 Swoole Timer在每天凌晨 00:01 触发。
* 调用方式PointsReleaseJob::dispatch()
*
* Class PointsReleaseJob
* @package app\jobs\hjf
*/
class PointsReleaseJob extends BaseJobs
{
use QueueTrait;
/**
* 执行积分释放
* @return bool
*/
public function doJob(): bool
{
try {
/** @var PointsReleaseServices $releaseServices */
$releaseServices = app()->make(PointsReleaseServices::class);
$result = $releaseServices->executeRelease();
Log::info('[PointsReleaseJob] 执行完成', $result);
} catch (\Throwable $e) {
response_log_write([
'message' => '积分每日释放任务失败: ' . $e->getMessage(),
'file' => $e->getFile(),
'line' => $e->getLine(),
]);
return false;
}
return true;
}
}

View File

@@ -0,0 +1,95 @@
<?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;
}
}