Files
huangjingfen/pro_v3.5.1_副本/crmeb/services/wechat/MiniProgram.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

699 lines
22 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 crmeb\services\wechat;
use crmeb\services\wechat\client\miniprogram\MediaCheckClient;
use EasyWeChat\Kernel\Exceptions\BadRequestException;
use EasyWeChat\Kernel\Exceptions\RuntimeException;
use EasyWeChat\MiniApp\Application;
use GuzzleHttp\Exception\GuzzleException;
use EasyWeChat\Kernel\HttpClient\Response;
use Symfony\Contracts\HttpClient\ResponseInterface;
use crmeb\services\wechat\config\MiniProgramConfig;
use crmeb\services\wechat\client\miniprogram\AuthClient;
use crmeb\services\wechat\client\miniprogram\LiveClient;
use EasyWeChat\Kernel\Exceptions\InvalidConfigException;
use crmeb\services\wechat\client\miniprogram\OrderClient;
use crmeb\services\wechat\client\official\MaterialClient;
use EasyWeChat\Kernel\Exceptions\InvalidArgumentException;
use crmeb\services\wechat\client\miniprogram\SubscribeClient;
use Symfony\Contracts\HttpClient\Exception\ClientExceptionInterface;
use Symfony\Contracts\HttpClient\Exception\ServerExceptionInterface;
use Symfony\Contracts\HttpClient\Exception\TransportExceptionInterface;
use Symfony\Contracts\HttpClient\Exception\RedirectionExceptionInterface;
use think\exception\ValidateException;
use think\facade\Log;
/**
* 小程序服务
* Class MiniProgram
* @package crmeb\services\wechat
* @method AuthClient auth() 授权
* @method LiveClient live() 直播
* @method MaterialClient material() 素材
* @method OrderClient order() 订单
* @method SubscribeClient subscribe() 订阅消息
* @method MediaCheckClient media_check() 敏感词
*/
class MiniProgram extends BaseApplication
{
/**
* @var string
*/
protected string $name = 'miniprogram';
/**
* @var MiniProgramConfig
*/
protected MiniProgramConfig $config;
/**
* @var Application
*/
protected $application;
/**
* MiniProgram constructor.
*/
public function __construct()
{
$this->debug = DefaultConfig::value('logger');
}
/**
* 初始化
* @return Application
* @throws InvalidArgumentException
*/
public function application(): Application
{
if (!$this->application) {
$this->application = new Application($this->config->all());
$this->setHttpClient($this->application);
$this->setRequest($this->application);
$this->setLogger($this->application);
$this->setCache($this->application);
}
return $this->application;
}
/**
* @return \think\Response
* @throws InvalidArgumentException
* @throws BadRequestException
* @throws RuntimeException
* @throws \ReflectionException
* @throws \Throwable
* @author 等风来
* @email 136327134@qq.com
* @date 2023/10/7
*/
public static function serve(): \think\Response
{
$make = self::instance();
$server = $make->application()->getServer();
$server->with($make->pushMessageHandler);
$response = $server->serve();
return response($response->getBody());
}
/**
* @return MiniProgram
*/
public static function instance(): static
{
$instance = app()->make(self::class);
$instance->config = app()->make(MiniProgramConfig::class);
return $instance;
}
/**
* 获得用户信息 根据code 获取session_key
* @param string $code
* @return Response|ResponseInterface
*/
public static function getUserInfo(string $code)
{
try {
$response = self::instance()->auth()->session($code);
self::logger('获得用户信息 根据code 获取session_key', compact('code'), $response);
return $response;
} catch (\Throwable $e) {
throw new WechatException($e->getMessage());
}
}
/**
* 解密数据
* @param string $sessionKey
* @param string $iv
* @param string $encryptData
* @return array
*/
public static function decryptData(string $sessionKey, string $iv, string $encryptData)
{
$response = self::instance()->auth()->decryptData($sessionKey, $iv, $encryptData);
self::logger('解密数据', compact('sessionKey', 'iv', 'encryptData'), $response);
return $response;
}
/**
* 获取小程序码:适用于需要的码数量极多,或仅临时使用的业务场景
* @param string $scene
* @param string $path
* @param int $width
* @return Response|string
* @throws TransportExceptionInterface
*/
public static function appCodeUnlimit(string $scene, string $path = '', int $width = 0)
{
$optional = [
'page' => $path,
'width' => $width
];
if (!$optional['page']) {
unset($optional['page']);
}
if (!$optional['width']) {
unset($optional['width']);
}
try {
$response = self::instance()->auth()->getUnlimit($scene, $optional)->getContent();
$res = json_decode($response);
if (isset($res->errcode) && $res->errcode == 40001) {
self::instance()->application()->getAccessToken()->refresh();
$response = self::instance()->auth()->getUnlimit($scene, $optional)->getContent();
}
} catch (\Throwable $e) {
Log::error('获取小程序码错误:' . $e->getMessage());
$response = [];
}
return $response;
}
/**
* 获取短链
* @param string $page
* @param string $query
* @return Response|string|ResponseInterface
* User: liusl
* DateTime: 2024/11/23 下午2:54
*/
public static function generateUrlLink(string $page, string $query)
{
try {
return self::instance()->auth()->generateUrlLink($page, $query);
} catch (\Throwable $e) {
Log::error('获取小程序码错误:' . $e->getMessage());
return '';
}
}
/**
* 发送订阅消息
* @param string $touser
* @param string $templateId
* @param array $data
* @param string $link
* @return Response|ResponseInterface
* @throws InvalidArgumentException
* @throws InvalidConfigException
* @throws GuzzleException
*/
public static function sendSubscribeTemlate(string $touser, string $templateId, array $data, string $link = '')
{
$response = self::instance()->subscribe()->send([
'template_id' => $templateId,
'touser' => $touser,
'page' => $link,
'data' => $data
]);
self::logger('发送订阅消息', compact('templateId', 'touser', 'link', 'data'), $response);
return $response;
}
/**
* 添加订阅消息模版
* @param string $tid
* @param array $kidList
* @param string $sceneDesc
* @return mixed
*/
public static function addSubscribeTemplate(string $tid, array $kidList, string $sceneDesc = '')
{
try {
$res = self::instance()->subscribe()->addTemplate($tid, $kidList, $sceneDesc);
self::logger('添加订阅消息模版', compact('tid', 'kidList', 'sceneDesc'), $res);
if (isset($res['errcode']) && $res['errcode'] == 0 && isset($res['priTmplId'])) {
return $res['priTmplId'];
} else {
throw new WechatException($res['errmsg']);
}
} catch (\Throwable $e) {
throw new WechatException($e);
}
}
/**
* 删除订阅消息
* @param string $templateId
* @return Response|ResponseInterface
*/
public static function delSubscribeTemplate(string $templateId)
{
try {
$response = self::instance()->subscribe()->deleteTemplate($templateId);
self::logger('删除订阅消息', compact('templateId'), $response);
return $response;
} catch (\Throwable $e) {
throw new WechatException($e->getMessage());
}
}
/**
* 获取模版标题的关键词列表
* @param string $tid
* @return mixed
*/
public static function getSubscribeTemplateKeyWords(string $tid)
{
try {
$res = self::instance()->subscribe()->getTemplateKeywords($tid);
self::logger('获取模版标题的关键词列表', compact('tid'), $res);
if (isset($res['errcode']) && $res['errcode'] == 0 && isset($res['data'])) {
return $res['data'];
} else {
throw new WechatException($res['errmsg']);
}
} catch (\Throwable $e) {
throw new WechatException($e);
}
}
/**
* 获取直播列表
* @param int $page
* @param int $limit
* @return array
*/
public static function getLiveInfo(int $page = 1, int $limit = 10)
{
try {
$res = self::instance()->live()->getRooms($page, $limit);
// self::logger('获取直播列表', compact('page', 'limit'), $res);
if (isset($res['errcode']) && $res['errcode'] == 0 && isset($res['room_info']) && $res['room_info']) {
return $res['room_info'];
} else {
return [];
}
} catch (\Throwable $e) {
return [];
}
}
/**
* 获取直播回放
* @param int $room_id
* @param int $page
* @param int $limit
* @return mixed
*/
public static function getLivePlayback(int $room_id, int $page = 1, int $limit = 10)
{
try {
$res = self::instance()->live()->getPlaybacks($room_id, $page, $limit);
self::logger('获取直播回放', compact('room_id', 'page', 'limit'), $res);
if (isset($res['errcode']) && $res['errcode'] == 0 && isset($res['live_replay'])) {
return $res['live_replay'];
} else {
throw new WechatException($res['errmsg']);
}
} catch (\Throwable $e) {
throw new WechatException(ErrorMessage::getValidMessgae($e));
}
}
/**
* 创建直播间
* @param array $data
* @return mixed
*/
public static function createLiveRoom(array $data)
{
try {
$res = self::instance()->live()->createRoom($data);
self::logger('创建直播间', compact('data'), $res);
if (isset($res['errcode']) && $res['errcode'] == 0 && isset($res['roomId'])) {
return $res;
} else {
throw new WechatException($res['errmsg']);
}
} catch (\Throwable $e) {
throw new WechatException(ErrorMessage::getValidMessgae($e));
}
}
/**
* 直播间添加商品
* @param int $roomId
* @param $ids
* @return bool
*/
public static function roomAddGoods(int $roomId, $ids)
{
try {
$res = self::instance()->live()->roomAddGoods($roomId, $ids);
self::logger('直播间添加商品', compact('roomId', 'ids'), $res);
if (isset($res['errcode']) && $res['errcode'] == 0) {
return true;
} else {
throw new WechatException($res['errmsg']);
}
} catch (\Throwable $e) {
throw new WechatException(ErrorMessage::getValidMessgae($e));
}
}
/**
* 获取商品列表
* @param int $status
* @param int $page
* @param int $limit
* @return mixed
*/
public static function getGoodsList(int $status = 2, int $page = 1, int $limit = 10)
{
try {
$res = self::instance()->live()->getGoodsList($status, $page, $limit);
self::logger('获取商品列表', compact('status', 'page', 'limit'), $res);
if (isset($res['errcode']) && $res['errcode'] == 0 && isset($res['goods'])) {
return $res['goods'];
} else {
throw new WechatException($res['errmsg']);
}
} catch (\Throwable $e) {
throw new WechatException(ErrorMessage::getValidMessgae($e));
}
}
/**
* 获取商品详情
* @param $goods_ids
* @return mixed
*/
public static function getGooodsInfo($goods_ids)
{
try {
$res = self::instance()->live()->getGooodsInfo($goods_ids);
self::logger('获取商品详情', compact('goods_ids'), $res);
if (isset($res['errcode']) && $res['errcode'] == 0 && isset($res['goods'])) {
return $res['goods'];
} else {
throw new WechatException($res['errmsg']);
}
} catch (\Throwable $e) {
throw new WechatException(ErrorMessage::getValidMessgae($e));
}
}
/**
* 添加商品
* @param string $coverImgUrl
* @param string $name
* @param int $priceType
* @param string $url
* @param $price
* @param string $price2
* @return mixed
*/
public static function addGoods(string $coverImgUrl, string $name, int $priceType, string $url, $price, $price2 = '')
{
try {
$res = self::instance()->live()->addGoods($coverImgUrl, $name, $priceType, $url, $price, $price2);
self::logger('添加商品', compact('coverImgUrl', 'name', 'priceType', 'url', 'price', 'price2'), $res);
if (isset($res['errcode']) && $res['errcode'] == 0 && isset($res['goodsId'])) {
return $res;
} else {
throw new WechatException($res['errmsg']);
}
} catch (\Throwable $e) {
throw new WechatException(ErrorMessage::getValidMessgae($e));
}
}
/**
* 商品撤回审核
* @param int $goodsId
* @param $auditId
* @return bool
*/
public static function resetauditGoods(int $goodsId, $auditId)
{
try {
$res = self::instance()->live()->resetauditGoods($goodsId, $auditId);
self::logger('商品撤回审核', compact('goodsId', 'auditId'), $res);
if (isset($res['errcode']) && $res['errcode'] == 0) {
return true;
} else {
throw new WechatException($res['errmsg']);
}
} catch (\Throwable $e) {
throw new WechatException(ErrorMessage::getValidMessgae($e));
}
}
/**
* 商品重新提交审核
* @param int $goodsId
* @return mixed
*/
public static function auditGoods(int $goodsId)
{
try {
$res = self::instance()->live()->auditGoods($goodsId);
self::logger('商品重新提交审核', compact('goodsId'), $res);
if (isset($res['errcode']) && $res['errcode'] == 0 && isset($res['auditId'])) {
return $res['auditId'];
} else {
throw new WechatException($res['errmsg']);
}
} catch (\Throwable $e) {
throw new WechatException(ErrorMessage::getValidMessgae($e));
}
}
/**
* 删除商品
* @param int $goodsId
* @return bool
*/
public static function deleteGoods(int $goodsId)
{
try {
$res = self::instance()->live()->deleteGoods($goodsId);
self::logger('删除商品', compact('goodsId'), $res);
if (isset($res['errcode']) && $res['errcode'] == 0) {
return true;
} else {
throw new WechatException($res['errmsg']);
}
} catch (\Throwable $e) {
throw new WechatException(ErrorMessage::getValidMessgae($e));
}
}
/**
* 更新商品
* @param int $goodsId
* @param string $coverImgUrl
* @param string $name
* @param int $priceType
* @param string $url
* @param $price
* @param string $price2
* @return bool
*/
public static function updateGoods(int $goodsId, string $coverImgUrl, string $name, int $priceType, string $url, $price, $price2 = '')
{
try {
$res = self::instance()->live()->updateGoods($goodsId, $coverImgUrl, $name, $priceType, $url, $price, $price2);
self::logger('更新商品', compact('goodsId', 'coverImgUrl', 'name', 'priceType', 'url', 'price', 'price2'), $res);
if (isset($res['errcode']) && $res['errcode'] == 0) {
return true;
} else {
throw new WechatException($res['errmsg']);
}
} catch (\Throwable $e) {
throw new WechatException(ErrorMessage::getValidMessgae($e));
}
}
/**
* 获取成员列表
* @param int $role
* @param int $page
* @param int $limit
* @param string $keyword
* @return mixed
*/
public static function getRoleList(int $role = 2, int $page = 0, int $limit = 30, string $keyword = '')
{
try {
$res = self::instance()->live()->getRoleList($role, $page, $limit, $keyword);
self::logger('获取成员列表', compact('role', 'page', 'limit', 'keyword'), $res);
if (isset($res['errcode']) && $res['errcode'] == 0 && isset($res['list'])) {
return $res['list'];
} else {
throw new WechatException($res['errmsg']);
}
} catch (\Throwable $e) {
throw new WechatException(ErrorMessage::getValidMessgae($e));
}
}
/**
* 小程序临时素材上传
* @param string $path
* @param string $type
* @return WechatResponse
* @throws TransportExceptionInterface
* @throws ClientExceptionInterface
* @throws RedirectionExceptionInterface
* @throws ServerExceptionInterface
*/
public static function temporaryUpload(string $path, string $type = 'image')
{
$response = self::instance()->material()->upload($type, $path);
self::logger('小程序-临时素材上传', compact('path', 'type'), $response);
return new WechatResponse($response);
}
/**
* 上传订单
* @param string $out_trade_no 订单号(商城订单好)
* @param int $logistics_type 物流模式发货方式枚举值1、实体物流配送采用快递公司进行实体物流配送形式 2、同城配送 3、虚拟商品虚拟商品例如话费充值点卡等无实体配送形式 4、用户自提
* @param array $shipping_list 物流信息列表,发货物流单列表,支持统一发货(单个物流单)和分拆发货(多个物流单)两种模式,多重性: [1, 10]
* @param string $payer_openid 支付者,支付者信息
* @param string $path
* @param int $delivery_mode 发货模式发货模式枚举值1、UNIFIED_DELIVERY统一发货2、SPLIT_DELIVERY分拆发货 示例值: UNIFIED_DELIVERY
* @param bool $is_all_delivered 分拆发货模式时必填,用于标识分拆发货模式下是否已全部发货完成,只有全部发货完成的情况下才会向用户推送发货完成通知。示例值: true/false
* @return array
* @throws TransportExceptionInterface
*/
public static function shippingByTradeNo(string $out_trade_no, int $logistics_type, array $shipping_list, string $payer_openid, string $path, int $delivery_mode = 1, bool $is_all_delivered = true)
{
return self::instance()->order()->shippingByTradeNo($out_trade_no, $logistics_type, $shipping_list, $payer_openid, $path, $delivery_mode, $is_all_delivered);
}
/**
* 合单
* @param string $out_trade_no
* @param int $logistics_type
* @param array $sub_orders
* @param string $payer_openid
* @param int $delivery_mode
* @param bool $is_all_delivered
* @return array
* @throws TransportExceptionInterface
*/
public static function combinedShippingByTradeNo(string $out_trade_no, int $logistics_type, array $sub_orders, string $payer_openid, int $delivery_mode = 2, bool $is_all_delivered = false)
{
return self::instance()->order()->combinedShippingByTradeNo($out_trade_no, $logistics_type, $sub_orders, $payer_openid, $delivery_mode, $is_all_delivered);
}
/**
* 签收通知
* @param string $merchant_trade_no
* @param string $received_time
* @return array
* @throws TransportExceptionInterface
*/
public static function notifyConfirmByTradeNo(string $merchant_trade_no, string $received_time)
{
return self::instance()->order()->notifyConfirmByTradeNo($merchant_trade_no, $received_time);
}
/**
* 判断是否开通
* @return bool
* @throws HttpException
* @date 2023/05/17
* @author yyw
*/
public static function isManaged()
{
return self::instance()->order()->checkManaged();
}
/**
* 设置小修跳转路径
* @param $path
* @return array
* @throws HttpException|TransportExceptionInterface
*/
public static function setMesJumpPathAndCheck($path)
{
return self::instance()->order()->setMesJumpPathAndCheck($path);
}
/**
* 敏感词验证
* @param string $content
* @param int $scene
* @param string $openId
* @return true
* User: liusl
* DateTime: 2024/11/26 下午4:29
*/
public static function msgSecCheck(string $content)
{
// try{
//scene 场景枚举值1 资料2 评论3 论坛4 社交日志)
$res = self::instance()->media_check()->msgSecCheck($content);
var_dump($res);
if($res->result['label'] == 100) {
return true;
} else {
throw new ValidateException('内容包含:【'.$res->result['label'].'】无法发布');
}
// } catch (\Exception $e) {
// Log::error('敏感词检查:' . $e->getMessage());
// throw new WechatException(ErrorMessage::getMessage($e->getMessage()));
// }
}
}