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
612 lines
17 KiB
PHP
612 lines
17 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>
|
||
// +----------------------------------------------------------------------
|
||
|
||
namespace app\dao;
|
||
|
||
use think\helper\Str;
|
||
use think\Model;
|
||
use think\Collection;
|
||
use think\db\BaseQuery;
|
||
use crmeb\basic\BaseAuth;
|
||
use crmeb\basic\BaseModel;
|
||
use think\db\exception\DbException;
|
||
use crmeb\traits\dao\CacheDaoTrait;
|
||
use think\db\exception\DataNotFoundException;
|
||
use think\db\exception\ModelNotFoundException;
|
||
|
||
/**
|
||
* Class BaseDao
|
||
* @package app\dao
|
||
*/
|
||
abstract class BaseDao
|
||
{
|
||
|
||
use CacheDaoTrait;
|
||
|
||
/**
|
||
* 当前表名别名
|
||
* @var string
|
||
*/
|
||
protected string $alias;
|
||
|
||
/**
|
||
* join表别名
|
||
* @var string
|
||
*/
|
||
protected string $joinAlis;
|
||
|
||
/**
|
||
* 过滤字段
|
||
* @var array
|
||
*/
|
||
protected array $filterateField = [];
|
||
|
||
|
||
/**
|
||
* 获取当前模型
|
||
* @return string
|
||
*/
|
||
abstract protected function setModel(): string;
|
||
|
||
/**
|
||
* 设置join链表模型
|
||
* @return string
|
||
*/
|
||
protected function setJoinModel(): string
|
||
{
|
||
}
|
||
|
||
/**
|
||
* 读取数据条数
|
||
* @param array $where
|
||
* @return int
|
||
* @throws DbException
|
||
*/
|
||
public function count(array $where = []): int
|
||
{
|
||
return $this->search($where)->count();
|
||
}
|
||
|
||
/**
|
||
* 获取某些条件总数
|
||
* @param array $where
|
||
* @return int
|
||
* @throws DbException
|
||
*/
|
||
public function getCount(array $where): int
|
||
{
|
||
return $this->getModel()->where($where)->count();
|
||
}
|
||
|
||
/**
|
||
* 获取某些条件去重总数
|
||
* @param array $where
|
||
* @param $field
|
||
* @param bool $search
|
||
* @return int|mixed
|
||
* @throws DataNotFoundException
|
||
* @throws DbException
|
||
* @throws ModelNotFoundException
|
||
*/
|
||
public function getDistinctCount(array $where, $field, bool $search = true)
|
||
{
|
||
if ($search) {
|
||
return $this->search($where)->field('COUNT(distinct(' . $field . ')) as count')->select()->toArray()[0]['count'] ?? 0;
|
||
} else {
|
||
return $this->getModel()->where($where)->field('COUNT(distinct(' . $field . ')) as count')->select()->toArray()[0]['count'] ?? 0;
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 获取模型
|
||
* @return BaseModel
|
||
*/
|
||
protected function getModel()
|
||
{
|
||
return app()->make($this->setModel());
|
||
}
|
||
|
||
/**
|
||
* 获取主键
|
||
* @return mixed
|
||
*/
|
||
protected function getPk()
|
||
{
|
||
return $this->getModel()->getPk();
|
||
}
|
||
|
||
/**
|
||
* 获取一条数据
|
||
* @param int|array $id
|
||
* @param array|null $field
|
||
* @param array|null $with
|
||
* @return array|Model|null
|
||
* @throws DataNotFoundException
|
||
* @throws DbException
|
||
* @throws ModelNotFoundException
|
||
*/
|
||
public function get($id, ?array $field = [], ?array $with = [])
|
||
{
|
||
if (is_array($id)) {
|
||
$where = $id;
|
||
} else {
|
||
$where = [$this->getPk() => $id];
|
||
}
|
||
return $this->getModel()::where($where)->when(count($with), function ($query) use ($with) {
|
||
$query->with($with);
|
||
})->field($field ?? ['*'])->find();
|
||
}
|
||
|
||
/**
|
||
* 查询一条数据是否存在
|
||
* @param $map
|
||
* @param string $field
|
||
* @return bool 是否存在
|
||
* @throws DbException
|
||
*/
|
||
public function be($map, string $field = '')
|
||
{
|
||
if (!is_array($map) && empty($field)) $field = $this->getPk();
|
||
$map = !is_array($map) ? [$field => $map] : $map;
|
||
return 0 < $this->getModel()->where($map)->count();
|
||
}
|
||
|
||
/**
|
||
* 根据条件获取一条数据
|
||
* @param array $where
|
||
* @param string|null $field
|
||
* @param array $with
|
||
* @return array|Model|null
|
||
* @throws DataNotFoundException
|
||
* @throws DbException
|
||
* @throws ModelNotFoundException
|
||
*/
|
||
public function getOne(array $where, ?string $field = '*', array $with = [])
|
||
{
|
||
$field = explode(',', $field);
|
||
return $this->get($where, $field, $with);
|
||
}
|
||
|
||
/**
|
||
* 获取单个字段值
|
||
* @param array $where
|
||
* @param string|null $field
|
||
* @return mixed
|
||
*/
|
||
public function value(array $where, ?string $field = '')
|
||
{
|
||
$pk = $this->getPk();
|
||
return $this->getModel()::where($where)->value($field ?: $pk);
|
||
}
|
||
|
||
/**
|
||
* 获取某个字段数组
|
||
* @param array $where
|
||
* @param string $field
|
||
* @param string $key
|
||
* @param bool $search
|
||
* @return array
|
||
*/
|
||
public function getColumn(array $where, string $field, string $key = '', bool $search = false)
|
||
{
|
||
if ($search) {
|
||
return $this->search($where)->column($field, $key);
|
||
} else {
|
||
return $this->getModel()::where($where)->column($field, $key);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 删除
|
||
* @param int|string|array $id
|
||
* @return bool
|
||
*/
|
||
public function delete($id, ?string $key = null)
|
||
{
|
||
if (is_array($id)) {
|
||
$where = $id;
|
||
} else {
|
||
$where = [is_null($key) ? $this->getPk() : $key => $id];
|
||
}
|
||
return $this->getModel()::where($where)->delete();
|
||
}
|
||
|
||
/**
|
||
* 更新数据
|
||
* @param int|string|array $id
|
||
* @param array $data
|
||
* @param string|null $key
|
||
* @return BaseModel
|
||
*/
|
||
public function update($id, array $data, ?string $key = null)
|
||
{
|
||
if (is_array($id)) {
|
||
$where = $id;
|
||
} else {
|
||
$where = [is_null($key) ? $this->getPk() : $key => $id];
|
||
}
|
||
return $this->getModel()::update($data, $where);
|
||
}
|
||
|
||
/**
|
||
* 批量更新数据
|
||
* @param array $ids
|
||
* @param array $data
|
||
* @param string|null $key
|
||
* @return BaseModel
|
||
*/
|
||
public function batchUpdate(array $ids, array $data, ?string $key = null)
|
||
{
|
||
return $this->getModel()::whereIn(is_null($key) ? $this->getPk() : $key, $ids)->update($data);
|
||
}
|
||
|
||
/**
|
||
* 批量更新数据,增加条件
|
||
* @param array $ids
|
||
* @param array $data
|
||
* @param array $where
|
||
* @param string|null $key
|
||
* @return BaseModel
|
||
*/
|
||
public function batchUpdateAppendWhere(array $ids, array $data, array $where, ?string $key = null)
|
||
{
|
||
return $this->getModel()::whereIn(is_null($key) ? $this->getPk() : $key, $ids)->where($where)->update($data);
|
||
}
|
||
|
||
/**
|
||
* 插入数据
|
||
* @param array $data
|
||
* @return BaseModel|Model
|
||
*/
|
||
public function save(array $data)
|
||
{
|
||
return $this->getModel()::create($data);
|
||
}
|
||
|
||
/**
|
||
* 插入数据
|
||
* @param array $data
|
||
* @return int
|
||
*/
|
||
public function saveAll(array $data)
|
||
{
|
||
return $this->getModel()::insertAll($data);
|
||
}
|
||
|
||
/**
|
||
* 获取某个字段内的值
|
||
* @param $value
|
||
* @param string $filed
|
||
* @param string|null $valueKey
|
||
* @param array|string[] $where
|
||
* @return mixed
|
||
*/
|
||
public function getFieldValue($value, string $filed, ?string $valueKey = '', ?array $where = [])
|
||
{
|
||
return $this->getModel()->getFieldValue($value, $filed, $valueKey, $where);
|
||
}
|
||
|
||
/**
|
||
* 根据搜索器获取搜索内容
|
||
* @param array $where
|
||
* @param bool $search
|
||
* @return BaseModel
|
||
* @throws \ReflectionException
|
||
*/
|
||
protected function withSearchSelect(array $where, bool $search = true)
|
||
{
|
||
[$with, $otherWhere] = $this->getSearchData($where);
|
||
return $this->getModel()
|
||
->withSearch($with, $where)
|
||
->when($search, fn($query) => $query->where($this->filterWhere($otherWhere)));
|
||
}
|
||
|
||
/**
|
||
* 过滤字段
|
||
* @param array $where
|
||
* @return array
|
||
* @author 等风来
|
||
* @email 136327134@qq.com
|
||
* @date 2023/10/7
|
||
*/
|
||
protected function filterWhere(array $where = [])
|
||
{
|
||
$fields = $this->getModel()->getTableFields();
|
||
foreach ($where as $key => $item) {
|
||
if (isset($item[0]) && !in_array($item[0], $fields)) {
|
||
unset($where[$key]);
|
||
}
|
||
}
|
||
return $where;
|
||
}
|
||
|
||
/**
|
||
* 获取搜索器和其他搜索条件
|
||
* @param array $where
|
||
* @return array[]
|
||
* @throws \ReflectionException
|
||
* @author 等风来
|
||
* @email 136327134@qq.com
|
||
* @date 2023/10/7
|
||
*/
|
||
private function getSearchData(array $where)
|
||
{
|
||
$with = [];
|
||
$otherWhere = [];
|
||
$responses = new \ReflectionClass($this->setModel());
|
||
foreach ($where as $key => $value) {
|
||
$method = 'search' . Str::studly($key) . 'Attr';
|
||
if ($responses->hasMethod($method)) {
|
||
$with[] = $key;
|
||
} else {
|
||
if (!in_array($key, array_merge(['timeKey'], $this->filterateField))) {
|
||
if (!is_array($value)) {
|
||
$otherWhere[] = [$key, '=', $value];
|
||
} else if (count($value) === 3) {
|
||
$otherWhere[] = $value;
|
||
}
|
||
}
|
||
}
|
||
}
|
||
return [$with, $otherWhere];
|
||
}
|
||
|
||
/**
|
||
* 设置过滤不进入普通搜索条件的字段
|
||
* @param array $keys
|
||
* @return $this
|
||
* @author 等风来
|
||
* @email 136327134@qq.com
|
||
* @date 2023/10/7
|
||
*/
|
||
public function setFilterateField(array $keys)
|
||
{
|
||
$this->filterateField = $keys;
|
||
return $this;
|
||
}
|
||
|
||
/**
|
||
* 搜索
|
||
* @param array $where
|
||
* @param bool $search
|
||
* @return BaseModel
|
||
* @throws \ReflectionException
|
||
*/
|
||
public function search(array $where = [], bool $search = true)
|
||
{
|
||
if ($where) {
|
||
return $this->withSearchSelect($where, $search);
|
||
} else {
|
||
return $this->getModel();
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 求和
|
||
* @param array $where
|
||
* @param string $field
|
||
* @param bool $search
|
||
* @return float
|
||
*/
|
||
public function sum(array $where, string $field, bool $search = false)
|
||
{
|
||
if ($search) {
|
||
return $this->search($where)->sum($field);
|
||
} else {
|
||
return $this->getModel()::where($where)->sum($field);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 高精度加法
|
||
* @param int|string $key
|
||
* @param string $incField
|
||
* @param string $inc
|
||
* @param string|null $keyField
|
||
* @param int $acc
|
||
* @return bool
|
||
* @throws DataNotFoundException
|
||
* @throws DbException
|
||
* @throws ModelNotFoundException
|
||
*/
|
||
public function bcInc($key, string $incField, string $inc, string $keyField = null, int $acc = 2)
|
||
{
|
||
return $this->bc($key, $incField, $inc, $keyField, 1, $acc);
|
||
}
|
||
|
||
/**
|
||
* 高精度 减法
|
||
* @param $key
|
||
* @param string $decField 相减的字段
|
||
* @param string $dec 减的值
|
||
* @param string|null $keyField id的字段
|
||
* @param int $acc 精度
|
||
* @param bool $dec_return_false 减法 不够减是否返回false ｜｜ 减为0
|
||
* @return bool
|
||
* @throws DataNotFoundException
|
||
* @throws DbException
|
||
* @throws ModelNotFoundException
|
||
*/
|
||
public function bcDec($key, string $decField, string $dec, string $keyField = null, int $acc = 2, bool $dec_return_false = true)
|
||
{
|
||
return $this->bc($key, $decField, $dec, $keyField, 2, $acc, $dec_return_false);
|
||
}
|
||
|
||
/**
|
||
* 高精度计算并保存
|
||
* @param $key
|
||
* @param string $incField
|
||
* @param string $inc
|
||
* @param string|null $keyField
|
||
* @param int $type
|
||
* @param int $acc
|
||
* @param bool $dec_return_false 减法 不够减是否返回false ｜｜ 减为0
|
||
* @return bool
|
||
* @throws DataNotFoundException
|
||
* @throws DbException
|
||
* @throws ModelNotFoundException
|
||
*/
|
||
public function bc($key, string $incField, string $inc, string $keyField = null, int $type = 1, int $acc = 2, bool $dec_return_false = true)
|
||
{
|
||
if ($keyField === null) {
|
||
$result = $this->get($key);
|
||
} else {
|
||
$result = $this->getOne([$keyField => $key]);
|
||
}
|
||
if (!$result) return false;
|
||
if ($type === 1) {
|
||
$new = bcadd($result[$incField], $inc, $acc);
|
||
} else if ($type === 2) {
|
||
if ($result[$incField] < $inc) {
|
||
if ($dec_return_false) return false;
|
||
$new = 0;
|
||
} else {
|
||
$new = bcsub($result[$incField], $inc, $acc);
|
||
}
|
||
}
|
||
$result->{$incField} = $new;
|
||
return false !== $result->save();
|
||
}
|
||
|
||
/**
|
||
* 减库存加销量
|
||
* @param array $where
|
||
* @param int $num
|
||
* @param string $stock
|
||
* @param string $sales
|
||
* @return mixed
|
||
*/
|
||
public function decStockIncSales(array $where, int $num, string $stock = 'stock', string $sales = 'sales')
|
||
{
|
||
return app()->make(BaseAuth::class)->_____($this->getModel(), $where, $num, $stock, $sales) !== false;
|
||
}
|
||
|
||
/**
|
||
* 加库存减销量
|
||
* @param array $where
|
||
* @param int $num
|
||
* @param string $stock
|
||
* @param string $sales
|
||
* @return mixed
|
||
*/
|
||
public function incStockDecSales(array $where, int $num, string $stock = 'stock', string $sales = 'sales')
|
||
{
|
||
return app()->make(BaseAuth::class)->___($this->getModel(), $where, $num, $stock, $sales) !== false;
|
||
}
|
||
|
||
/**
|
||
* 软删除
|
||
* @param $id
|
||
* @param string|null $key
|
||
* @param bool $force
|
||
* @return bool
|
||
*/
|
||
public function destroy($id, ?string $key = null, bool $force = false)
|
||
{
|
||
if (is_array($id)) {
|
||
$where = $id;
|
||
} else {
|
||
$where = [is_null($key) ? $this->getPk() : $key => $id];
|
||
}
|
||
return $this->getModel()::destroy($where, $force);
|
||
}
|
||
|
||
/**
|
||
* 自增单个数据
|
||
* @param $where
|
||
* @param string $field
|
||
* @param int $number
|
||
* @return mixed
|
||
*/
|
||
public function incUpdate($where, string $field, int $number = 1)
|
||
{
|
||
return $this->getModel()->where(is_array($where) ? $where : [$this->getPk() => $where])->inc($field, $number)->update();
|
||
}
|
||
|
||
/**
|
||
* 自减单个数据
|
||
* @param $where
|
||
* @param string $field
|
||
* @param int $number
|
||
* @return mixed
|
||
*/
|
||
public function decUpdate($where, string $field, int $number = 1)
|
||
{
|
||
return $this->getModel()->where(is_array($where) ? $where : [$this->getPk() => $where])->dec($field, $number)->update();
|
||
}
|
||
|
||
/**
|
||
* 条件查询
|
||
* @param array $where
|
||
* @param string $field
|
||
* @param int $page
|
||
* @param int $limit
|
||
* @param string $order
|
||
* @param bool $search
|
||
* @return Collection
|
||
* @throws DataNotFoundException
|
||
* @throws DbException
|
||
* @throws ModelNotFoundException
|
||
*/
|
||
public function selectList(array $where, string $field = '*', int $page = 0, int $limit = 0, string $order = '', bool $search = false)
|
||
{
|
||
if ($search) {
|
||
$model = $this->search($where);
|
||
} else {
|
||
$model = $this->getModel()->where($where);
|
||
}
|
||
return $model->field($field)->when($page && $limit, function ($query) use ($page, $limit) {
|
||
$query->page($page, $limit);
|
||
})->when($order !== '', function ($query) use ($order) {
|
||
$query->order($order);
|
||
})->select();
|
||
}
|
||
|
||
/**
|
||
* 获取分页请求 兼容大量数据查询
|
||
* @param BaseQuery $query
|
||
* @param int $page
|
||
* @param int $limit
|
||
* @param int $id
|
||
* @param string $op
|
||
* @param string $key
|
||
* @author 等风来
|
||
* @email 136327134@qq.com
|
||
* @date 2023/9/20
|
||
*/
|
||
protected function pageQueryModel(BaseQuery $query, int $page = 1, int $limit = 10, int $id = 0, string $op = '<', string $key = '')
|
||
{
|
||
if ($id && $page && $limit) {
|
||
$query->where($key ?: $this->getPk(), $op, $id)->limit($limit);
|
||
} else {
|
||
$query->page($page, $limit);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 判断字段是否存在
|
||
* @param $field
|
||
* @param $value
|
||
* @param int|null $except
|
||
* @return bool
|
||
* User: liusl
|
||
* DateTime: 2025/7/2 10:49
|
||
*/
|
||
public function fieldExists($field, $value, int $except = 0): bool
|
||
{
|
||
$query = $this->getModel()->where($field, $value);
|
||
if ($except != 0) $query->where($this->getPk(), '<>', $except);
|
||
|
||
return !!$query->value($this->getPk());
|
||
}
|
||
|
||
}
|