434aa8c69d
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
498 lines
21 KiB
PHP
498 lines
21 KiB
PHP
<?php
|
||
// +----------------------------------------------------------------------
|
||
// | CRMEB [ CRMEB赋能开发者，助力企业发展 ]
|
||
// +----------------------------------------------------------------------
|
||
// | Copyright (c) 2016~2026 https://www.crmeb.com All rights reserved.
|
||
// +----------------------------------------------------------------------
|
||
// | Licensed CRMEB并不是自由软件，未经许可不能去掉CRMEB相关版权
|
||
// +----------------------------------------------------------------------
|
||
// | Author: CRMEB Team <admin@crmeb.com>
|
||
// +----------------------------------------------------------------------
|
||
declare (strict_types=1);
|
||
|
||
namespace app\services\activity\coupon;
|
||
|
||
use app\services\activity\promotions\StorePromotionsServices;
|
||
use app\services\BaseServices;
|
||
use app\services\product\brand\StoreBrandServices;
|
||
use app\services\user\UserServices;
|
||
use app\dao\activity\coupon\StoreCouponUserDao;
|
||
use app\services\product\category\StoreProductCategoryServices;
|
||
use think\annotation\Inject;
|
||
|
||
/**
|
||
* Class StoreCouponUserServices
|
||
* @package app\services\activity\coupon
|
||
* @mixin StoreCouponUserDao
|
||
*/
|
||
class StoreCouponUserServices extends BaseServices
|
||
{
|
||
/**
|
||
* @var StoreCouponUserDao
|
||
*/
|
||
#[Inject]
|
||
protected StoreCouponUserDao $dao;
|
||
|
||
/**
|
||
* 获取列表
|
||
* @param array $where
|
||
* @return array
|
||
*/
|
||
public function issueLog(array $where)
|
||
{
|
||
[$page, $limit] = $this->getPageValue();
|
||
$list = $this->dao->getList($where, 'uid,add_time', ['userInfo'], $page, $limit);
|
||
foreach ($list as &$item) {
|
||
$item['add_time'] = date('Y-m-d H:i:s', $item['add_time']);
|
||
}
|
||
$count = $this->dao->count($where);
|
||
return compact('list', 'count');
|
||
}
|
||
|
||
/**
|
||
* 获取列表
|
||
* @param array $where
|
||
* @return array
|
||
* @throws \think\db\exception\DataNotFoundException
|
||
* @throws \think\db\exception\DbException
|
||
* @throws \think\db\exception\ModelNotFoundException
|
||
*/
|
||
public function systemPage(array $where)
|
||
{
|
||
[$page, $limit] = $this->getPageValue();
|
||
$list = $this->dao->getList($where, '*', ['issue'], $page, $limit);
|
||
$count = 0;
|
||
if ($list) {
|
||
/** @var UserServices $userServices */
|
||
$userServices = app()->make(UserServices::class);
|
||
$userAll = $userServices->getColumn([['uid', 'IN', array_column($list, 'uid')]], 'uid,nickname', 'uid');
|
||
foreach ($list as &$item) {
|
||
$item['nickname'] = $userAll[$item['uid']]['nickname'] ?? '';
|
||
}
|
||
$count = $this->dao->count($where);
|
||
}
|
||
return compact('list', 'count');
|
||
}
|
||
|
||
/**
|
||
* 获取用户优惠券
|
||
* @param int $id
|
||
* @param int $status
|
||
* @return array
|
||
* @throws \think\db\exception\DataNotFoundException
|
||
* @throws \think\db\exception\DbException
|
||
* @throws \think\db\exception\ModelNotFoundException
|
||
*/
|
||
public function getUserCouponList(int $id, int $status = -1)
|
||
{
|
||
[$page, $limit] = $this->getPageValue();
|
||
$where = ['uid' => $id];
|
||
if ($status != -1) $where['status'] = $status;
|
||
$list = $this->dao->getList($where, '*', ['issue'], $page, $limit);
|
||
foreach ($list as &$item) {
|
||
$item['_add_time'] = date('Y-m-d H:i:s', $item['add_time']);
|
||
$item['_end_time'] = date('Y-m-d H:i:s', $item['end_time']);
|
||
if (!$item['coupon_time']) {
|
||
$item['coupon_time'] = ceil(($item['end_use_time'] - $item['start_use_time']) / '86400');
|
||
}
|
||
}
|
||
$count = $this->dao->count($where);
|
||
return compact('list', 'count');
|
||
}
|
||
|
||
/**
|
||
* 恢复优惠券
|
||
* @param int $id
|
||
* @return bool|mixed
|
||
*/
|
||
public function recoverCoupon(int $id)
|
||
{
|
||
$status = $this->dao->value(['id' => $id], 'status');
|
||
if ($status) return $this->dao->update($id, ['status' => 0, 'use_time' => 0]);
|
||
else return true;
|
||
}
|
||
|
||
/**
|
||
* 过期优惠卷失效
|
||
*/
|
||
public function checkInvalidCoupon($uid = 0)
|
||
{
|
||
$this->dao->update([['uid', '=', $uid], ['end_time', '<', time()], ['status', '=', '0']], ['status' => 2]);
|
||
}
|
||
|
||
/**
|
||
* 获取用户有效优惠劵数量
|
||
* @param int $uid
|
||
* @return int
|
||
*/
|
||
public function getUserValidCouponCount(int $uid)
|
||
{
|
||
$this->checkInvalidCoupon($uid);
|
||
return $this->dao->getCount(['uid' => $uid, 'status' => 0]);
|
||
}
|
||
|
||
/**
|
||
* 下单页面显示可用优惠券
|
||
* @param $uid
|
||
* @param $cartGroup
|
||
* @param $price
|
||
* @return array
|
||
*/
|
||
public function getUseableCouponList(int $uid, array $cartGroup)
|
||
{
|
||
$userCoupons = $this->dao->getUserAllCoupon($uid);
|
||
$result = [];
|
||
if ($userCoupons) {
|
||
$cartInfo = $cartGroup['valid'];
|
||
$promotions = $cartGroup['promotions'] ?? [];
|
||
$promotionsList = [];
|
||
if ($promotions) {
|
||
$promotionsList = array_combine(array_column($promotions, 'id'), $promotions);
|
||
}
|
||
$isOverlay = function ($cart) use ($promotionsList) {
|
||
$productInfo = $cart['productInfo'] ?? [];
|
||
if (!$productInfo) {
|
||
return false;
|
||
}
|
||
if (isset($cart['promotions_id']) && $cart['promotions_id']) {
|
||
foreach ($cart['promotions_id'] as $key => $promotions_id) {
|
||
$promotions = $promotionsList[$promotions_id] ?? [];
|
||
if ($promotions && $promotions['promotions_type'] != 4) {
|
||
$overlay = is_string($promotions['overlay']) ? explode(',', $promotions['overlay']) : $promotions['overlay'];
|
||
if (!in_array(5, $overlay)) {
|
||
return false;
|
||
}
|
||
}
|
||
}
|
||
}
|
||
return true;
|
||
};
|
||
/** @var StoreProductCategoryServices $storeCategoryServices */
|
||
$storeCategoryServices = app()->make(StoreProductCategoryServices::class);
|
||
/** @var StoreBrandServices $storeBrandServices */
|
||
$storeBrandServices = app()->make(StoreBrandServices::class);
|
||
foreach ($userCoupons as $coupon) {
|
||
$price = 0;
|
||
$count = 0;
|
||
switch ($coupon['applicable_type']) {
|
||
case 0:
|
||
foreach ($cartInfo as $cart) {
|
||
if (!$isOverlay($cart)) continue;
|
||
$price = bcadd((string)$price, (string)bcmul((string)$cart['truePrice'], (string)$cart['cart_num'], 2), 2);
|
||
$count++;
|
||
}
|
||
break;
|
||
case 1://品类券
|
||
$cateGorys = $storeCategoryServices->getAllById((int)$coupon['category_id']);
|
||
if ($cateGorys) {
|
||
$cateIds = array_column($cateGorys, 'id');
|
||
foreach ($cartInfo as $cart) {
|
||
if (!$isOverlay($cart)) continue;
|
||
if (isset($cart['productInfo']['cate_id']) && array_intersect(explode(',', $cart['productInfo']['cate_id']), $cateIds)) {
|
||
$price = bcadd((string)$price, (string)bcmul((string)$cart['truePrice'], (string)$cart['cart_num'], 2), 2);
|
||
$count++;
|
||
}
|
||
}
|
||
}
|
||
break;
|
||
case 2:
|
||
foreach ($cartInfo as $cart) {
|
||
if (!$isOverlay($cart)) continue;
|
||
if (isset($cart['product_id']) && in_array($cart['product_id'], explode(',', $coupon['product_id']))) {
|
||
$price = bcadd((string)$price, (string)bcmul((string)$cart['truePrice'], (string)$cart['cart_num'], 2), 2);
|
||
$count++;
|
||
}
|
||
}
|
||
break;
|
||
case 3://品牌
|
||
$brands = $storeBrandServices->getAllById((int)$coupon['brand_id']);
|
||
if ($brands) {
|
||
$brandIds = array_column($brands, 'id');
|
||
foreach ($cartInfo as $cart) {
|
||
if (!$isOverlay($cart)) continue;
|
||
if (isset($cart['productInfo']['brand_id']) && in_array($cart['productInfo']['brand_id'], $brandIds)) {
|
||
$price = bcadd((string)$price, (string)bcmul((string)$cart['truePrice'], (string)$cart['cart_num'], 2), 2);
|
||
$count++;
|
||
}
|
||
}
|
||
}
|
||
break;
|
||
}
|
||
if ($count && $coupon['use_min_price'] <= $price) {
|
||
$coupon_data['id'] = $coupon['id'];
|
||
$coupon_data['cid'] = $coupon['cid'];
|
||
$coupon_data['type'] = $coupon['applicable_type'];
|
||
$coupon_data['applicable_type'] = $coupon['applicable_type'];
|
||
$coupon_data['receive_type'] = $coupon['receive_type'];
|
||
$coupon_data['start_time'] = $coupon['start_time'] ? date('Y-m-d', $coupon['start_time']) : date('Y-m-d', $coupon['add_time']);
|
||
$coupon_data['add_time'] = date('Y-m-d', $coupon['add_time']);
|
||
$coupon_data['end_time'] = date('Y-m-d', $coupon['end_time']);
|
||
$coupon_data['title'] = $coupon['coupon_title'];
|
||
$coupon_data['use_min_price'] = floatval($coupon['use_min_price']);
|
||
$coupon_data['coupon_type'] = $coupon['coupon_type'];
|
||
$coupon_data['coupon_price'] = floatval($coupon['coupon_price']);
|
||
$result[] = $coupon_data;
|
||
}
|
||
}
|
||
}
|
||
return $result;
|
||
}
|
||
|
||
/**
|
||
* 用户领取优惠券
|
||
* @param $uid
|
||
* @param $issueCouponInfo
|
||
* @param string $type
|
||
* @return mixed
|
||
*/
|
||
public function addUserCoupon($uid, $issueCouponInfo, string $type = 'get')
|
||
{
|
||
$data = [];
|
||
$data['cid'] = $issueCouponInfo['id'];
|
||
$data['uid'] = $uid;
|
||
$data['coupon_title'] = $issueCouponInfo['title'];
|
||
$data['coupon_price'] = $issueCouponInfo['coupon_price'];
|
||
$data['use_min_price'] = $issueCouponInfo['use_min_price'];
|
||
$data['add_time'] = time();
|
||
if ($issueCouponInfo['coupon_time']) {
|
||
$data['start_time'] = $data['add_time'];
|
||
$data['end_time'] = $data['add_time'] + $issueCouponInfo['coupon_time'] * 86400;
|
||
} else {
|
||
$data['start_time'] = $issueCouponInfo['start_use_time'];
|
||
$data['end_time'] = $issueCouponInfo['end_use_time'];
|
||
}
|
||
$data['type'] = $type;
|
||
return $this->dao->save($data);
|
||
}
|
||
|
||
/**会员领取优惠券
|
||
* @param $uid
|
||
* @param $issueCouponInfo
|
||
* @param string $type
|
||
* @return mixed
|
||
*/
|
||
public function addMemberUserCoupon($uid, $issueCouponInfo, $type = 'get')
|
||
{
|
||
$data = [];
|
||
$data['cid'] = $issueCouponInfo['id'];
|
||
$data['uid'] = $uid;
|
||
$data['coupon_title'] = $issueCouponInfo['title'];
|
||
$data['coupon_price'] = $issueCouponInfo['coupon_price'];
|
||
$data['use_min_price'] = $issueCouponInfo['use_min_price'];
|
||
$data['add_time'] = time();
|
||
$data['start_time'] = strtotime(date('Y-m-d 00:00:00', time()));
|
||
$data['end_time'] = strtotime(date('Y-m-d 23:59:59', strtotime('+30 day')));
|
||
$data['type'] = $type;
|
||
return $this->dao->save($data);
|
||
}
|
||
|
||
/**
|
||
* 获取用户已领取的优惠卷
|
||
* @param int $uid
|
||
* @param $type
|
||
* @return array
|
||
* @throws \think\db\exception\DataNotFoundException
|
||
* @throws \think\db\exception\DbException
|
||
* @throws \think\db\exception\ModelNotFoundException
|
||
*/
|
||
public function getUserCounpon(int $uid, $types, $type)
|
||
{
|
||
$where = [];
|
||
$where['uid'] = $uid;
|
||
switch ($types) {
|
||
case 1:
|
||
$where['status'] = 1;
|
||
break;
|
||
case 2:
|
||
$where['status'] = 2;
|
||
break;
|
||
default:
|
||
$where['status'] = 0;
|
||
break;
|
||
}
|
||
$where['issue_type'] = $type;
|
||
[$page, $limit] = $this->getPageValue();
|
||
$list = $this->dao->getCouponListByOrder($where, 'status ASC,add_time DESC', $page, $limit);
|
||
/** @var StoreProductCategoryServices $categoryServices */
|
||
$categoryServices = app()->make(StoreProductCategoryServices::class);
|
||
$category = $categoryServices->getColumn([], 'pid,cate_name', 'id');
|
||
foreach ($list as &$item) {
|
||
if ($item['category_id'] && isset($category[$item['category_id']])) {
|
||
$item['category_type'] = $category[$item['category_id']]['pid'] == 0 ? 1 : 2;
|
||
$item['category_name'] = $category[$item['category_id']]['cate_name'];
|
||
} else {
|
||
$item['category_type'] = '';
|
||
$item['category_name'] = '';
|
||
}
|
||
}
|
||
return $list ? $this->tidyCouponList($list) : [];
|
||
}
|
||
|
||
/**
|
||
* 我的优惠券数量
|
||
* @param int $uid
|
||
* @return array
|
||
* @throws \think\db\exception\DbException
|
||
*/
|
||
public function getUserCounponNum(int $uid): array
|
||
{
|
||
$data['not_used'] = $this->dao->count(['uid' => $uid, 'status' => 0]); // 未使用
|
||
$data['used'] = $this->dao->count(['uid' => $uid, 'status' => 1]);// 已使用
|
||
$data['expired'] = $this->dao->count(['uid' => $uid, 'status' => 2]);// 已过期
|
||
return $data;
|
||
}
|
||
|
||
/**
|
||
* 格式化优惠券
|
||
* @param $couponList
|
||
* @return mixed
|
||
*/
|
||
public function tidyCouponList($couponList)
|
||
{
|
||
$time = time();
|
||
foreach ($couponList as &$coupon) {
|
||
if ($coupon['status'] == '已使用') {
|
||
$coupon['_type'] = 0;
|
||
$coupon['_msg'] = '已使用';
|
||
$coupon['pc_type'] = 0;
|
||
$coupon['pc_msg'] = '已使用';
|
||
} else if ($coupon['status'] == '已过期') {
|
||
$coupon['is_fail'] = 1;
|
||
$coupon['_type'] = 0;
|
||
$coupon['_msg'] = '已过期';
|
||
$coupon['pc_type'] = 0;
|
||
$coupon['pc_msg'] = '已过期';
|
||
} else if ($coupon['end_time'] < $time) {
|
||
$coupon['is_fail'] = 1;
|
||
$coupon['_type'] = 0;
|
||
$coupon['_msg'] = '已过期';
|
||
$coupon['pc_type'] = 0;
|
||
$coupon['pc_msg'] = '已过期';
|
||
} else if ($coupon['start_time'] > $time) {
|
||
$coupon['_type'] = 0;
|
||
$coupon['_msg'] = '未开始';
|
||
$coupon['pc_type'] = 1;
|
||
$coupon['pc_msg'] = '未开始';
|
||
} else {
|
||
if ($coupon['start_time'] + 3600 * 24 > $time) {
|
||
$coupon['_type'] = 2;
|
||
$coupon['_msg'] = '立即使用';
|
||
$coupon['pc_type'] = 1;
|
||
$coupon['pc_msg'] = '可使用';
|
||
} else {
|
||
$coupon['_type'] = 1;
|
||
$coupon['_msg'] = '立即使用';
|
||
$coupon['pc_type'] = 1;
|
||
$coupon['pc_msg'] = '可使用';
|
||
}
|
||
}
|
||
$coupon['add_time'] = $coupon['_add_time'] = $coupon['start_time'] ? date('Y/m/d', $coupon['start_time']) : date('Y/m/d', $coupon['add_time']);
|
||
$coupon['end_time'] = $coupon['_end_time'] = date('Y/m/d', $coupon['end_time']);
|
||
$coupon['use_min_price'] = floatval($coupon['use_min_price']);
|
||
$coupon['coupon_price'] = floatval($coupon['coupon_price']);
|
||
}
|
||
return $couponList;
|
||
}
|
||
|
||
/**
|
||
* 获取会员优惠券列表
|
||
* @param $uid
|
||
* @return array|mixed
|
||
* @throws \think\db\exception\DataNotFoundException
|
||
* @throws \think\db\exception\DbException
|
||
* @throws \think\db\exception\ModelNotFoundException
|
||
*/
|
||
public function getMemberCoupon($uid)
|
||
{
|
||
if (!$uid) return [];
|
||
[$page, $limit] = $this->getPageValue();
|
||
if (!$page && !$limit) {
|
||
$page = 0;
|
||
$limit = 4;
|
||
}
|
||
/** @var StoreCouponIssueServices $couponIssueService */
|
||
$couponIssueService = app()->make(StoreCouponIssueServices::class);
|
||
$couponWhere['category'] = 2;
|
||
$couponInfo = $couponIssueService->getMemberCouponIssueList($couponWhere, $page, $limit, ['used' => function ($query) use ($uid) {
|
||
$query->where('uid', $uid);
|
||
}]);
|
||
if ($couponInfo) {
|
||
$time = time();
|
||
foreach ($couponInfo as $k => &$coupon) {
|
||
$coupon['type_name'] = $couponIssueService->_couponType[$coupon['type']];
|
||
$coupon['is_use'] = $uid ? isset($coupon['used']) : false;
|
||
$coupon['used'] = $coupon['used'][0] ?? [];
|
||
if (isset($coupon['used']) && $coupon['used']) {
|
||
if ($coupon['used']['status'] == '已使用') {
|
||
$coupon['used']['_type'] = 0;
|
||
$coupon['used']['_msg'] = '已使用';
|
||
$coupon['used']['pc_type'] = 0;
|
||
$coupon['used']['pc_msg'] = '已使用';
|
||
} else if ($coupon['used']['status'] == '已过期') {
|
||
$coupon['used']['is_fail'] = 1;
|
||
$coupon['used']['_type'] = 0;
|
||
$coupon['used']['_msg'] = '已过期';
|
||
$coupon['used']['pc_type'] = 0;
|
||
$coupon['used']['pc_msg'] = '已过期';
|
||
} else if ($coupon['used']['end_time'] < $time) {
|
||
$coupon['used']['is_fail'] = 1;
|
||
$coupon['used']['_type'] = 0;
|
||
$coupon['used']['_msg'] = '已过期';
|
||
$coupon['used']['pc_type'] = 0;
|
||
$coupon['used']['pc_msg'] = '已过期';
|
||
} else if ($coupon['used']['start_time'] > $time) {
|
||
$coupon['used']['_type'] = 0;
|
||
$coupon['used']['_msg'] = '未开始';
|
||
$coupon['used']['pc_type'] = 1;
|
||
$coupon['used']['pc_msg'] = '未开始';
|
||
} else {
|
||
if ($coupon['used']['start_time'] + 3600 * 24 > $time) {
|
||
$coupon['used']['_type'] = 2;
|
||
$coupon['used']['_msg'] = '立即使用';
|
||
$coupon['used']['pc_type'] = 1;
|
||
$coupon['used']['pc_msg'] = '可使用';
|
||
} else {
|
||
$coupon['used']['_type'] = 1;
|
||
$coupon['used']['_msg'] = '立即使用';
|
||
$coupon['used']['pc_type'] = 1;
|
||
$coupon['used']['pc_msg'] = '可使用';
|
||
}
|
||
}
|
||
$coupon['used']['end_time'] = $coupon['used']['_end_time'] = date('Y/m/d', $coupon['used']['end_time']);
|
||
$coupon['used']['_add_time'] = $coupon['used']['start_time'] ? date('Y/m/d', $coupon['used']['start_time']) : date('Y/m/d', $coupon['add_time']);
|
||
}
|
||
|
||
$coupon['add_time'] = date('Y/m/d', $coupon['add_time']);
|
||
$coupon['start_use_time'] = date('Y/m/d', $coupon['start_use_time']);
|
||
$coupon['end_use_time'] = date('Y/m/d', $coupon['end_use_time']);
|
||
$coupon['use_min_price'] = floatval($coupon['use_min_price']);
|
||
$coupon['coupon_price'] = floatval($coupon['coupon_price']);
|
||
}
|
||
}
|
||
return $couponInfo ?: [];
|
||
}
|
||
|
||
|
||
/**
|
||
* 使用优惠券验证
|
||
* @param int $couponId
|
||
* @param int $uid
|
||
* @param array $cartInfo
|
||
* @param array $promotions
|
||
* @return bool
|
||
*/
|
||
public function useCoupon(int $couponId, int $uid, array $cartInfo, array $promotions = [])
|
||
{
|
||
if (!$couponId || !$uid || !$cartInfo) {
|
||
return true;
|
||
}
|
||
/** @var StorePromotionsServices $promotionsServices */
|
||
$promotionsServices = app()->make(StorePromotionsServices::class);
|
||
[$couponInfo, $couponPrice] = $promotionsServices->useCoupon($couponId, $uid, $cartInfo, $promotions);
|
||
if ($couponInfo) {
|
||
$this->dao->useCoupon($couponId);
|
||
}
|
||
return true;
|
||
}
|
||
}
|