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
304 lines
9.5 KiB
PHP
304 lines
9.5 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\validate\api\user\AddressValidate;
|
||
use app\services\BaseServices;
|
||
use app\dao\user\UserAddressDao;
|
||
use app\services\other\SystemCityServices;
|
||
use crmeb\exceptions\AdminException;
|
||
use think\annotation\Inject;
|
||
use think\db\exception\DataNotFoundException;
|
||
use think\db\exception\DbException;
|
||
use think\db\exception\ModelNotFoundException;
|
||
use think\Exception;
|
||
use think\exception\ValidateException;
|
||
use think\Model;
|
||
|
||
/**
|
||
*
|
||
* Class UserAddressServices
|
||
* @package app\services\user
|
||
* @mixin UserAddressDao
|
||
*/
|
||
class UserAddressServices extends BaseServices
|
||
{
|
||
|
||
/**
|
||
* @var UserAddressDao
|
||
*/
|
||
#[Inject]
|
||
protected UserAddressDao $dao;
|
||
|
||
/**
|
||
* 获取单个地址
|
||
* @param $id
|
||
* @param array $field
|
||
* @return array
|
||
* @throws DataNotFoundException
|
||
* @throws DbException
|
||
* @throws ModelNotFoundException
|
||
*/
|
||
public function getAddress($id, array $field = [])
|
||
{
|
||
return $this->dao->get($id, $field);
|
||
}
|
||
|
||
/**
|
||
* 获取用户缓存地址
|
||
* @param int $uid
|
||
* @param int $addressId
|
||
* @return bool|mixed|null
|
||
*/
|
||
public function getAdderssCache(int $id, int $expire = 60)
|
||
{
|
||
return $this->dao->cacheTag()->remember('user_adderss_cache_' . $id, function () use ($id) {
|
||
$res = $this->dao->getOne(['id' => $id, 'is_del' => 0]);
|
||
if ($res) {
|
||
return $res->toArray();
|
||
} else {
|
||
return [];
|
||
}
|
||
}, $expire);
|
||
}
|
||
|
||
/**
|
||
* 获取所有地址
|
||
* @param array $where
|
||
* @param string $field
|
||
* @return array
|
||
*/
|
||
public function getAddressList(array $where, string $field = '*'): array
|
||
{
|
||
[$page, $limit] = $this->getPageValue();
|
||
$list = $this->dao->getList($where, $field, $page, $limit);
|
||
$count = $this->getAddresCount($where);
|
||
return compact('list', 'count');
|
||
}
|
||
|
||
/**
|
||
* 获取某个用户的所有地址
|
||
* @param int $uid
|
||
* @param string $field
|
||
* @return array
|
||
*/
|
||
public function getUserAddressList(int $uid, string $field = '*'): array
|
||
{
|
||
[$page, $limit] = $this->getPageValue();
|
||
$where = ['uid' => $uid];
|
||
$where['is_del'] = 0;
|
||
return $this->dao->getList($where, $field, $page, $limit);
|
||
}
|
||
|
||
/**
|
||
* @param int $uid
|
||
* @param int $expire
|
||
* @return mixed
|
||
* @throws \throwable
|
||
*/
|
||
public function getUserDefaultAddressCache(int $uid, int $expire = 60)
|
||
{
|
||
return $this->dao->cacheTag()->remember('user_adderss_cache_user_' . $uid, function () use ($uid) {
|
||
$res = $this->dao->getOne(['uid' => $uid, 'is_default' => 1, 'is_del' => 0]);
|
||
if ($res) {
|
||
return $res->toArray();
|
||
} else {
|
||
return [];
|
||
}
|
||
}, $expire);
|
||
}
|
||
|
||
/**
|
||
* @param int $uid
|
||
* @param string $field
|
||
* @return array|Model|null
|
||
* @throws DataNotFoundException
|
||
* @throws DbException
|
||
* @throws ModelNotFoundException
|
||
*/
|
||
public function getUserDefaultAddress(int $uid, string $field = '*')
|
||
{
|
||
return $this->dao->getOne(['uid' => $uid, 'is_default' => 1, 'is_del' => 0], $field);
|
||
}
|
||
|
||
/**
|
||
* 获取条数
|
||
* @param array $where
|
||
* @return int
|
||
*/
|
||
public function getAddresCount(array $where): int
|
||
{
|
||
return $this->dao->count($where);
|
||
}
|
||
|
||
/**
|
||
* 添加地址
|
||
* @param array $data
|
||
* @return bool
|
||
*/
|
||
public function create(array $data)
|
||
{
|
||
if (!$this->dao->save($data))
|
||
throw new AdminException('写入失败');
|
||
return true;
|
||
}
|
||
|
||
/**
|
||
* 修改地址
|
||
* @param $id
|
||
* @param $data
|
||
* @return bool
|
||
*/
|
||
public function updateAddress(int $id, array $data)
|
||
{
|
||
if (!$this->dao->update($id, $data))
|
||
throw new AdminException('修改失败');
|
||
return true;
|
||
}
|
||
|
||
/**
|
||
* 设置默认定制
|
||
* @param int $uid
|
||
* @param int $id
|
||
* @return bool
|
||
*/
|
||
public function setDefault(int $uid, int $id)
|
||
{
|
||
if (!$this->dao->be($id)) {
|
||
throw new ValidateException('地址不存在');
|
||
}
|
||
if (!$this->dao->update($uid, ['is_default' => 0], 'uid'))
|
||
throw new Exception('取消原来默认地址');
|
||
if (!$this->dao->update($id, ['is_default' => 1]))
|
||
throw new Exception('设置默认地址失败');
|
||
return true;
|
||
}
|
||
|
||
/**
|
||
* 获取单个地址
|
||
* @param int $id
|
||
* @return mixed
|
||
*/
|
||
public function address(int $id)
|
||
{
|
||
$addressInfo = $this->getAdderssCache($id);
|
||
if (!$addressInfo || (isset($addressInfo['is_del']) && $addressInfo['is_del'] == 1)) {
|
||
throw new ValidateException('数据不存在');
|
||
}
|
||
return $addressInfo;
|
||
}
|
||
|
||
/**
|
||
* 添加|修改地址
|
||
* @param int $uid
|
||
* @param array $addressInfo
|
||
* @return mixed
|
||
*/
|
||
public function editAddress(int $uid, array $addressInfo)
|
||
{
|
||
if ($addressInfo['type'] == 1 && !$addressInfo['id']) {
|
||
$city = $addressInfo['address']['city'];
|
||
/** @var SystemCityServices $systemCity */
|
||
$systemCity = app()->make(SystemCityServices::class);
|
||
$cityInfo = $systemCity->getOne([['name', '=', $city], ['parent_id', '<>', 0]]);
|
||
if ($cityInfo && $cityInfo['city_id']) {
|
||
$addressInfo['address']['city_id'] = $cityInfo['city_id'];
|
||
} else {
|
||
$cityInfo = $systemCity->getOne([['name', 'like', "%$city%"], ['parent_id', '<>', 0]]);
|
||
if (!$cityInfo) {
|
||
throw new ValidateException('收货地址格式错误!修改后请重新导入!');
|
||
}
|
||
$addressInfo['address']['city_id'] = $cityInfo['city_id'];
|
||
}
|
||
}
|
||
if (!isset($addressInfo['address']['city_id']) || $addressInfo['address']['city_id'] == 0) throw new ValidateException('添加收货地址失败!');
|
||
$addressInfo['province'] = $addressInfo['address']['province'] ?? '';
|
||
$addressInfo['city'] = $addressInfo['address']['city'] ?? '';
|
||
$addressInfo['city_id'] = $addressInfo['address']['city_id'] ?? 0;
|
||
$addressInfo['district'] = $addressInfo['address']['district'] ?? '';
|
||
$addressInfo['street'] = $addressInfo['address']['street'] ?? '';
|
||
$addressInfo['is_default'] = (int)$addressInfo['is_default'] == true ? 1 : 0;
|
||
$addressInfo['uid'] = $uid;
|
||
unset($addressInfo['address'], $addressInfo['type']);
|
||
//数据验证
|
||
validate(AddressValidate::class)->check($addressInfo);
|
||
$address_check = [];
|
||
if ($addressInfo['id']) {
|
||
$address_check = $this->getAddress((int)$addressInfo['id']);
|
||
}
|
||
if ($address_check && $address_check['is_del'] == 0) {
|
||
if ($address_check['uid'] != $uid) {
|
||
throw new ValidateException('编辑收货地址失败');
|
||
}
|
||
$id = (int)$addressInfo['id'];
|
||
unset($addressInfo['id']);
|
||
if (!$this->dao->update($id, $addressInfo, 'id')) {
|
||
throw new ValidateException('编辑收货地址失败');
|
||
}
|
||
if ($addressInfo['is_default']) {
|
||
$this->setDefault($uid, $id);
|
||
}
|
||
|
||
$this->dao->cacheTag()->clear();
|
||
|
||
return ['type' => 'edit', 'msg' => '编辑地址成功', 'data' => []];
|
||
} else {
|
||
$addressInfo['add_time'] = time();
|
||
unset($addressInfo['id']);
|
||
if (!$address = $this->dao->save($addressInfo)) {
|
||
throw new ValidateException('添加收货地址失败');
|
||
}
|
||
if ($addressInfo['is_default']) {
|
||
$this->setDefault($uid, (int)$address->id);
|
||
}
|
||
|
||
$this->dao->cacheTag()->clear();
|
||
|
||
return ['type' => 'add', 'msg' => '添加地址成功', 'data' => ['id' => $address->id]];
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 删除地址
|
||
* @param int $uid
|
||
* @param int $id
|
||
* @return bool
|
||
*/
|
||
public function delAddress(int $uid, int $id)
|
||
{
|
||
$addressInfo = $this->getAddress($id);
|
||
if (!$addressInfo || $addressInfo['is_del'] == 1 || $addressInfo['uid'] != $uid) {
|
||
throw new ValidateException('数据不存在');
|
||
}
|
||
if ($this->dao->update($id, ['is_del' => '1'], 'id')) {
|
||
$this->dao->cacheTag()->clear();
|
||
return true;
|
||
} else
|
||
throw new ValidateException('删除地址失败!');
|
||
}
|
||
|
||
/**
|
||
* 设置默认用户地址
|
||
* @param $id
|
||
* @param $uid
|
||
* @return bool
|
||
*/
|
||
public function setDefaultAddress(int $id, int $uid)
|
||
{
|
||
$res1 = $this->dao->update($uid, ['is_default' => 0], 'uid');
|
||
$res2 = $this->dao->update(['id' => $id, 'uid' => $uid], ['is_default' => 1]);
|
||
$res = $res1 !== false && $res2 !== false;
|
||
return $res;
|
||
}
|
||
}
|