初始化本地仓库
This commit is contained in:
@@ -0,0 +1,423 @@
|
||||
<?php
|
||||
declare(strict_types=1);
|
||||
|
||||
namespace app\service\api\member;
|
||||
|
||||
use app\dao\member\MemberDao;
|
||||
use app\dao\member\MemberPointsDao;
|
||||
use app\adminapi\event\PointsChangedEvent;
|
||||
use app\enum\member\PointSource;
|
||||
use app\enum\member\PointType;
|
||||
use core\base\BaseService;
|
||||
use support\Container;
|
||||
use support\Log;
|
||||
|
||||
class MemberPointsService extends BaseService
|
||||
{
|
||||
|
||||
public function __construct(
|
||||
private readonly MemberPointsDao $memberPointsDao,
|
||||
MemberDao $dao
|
||||
)
|
||||
{
|
||||
$this->dao = $dao;
|
||||
}
|
||||
|
||||
/**
|
||||
* 增加会员积分
|
||||
*
|
||||
* @param int|string $memberId 会员ID
|
||||
* @param int $points 积分数量
|
||||
* @param string $remark 备注
|
||||
* @param PointSource $source 积分来源
|
||||
* @param int|string|null $relatedId 关联ID
|
||||
*
|
||||
* @return float 新积分余额
|
||||
* @throws \Exception
|
||||
*/
|
||||
public function addPoints(
|
||||
int|string $memberId,
|
||||
int $points,
|
||||
string $remark = '',
|
||||
PointSource $source = PointSource::OTHER,
|
||||
int|string|null $relatedId = null,
|
||||
?array $extra = null
|
||||
): float
|
||||
{
|
||||
$member = $this->dao->find($memberId);
|
||||
if (!$member) {
|
||||
throw new \Exception('会员不存在');
|
||||
}
|
||||
|
||||
$oldPoints = $member->points;
|
||||
$newPoints = $oldPoints + $points;
|
||||
|
||||
$event = new PointsChangedEvent(
|
||||
$memberId,
|
||||
$points,
|
||||
$source,
|
||||
PointType::INCREASE,
|
||||
$oldPoints,
|
||||
$newPoints,
|
||||
$remark,
|
||||
$relatedId,
|
||||
$extra
|
||||
);
|
||||
$event->dispatch();
|
||||
|
||||
return $this->getPointsBalance($memberId);
|
||||
}
|
||||
|
||||
/**
|
||||
* 减少会员积分
|
||||
*
|
||||
* @param int|string $memberId 会员ID
|
||||
* @param int $points 积分数量
|
||||
* @param string $remark 备注
|
||||
* @param PointSource $source 积分来源
|
||||
* @param int|string|null $relatedId 关联ID
|
||||
*
|
||||
* @return float 新积分余额
|
||||
* @throws \Exception
|
||||
*/
|
||||
public function deductPoints(
|
||||
int|string $memberId,
|
||||
int $points,
|
||||
string $remark = '',
|
||||
PointSource $source = PointSource::OTHER,
|
||||
int|string|null $relatedId = null,
|
||||
?array $extra = null
|
||||
): float
|
||||
{
|
||||
$member = $this->dao->find($memberId);
|
||||
if (!$member) {
|
||||
throw new \Exception('会员不存在');
|
||||
}
|
||||
|
||||
$oldPoints = $member->points;
|
||||
if ($oldPoints < $points) {
|
||||
throw new \Exception('积分不足');
|
||||
}
|
||||
$newPoints = $oldPoints - $points;
|
||||
|
||||
$event = new PointsChangedEvent(
|
||||
$memberId,
|
||||
$points,
|
||||
$source,
|
||||
PointType::DECREASE,
|
||||
$oldPoints,
|
||||
$newPoints,
|
||||
$remark,
|
||||
$relatedId,
|
||||
$extra
|
||||
);
|
||||
$event->dispatch();
|
||||
|
||||
return $this->getPointsBalance($memberId);
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取会员积分记录
|
||||
*
|
||||
* @param int|string $memberId 会员ID
|
||||
* @param int $limit 记录数量
|
||||
*
|
||||
* @return array 积分记录列表
|
||||
*/
|
||||
public function getPointsRecords(int|string $memberId, int $limit = 20): array
|
||||
{
|
||||
return $this->memberPointsDao->getMemberPoints($memberId, $limit);
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取会员积分余额
|
||||
*
|
||||
* @param int|string $memberId 会员ID
|
||||
*
|
||||
* @return float 积分余额
|
||||
*/
|
||||
public function getPointsBalance(int|string $memberId): float
|
||||
{
|
||||
return $this->memberPointsDao->getMemberBalance($memberId);
|
||||
}
|
||||
|
||||
/**
|
||||
* 检查会员积分是否足够
|
||||
*
|
||||
* @param int|string $memberId 会员ID
|
||||
* @param int $points 需要的积分数量
|
||||
*
|
||||
* @return bool 积分是否足够
|
||||
*/
|
||||
public function isPointsEnough(int|string $memberId, int $points): bool
|
||||
{
|
||||
$balance = $this->getPointsBalance($memberId);
|
||||
return $balance >= $points;
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取积分流水记录（分页）
|
||||
*
|
||||
* @param array $params 查询参数
|
||||
*
|
||||
* @return array
|
||||
* @throws \Exception
|
||||
*/
|
||||
public function getPointsRecord(array $params): array
|
||||
{
|
||||
$memberId = $params['member_id'] ?? 0;
|
||||
$page = $params['page'] ?? 1;
|
||||
$limit = $params['limit'] ?? 20;
|
||||
$type = $params['type'] ?? null;
|
||||
|
||||
if (!$memberId) {
|
||||
throw new \Exception('会员ID不能为空');
|
||||
}
|
||||
|
||||
$offset = ($page - 1) * $limit;
|
||||
|
||||
$query = $this->memberPointsDao->query()
|
||||
->where('member_id', '=', $memberId);
|
||||
|
||||
if ($type) {
|
||||
$query->where('type', '=', $type);
|
||||
}
|
||||
|
||||
$total = $query->count();
|
||||
$items = $query->orderBy('created_at', 'desc')
|
||||
->offset($offset)
|
||||
->limit($limit)
|
||||
->get()
|
||||
->toArray();
|
||||
|
||||
return [
|
||||
'items' => $items,
|
||||
'total' => $total,
|
||||
'page' => $page,
|
||||
'limit' => $limit,
|
||||
];
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取会员积分总额统计
|
||||
*
|
||||
* @param int|string $memberId 会员ID
|
||||
*
|
||||
* @return array
|
||||
* @throws \Exception
|
||||
*/
|
||||
public function getPointsTotal(int|string $memberId): array
|
||||
{
|
||||
if (!$memberId) {
|
||||
throw new \Exception('会员ID不能为空');
|
||||
}
|
||||
|
||||
$currentPoints = $this->getPointsBalance($memberId);
|
||||
|
||||
$monthStart = date('Y-m-01 00:00:00');
|
||||
$monthEnd = date('Y-m-t 23:59:59');
|
||||
|
||||
$monthlyPoints = $this->memberPointsDao->query()
|
||||
->where('member_id', '=', $memberId)
|
||||
->where('type', '=', PointType::INCREASE->value)
|
||||
->whereBetween('created_at', [$monthStart, $monthEnd])
|
||||
->sum('points');
|
||||
|
||||
$totalPoints = $this->memberPointsDao->query()
|
||||
->where('member_id', '=', $memberId)
|
||||
->where('type', '=', PointType::INCREASE->value)
|
||||
->sum('points');
|
||||
|
||||
return [
|
||||
'current_points' => (int)$currentPoints,
|
||||
'monthly_points' => (int)($monthlyPoints ?? 0),
|
||||
'total_points' => (int)($totalPoints ?? 0),
|
||||
];
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取会员等级信息
|
||||
*
|
||||
* @param int|string $memberId 会员ID
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
public function getMemberLevel(int|string $memberId): array
|
||||
{
|
||||
if (!$memberId) {
|
||||
throw new \Exception('会员ID不能为空');
|
||||
}
|
||||
|
||||
$member = $this->dao->find($memberId);
|
||||
|
||||
if (!$member) {
|
||||
throw new \Exception('会员不存在');
|
||||
}
|
||||
|
||||
return [
|
||||
'level_id' => $member->level_id,
|
||||
'points' => $member->points,
|
||||
];
|
||||
}
|
||||
|
||||
/**
|
||||
* 会员签到获取积分
|
||||
*
|
||||
* @param int|string $memberId 会员ID
|
||||
* @param int $continuousDays 连续签到天数
|
||||
*
|
||||
* @return int 获得的积分数量
|
||||
* @throws \Exception
|
||||
*/
|
||||
public function getSignPoints(int|string $memberId, int $continuousDays): int
|
||||
{
|
||||
// 每次签到固定+1积分
|
||||
$points = 1;
|
||||
|
||||
// 触发积分增加事件
|
||||
$this->addPoints(
|
||||
$memberId,
|
||||
$points,
|
||||
'每日签到',
|
||||
PointSource::SIGN_IN
|
||||
);
|
||||
|
||||
return $points;
|
||||
}
|
||||
|
||||
/**
|
||||
* 会员购物获取积分
|
||||
*
|
||||
* @param int|string $memberId 会员ID
|
||||
* @param float $amount 购物金额
|
||||
* @param int|string $orderId 订单ID
|
||||
*
|
||||
* @return int 获得的积分数量
|
||||
* @throws \Exception
|
||||
*/
|
||||
public function getShoppingPoints(int|string $memberId, float $amount, int|string $orderId): int
|
||||
{
|
||||
// 计算购物积分（例如：每消费10元获得1积分）
|
||||
$points = (int)($amount / 10);
|
||||
|
||||
if ($points > 0) {
|
||||
$this->addPoints(
|
||||
$memberId,
|
||||
$points,
|
||||
'购物获得积分',
|
||||
PointSource::SHOPPING,
|
||||
$orderId
|
||||
);
|
||||
}
|
||||
|
||||
return $points;
|
||||
}
|
||||
|
||||
/**
|
||||
* 会员邀请获取积分
|
||||
*
|
||||
* @param int|string $memberId 会员ID
|
||||
* @param int|string $invitedMemberId 被邀请的会员ID
|
||||
*
|
||||
* @return int 获得的积分数量
|
||||
* @throws \Exception
|
||||
*/
|
||||
public function getInvitePoints(int|string $memberId, int|string $invitedMemberId): int
|
||||
{
|
||||
// 邀请奖励积分
|
||||
$points = 50;
|
||||
|
||||
$this->addPoints(
|
||||
$memberId,
|
||||
$points,
|
||||
'邀请好友注册',
|
||||
PointSource::INVITE,
|
||||
$invitedMemberId
|
||||
);
|
||||
|
||||
return $points;
|
||||
}
|
||||
|
||||
/**
|
||||
* 会员注册获取积分
|
||||
*
|
||||
* @param int|string $memberId 会员ID
|
||||
*
|
||||
* @return int 获得的积分数量
|
||||
* @throws \Exception
|
||||
*/
|
||||
public function getRegisterPoints(int|string $memberId): int
|
||||
{
|
||||
// 注册奖励积分
|
||||
$points = 100;
|
||||
|
||||
$this->addPoints(
|
||||
$memberId,
|
||||
$points,
|
||||
'新会员注册奖励',
|
||||
PointSource::REGISTER
|
||||
);
|
||||
|
||||
return $points;
|
||||
}
|
||||
|
||||
/**
|
||||
* 会员兑换商品扣减积分
|
||||
*
|
||||
* @param int|string $memberId 会员ID
|
||||
* @param int $points 兑换需要的积分
|
||||
* @param int|string $productId 兑换商品ID
|
||||
*
|
||||
* @return float 扣减后的积分余额
|
||||
* @throws \Exception
|
||||
*/
|
||||
public function deductExchangePoints(int|string $memberId, int $points, int|string $productId): float
|
||||
{
|
||||
return $this->deductPoints(
|
||||
$memberId,
|
||||
$points,
|
||||
'兑换商品',
|
||||
PointSource::EXCHANGE,
|
||||
$productId
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* 积分过期扣减
|
||||
*
|
||||
* @param int|string $memberId 会员ID
|
||||
* @param int $points 过期的积分数量
|
||||
*
|
||||
* @return float 扣减后的积分余额
|
||||
* @throws \Exception
|
||||
*/
|
||||
public function deductExpiredPoints(int|string $memberId, int $points): float
|
||||
{
|
||||
return $this->deductPoints(
|
||||
$memberId,
|
||||
$points,
|
||||
'积分过期',
|
||||
PointSource::EXPIRED
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* 违规处罚扣减积分
|
||||
*
|
||||
* @param int|string $memberId 会员ID
|
||||
* @param int $points 处罚的积分数量
|
||||
* @param string $reason 处罚原因
|
||||
*
|
||||
* @return float 扣减后的积分余额
|
||||
* @throws \Exception
|
||||
*/
|
||||
public function deductPenaltyPoints(int|string $memberId, int $points, string $reason): float
|
||||
{
|
||||
return $this->deductPoints(
|
||||
$memberId,
|
||||
$points,
|
||||
'违规处罚: ' . $reason,
|
||||
PointSource::PENALTY
|
||||
);
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user