Files
huangjingfen/pro_v3.5.1_副本/app/services/user/label/UserLabelBatchProcessServices.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

264 lines
9.1 KiB
PHP
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<?php
// +----------------------------------------------------------------------
// | CRMEB [ CRMEB赋能开发者助力企业发展 ]
// +----------------------------------------------------------------------
// | Copyright (c) 2016~2026 https://www.crmeb.com All rights reserved.
// +----------------------------------------------------------------------
// | Licensed CRMEB并不是自由软件未经许可不能去掉CRMEB相关版权
// +----------------------------------------------------------------------
// | Author: CRMEB Team <admin@crmeb.com>
// +----------------------------------------------------------------------
namespace app\services\user\label;
use app\services\BaseServices;
use app\services\user\UserServices;
use app\jobs\user\UserAutoLabelJob;
use think\facade\Log;
use crmeb\traits\ServicesTrait;
/**
* 用户标签批量处理服务
* Class UserLabelBatchProcessServices
* @package app\services\user\label
*/
class UserLabelBatchProcessServices extends BaseServices
{
use ServicesTrait;
/**
* 批量大小
*/
const BATCH_SIZE = 1000;
/**
* 处理标签变更后的用户批量检查
* @param array $labelIds 标签ID数组
* @param string $action 操作类型create(新建) 或 update(修改)
* @return bool
*/
public function processLabelChange(array $labelIds, string $action = 'update')
{
try {
Log::info('开始处理标签变更批量用户检查:' . var_export([
'label_ids' => $labelIds,
'action' => $action
], true));
// 获取所有用户ID
$userIds = $this->getAllUserIds();
if (empty($userIds)) {
Log::info('没有找到用户,跳过处理');
return true;
}
// 初始化处理状态缓存
$cacheKey = "label_batch_process_" . implode('_', $labelIds);
$statusData = [
'label_ids' => $labelIds,
'status' => 'processing',
'processed_count' => 0,
'total_count' => count($userIds),
'start_time' => date('Y-m-d H:i:s'),
'end_time' => null,
'message' => '正在处理中...'
];
cache($cacheKey, $statusData, 3600); // 缓存1小时
// 分批处理用户
$batches = array_chunk($userIds, self::BATCH_SIZE);
$totalBatches = count($batches);
Log::info('开始分批处理用户:' . var_export([
'total_users' => count($userIds),
'batch_size' => self::BATCH_SIZE,
'total_batches' => $totalBatches
], true));
$processedCount = 0;
foreach ($batches as $index => $batchUserIds) {
$this->processBatchUsers($batchUserIds, $labelIds, $action, $index + 1, $totalBatches);
$processedCount += count($batchUserIds);
// 更新处理状态
$statusData['processed_count'] = $processedCount;
$statusData['message'] = "已处理 {$processedCount}/{$statusData['total_count']} 个用户";
cache($cacheKey, $statusData, 3600);
}
// 更新最终状态
$statusData['status'] = 'completed';
$statusData['end_time'] = date('Y-m-d H:i:s');
$statusData['message'] = '处理完成';
cache($cacheKey, $statusData, 3600);
Log::info('标签变更批量用户检查处理完成:' . var_export([
'label_ids' => $labelIds,
'total_users' => count($userIds)
], true));
return true;
} catch (\Throwable $e) {
// 更新错误状态
$cacheKey = "label_batch_process_" . implode('_', $labelIds);
$errorStatus = [
'label_ids' => $labelIds,
'status' => 'error',
'processed_count' => 0,
'total_count' => 0,
'start_time' => date('Y-m-d H:i:s'),
'end_time' => date('Y-m-d H:i:s'),
'message' => '处理失败:' . $e->getMessage()
];
cache($cacheKey, $errorStatus, 3600);
Log::error('标签变更批量用户检查处理失败:' . var_export([
'label_ids' => $labelIds,
'action' => $action,
'error' => $e->getMessage(),
'file' => $e->getFile(),
'line' => $e->getLine()
], true));
return false;
}
}
/**
* 获取所有用户ID
* @return array
*/
protected function getAllUserIds(): array
{
/** @var UserServices $userServices */
$userServices = app()->make(UserServices::class);
// 获取所有启用的用户ID
$where = [
'status' => 1, // 启用状态
'is_del' => 0 // 未删除
];
// 分批获取用户ID避免内存溢出
$userIds = [];
$page = 1;
$limit = 5000; // 每次获取5000个用户ID
do {
$users = $userServices->getList($where, 'uid', $page, $limit);
$batchIds = array_column($users, 'uid');
$userIds = array_merge($userIds, $batchIds);
$page++;
} while (count($batchIds) === $limit);
return array_unique($userIds);
}
/**
* 处理批次用户
* @param array $userIds 用户ID数组
* @param array $labelIds 标签ID数组
* @param string $action 操作类型
* @param int $batchIndex 当前批次索引
* @param int $totalBatches 总批次数
*/
protected function processBatchUsers(array $userIds, array $labelIds, string $action, int $batchIndex, int $totalBatches)
{
try {
Log::info('处理用户批次:' . var_export([
'batch_index' => $batchIndex,
'total_batches' => $totalBatches,
'user_ids' => $userIds,
'user_count' => count($userIds),
'label_ids' => $labelIds
], true));
// 批量分发自动标签检查任务每100个用户一个任务
$batchSize = 100;
$userBatches = array_chunk($userIds, $batchSize);
foreach ($userBatches as $userBatch) {
// 分发批量处理任务,传入用户数组而不是单个用户
UserAutoLabelJob::dispatch([
$userBatch,
'label_change', // 触发类型:标签变更
[
'action' => $action,
'changed_labels' => $labelIds,
'timestamp' => time()
],
$labelIds // 只检查变更的标签
]);
}
Log::info('批次用户处理完成:' . var_export([
'batch_index' => $batchIndex,
'user_batches' => count($userBatches),
'dispatched_jobs' => count($userBatches),
'total_users' => count($userIds)
], true));
} catch (\Throwable $e) {
Log::error('处理用户批次失败:' . var_export([
'batch_index' => $batchIndex,
'user_count' => count($userIds),
'error' => $e->getMessage()
], true));
}
}
/**
* 处理单个标签的用户检查
* @param int $labelId 标签ID
* @param string $action 操作类型
* @return bool
*/
public function processSingleLabel(int $labelId, string $action = 'update')
{
return $this->processLabelChange([$labelId], $action);
}
/**
* 获取批量处理状态
* @param int $labelId
* @return array
*/
public function getBatchProcessStatus(int $labelId): array
{
try {
// 从缓存中获取处理状态
$cacheKey = "label_batch_process_{$labelId}";
$status = cache($cacheKey);
if (!$status) {
return [
'label_id' => $labelId,
'status' => 'not_started',
'processed_count' => 0,
'total_count' => 0,
'start_time' => null,
'end_time' => null,
'message' => '未找到处理记录'
];
}
return $status;
} catch (\Exception $e) {
Log::error('获取批量处理状态失败:' . var_export([
'label_id' => $labelId,
'error' => $e->getMessage()
], true));
return [
'label_id' => $labelId,
'status' => 'error',
'processed_count' => 0,
'total_count' => 0,
'start_time' => null,
'end_time' => null,
'message' => '获取状态失败:' . $e->getMessage()
];
}
}
}