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
212 lines
6.8 KiB
PHP
212 lines
6.8 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\user;
|
||
|
||
|
||
use app\dao\user\UserInvoiceDao;
|
||
use app\services\BaseServices;
|
||
use think\annotation\Inject;
|
||
use think\exception\ValidateException;
|
||
|
||
|
||
/**
|
||
* Class UserInvoiceServices
|
||
* @package app\services\user
|
||
* @mixin UserInvoiceDao
|
||
*/
|
||
class UserInvoiceServices extends BaseServices
|
||
{
|
||
|
||
/**
|
||
* @var UserInvoiceDao
|
||
*/
|
||
#[Inject]
|
||
protected UserInvoiceDao $dao;
|
||
|
||
/**
|
||
* 检测系统设置发票功能
|
||
* @param bool $is_speclial
|
||
* @return bool|array
|
||
*/
|
||
public function invoiceFuncStatus(bool $is_speclial = true)
|
||
{
|
||
$invoice = (bool)sys_config('invoice_func_status', 0);
|
||
if ($is_speclial) {
|
||
$specialInvoice = sys_config('special_invoice_status', 0);
|
||
return ['invoice_func' => $invoice, 'special_invoice' => $invoice && $specialInvoice];
|
||
}
|
||
return $invoice;
|
||
}
|
||
|
||
/**
|
||
* 获取单个发票信息
|
||
* @param int $id
|
||
* @param int $uid
|
||
* @return array
|
||
* @throws \think\db\exception\DataNotFoundException
|
||
* @throws \think\db\exception\DbException
|
||
* @throws \think\db\exception\ModelNotFoundException
|
||
*/
|
||
public function getInvoice(int $id, int $uid = 0)
|
||
{
|
||
$invoice = $this->dao->getOne(['id' => $id, 'is_del' => 0]);
|
||
if (!$invoice || ($uid && $invoice['uid'] != $uid)) {
|
||
return [];
|
||
}
|
||
return $invoice->toArray();
|
||
}
|
||
|
||
/**
|
||
* 检测该发票是否可用
|
||
* @param int $id
|
||
* @param int $uid
|
||
* @return bool|array
|
||
* @throws \think\db\exception\DataNotFoundException
|
||
* @throws \think\db\exception\DbException
|
||
* @throws \think\db\exception\ModelNotFoundException
|
||
*/
|
||
public function checkInvoice(int $id, int $uid)
|
||
{
|
||
$invoice = $this->getInvoice($id, $uid);
|
||
if (!$invoice) {
|
||
throw new ValidateException('发票不存在或删除');
|
||
}
|
||
$invoice_func = $this->invoiceFuncStatus();
|
||
if (!$invoice_func['invoice_func']) {
|
||
throw new ValidateException('暂未开启开票,请联系管理员');
|
||
}
|
||
//专用发票
|
||
if ($invoice['type'] == 2) {
|
||
if (!$invoice_func['special_invoice']) {
|
||
throw new ValidateException('暂未开启专用发票,请联系管理员');
|
||
}
|
||
}
|
||
return $invoice;
|
||
}
|
||
|
||
|
||
/**
|
||
* 获取某个用户发票列表
|
||
* @param int $uid
|
||
* @return array
|
||
* @throws \think\db\exception\DataNotFoundException
|
||
* @throws \think\db\exception\DbException
|
||
* @throws \think\db\exception\ModelNotFoundException
|
||
*/
|
||
public function getUserList(int $uid, $where)
|
||
{
|
||
[$page, $limit] = $this->getPageValue();
|
||
$where['is_del'] = 0;
|
||
$where['uid'] = $uid;
|
||
return $this->dao->getList($where, '*', $page, $limit);
|
||
}
|
||
|
||
/**
|
||
* 获取某个用户默认发票
|
||
* @param int $uid
|
||
* @param string $field
|
||
* @return array|\think\Model|null
|
||
* @throws \think\db\exception\DataNotFoundException
|
||
* @throws \think\db\exception\DbException
|
||
* @throws \think\db\exception\ModelNotFoundException
|
||
*/
|
||
public function getUserDefaultInvoice(int $uid, int $type, string $field = '*')
|
||
{
|
||
return $this->dao->getOne(['uid' => $uid, 'is_default' => 1, 'is_del' => 0, 'type' => $type], $field);
|
||
}
|
||
|
||
/**
|
||
* 添加|修改
|
||
* @param int $uid
|
||
* @param array $data
|
||
* @return array
|
||
* @throws \think\db\exception\DataNotFoundException
|
||
* @throws \think\db\exception\DbException
|
||
* @throws \think\db\exception\ModelNotFoundException
|
||
*/
|
||
public function saveInvoice(int $uid, array $data)
|
||
{
|
||
$id = (int)$data['id'];
|
||
$data['uid'] = $uid;
|
||
unset($data['id']);
|
||
$invoice = $this->dao->get(['uid' => $uid, 'name' => $data['name'], 'drawer_phone' => $data['drawer_phone'], 'is_del' => 0]);
|
||
if ($id) {
|
||
if ($invoice && $id != $invoice['id']) {
|
||
throw new ValidateException('该发票已经存在');
|
||
}
|
||
if ($this->dao->update($id, $data, 'id')) {
|
||
if ($data['is_default']) {
|
||
$this->setDefaultInvoice($uid, $id);
|
||
}
|
||
return ['type' => 'edit', 'msg' => '修改发票成功', 'data' => []];
|
||
} else {
|
||
throw new ValidateException('修改失败或者您没有修改什么');
|
||
}
|
||
} else {
|
||
if ($invoice) {
|
||
throw new ValidateException('该发票已经存在');
|
||
}
|
||
if ($add_invoice = $this->dao->save($data)) {
|
||
$id = (int)$add_invoice['id'];
|
||
if ($data['is_default']) {
|
||
$this->setDefaultInvoice($uid, $id);
|
||
}
|
||
return ['type' => 'add', 'msg' => '添加发票成功', 'data' => ['id' => $id]];
|
||
} else {
|
||
throw new ValidateException('添加失败');
|
||
}
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 设置默认发票
|
||
* @param int $id
|
||
* @return bool
|
||
* @throws \think\db\exception\DataNotFoundException
|
||
* @throws \think\db\exception\DbException
|
||
* @throws \think\db\exception\ModelNotFoundException
|
||
*/
|
||
public function setDefaultInvoice(int $uid, int $id)
|
||
{
|
||
if (!$invoice = $this->getInvoice($id)) {
|
||
throw new ValidateException('发票不存在');
|
||
}
|
||
if ($invoice['uid'] != $uid) {
|
||
throw new ValidateException('数据错误');
|
||
}
|
||
if (!$this->dao->setDefault($uid, $id, $invoice['header_type'], $invoice['type'])) {
|
||
throw new ValidateException('设置默认发票失败');
|
||
}
|
||
return true;
|
||
}
|
||
|
||
/**
|
||
* 删除
|
||
* @param $id
|
||
* @throws \Exception
|
||
*/
|
||
public function delInvoice(int $uid, int $id)
|
||
{
|
||
if ($invoice = $this->getInvoice($id)) {
|
||
if ($invoice['uid'] != $uid) {
|
||
throw new ValidateException('数据错误');
|
||
}
|
||
if (!$this->dao->update($id, ['is_del' => 1])) {
|
||
throw new ValidateException('删除失败,请稍候再试!');
|
||
}
|
||
}
|
||
return true;
|
||
}
|
||
|
||
}
|