LotteryActivityService.php 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425
  1. <?php
  2. namespace app\common\Service\lottery;
  3. use app\common\model\lottery\LotteryActivity;
  4. use app\common\Enum\LotteryEnum;
  5. /**
  6. * 抽奖活动服务类
  7. */
  8. class LotteryActivityService
  9. {
  10. /**
  11. * 检查活动是否正在进行
  12. */
  13. public static function isRunning(LotteryActivity $activity)
  14. {
  15. $now = time();
  16. return $activity->status == LotteryEnum::STATUS_ONGOING
  17. && $activity->start_time <= $now
  18. && $activity->end_time >= $now;
  19. }
  20. /**
  21. * 检查活动是否已结束
  22. */
  23. public static function isEnded(LotteryActivity $activity)
  24. {
  25. $now = time();
  26. return $activity->status == LotteryEnum::STATUS_ENDED
  27. || $activity->end_time < $now;
  28. }
  29. /**
  30. * 检查活动是否未开始
  31. */
  32. public static function isNotStarted(LotteryActivity $activity)
  33. {
  34. $now = time();
  35. return $activity->status == LotteryEnum::STATUS_NOT_STARTED
  36. && $activity->start_time > $now;
  37. }
  38. /**
  39. * 检查活动是否已暂停
  40. */
  41. public static function isSuspended(LotteryActivity $activity)
  42. {
  43. return $activity->status == LotteryEnum::STATUS_SUSPENDED;
  44. }
  45. /**
  46. * 检查活动是否已取消
  47. */
  48. public static function isCancelled(LotteryActivity $activity)
  49. {
  50. return $activity->status == LotteryEnum::STATUS_CANCELLED;
  51. }
  52. /**
  53. * 检查是否在抽奖时间内
  54. */
  55. public static function isInDrawTime(LotteryActivity $activity)
  56. {
  57. if (!$activity->draw_time_enable) {
  58. return true;
  59. }
  60. $currentTime = date('H:i');
  61. return $currentTime >= $activity->draw_time_start
  62. && $currentTime <= $activity->draw_time_end;
  63. }
  64. /**
  65. * 获取正在进行的活动
  66. */
  67. public static function getRunningActivities()
  68. {
  69. $now = time();
  70. return LotteryActivity::where('status', LotteryEnum::STATUS_ONGOING)
  71. ->where('start_time', '<=', $now)
  72. ->where('end_time', '>=', $now)
  73. ->select();
  74. }
  75. /**
  76. * 获取未开始的活动
  77. */
  78. public static function getNotStartedActivities()
  79. {
  80. $now = time();
  81. return LotteryActivity::where('status', LotteryEnum::STATUS_NOT_STARTED)
  82. ->where('start_time', '>', $now)
  83. ->select();
  84. }
  85. /**
  86. * 获取已结束的活动
  87. */
  88. public static function getEndedActivities()
  89. {
  90. $now = time();
  91. return LotteryActivity::where('status', LotteryEnum::STATUS_ENDED)
  92. ->orWhere('end_time', '<', $now)
  93. ->select();
  94. }
  95. /**
  96. * 获取可显示的活动(排除逻辑状态)
  97. */
  98. public static function getDisplayableActivities()
  99. {
  100. $displayableStatuses = array_keys(LotteryEnum::getActivityStatusMap());
  101. return LotteryActivity::whereIn('status', $displayableStatuses)->select();
  102. }
  103. /**
  104. * 验证活动状态是否有效
  105. */
  106. public static function isValidStatus(LotteryActivity $activity)
  107. {
  108. return LotteryEnum::isValidActivityStatus($activity->status);
  109. }
  110. /**
  111. * 验证开奖方式是否有效
  112. */
  113. public static function isValidLotteryType(LotteryActivity $activity)
  114. {
  115. return LotteryEnum::isValidLotteryType($activity->lottery_type);
  116. }
  117. /**
  118. * 获取活动状态描述
  119. */
  120. public static function getActivityStatusDescription(LotteryActivity $activity)
  121. {
  122. $now = time();
  123. if (self::isCancelled($activity)) {
  124. return '活动已取消';
  125. }
  126. if (self::isSuspended($activity)) {
  127. return '活动已暂停';
  128. }
  129. if (self::isEnded($activity)) {
  130. return '活动已结束';
  131. }
  132. if (self::isRunning($activity)) {
  133. return '活动进行中';
  134. }
  135. if (self::isNotStarted($activity)) {
  136. return '活动未开始';
  137. }
  138. return '未知状态';
  139. }
  140. /**
  141. * 检查用户是否可以参与活动
  142. */
  143. public static function canUserParticipate(LotteryActivity $activity, $userId)
  144. {
  145. // 检查活动状态
  146. if (!self::isRunning($activity)) {
  147. return false;
  148. }
  149. // 检查抽奖时间
  150. if (!self::isInDrawTime($activity)) {
  151. return false;
  152. }
  153. // TODO: 检查用户群体限制
  154. // TODO: 检查用户参与次数限制
  155. return true;
  156. }
  157. /**
  158. * 获取活动统计信息
  159. */
  160. public static function getActivityStatistics(LotteryActivity $activity)
  161. {
  162. return [
  163. 'total_participants' => $activity->drawRecords()->count(),
  164. 'total_winners' => $activity->winRecords()->count(),
  165. 'total_prizes' => $activity->prizes()->count(),
  166. 'total_conditions' => $activity->conditions()->count(),
  167. ];
  168. }
  169. /**
  170. * 批量更新活动状态
  171. */
  172. public static function batchUpdateStatus()
  173. {
  174. $now = time();
  175. // 将已过期的活动标记为已结束
  176. LotteryActivity::where('status', LotteryEnum::STATUS_ONGOING)
  177. ->where('end_time', '<', $now)
  178. ->update(['status' => LotteryEnum::STATUS_ENDED]);
  179. // 将到期的未开始活动标记为进行中
  180. LotteryActivity::where('status', LotteryEnum::STATUS_NOT_STARTED)
  181. ->where('start_time', '<=', $now)
  182. ->where('end_time', '>=', $now)
  183. ->update(['status' => LotteryEnum::STATUS_ONGOING]);
  184. }
  185. /**
  186. * 创建新活动
  187. */
  188. public static function createActivity($data)
  189. {
  190. // 验证数据
  191. if (!LotteryEnum::isValidActivityStatus($data['status'])) {
  192. throw new \Exception('无效的活动状态');
  193. }
  194. if (!LotteryEnum::isValidLotteryType($data['lottery_type'])) {
  195. throw new \Exception('无效的开奖方式');
  196. }
  197. return LotteryActivity::create($data);
  198. }
  199. /**
  200. * 更新活动
  201. */
  202. public static function updateActivity(LotteryActivity $activity, $data)
  203. {
  204. // 验证数据
  205. if (isset($data['status']) && !LotteryEnum::isValidActivityStatus($data['status'])) {
  206. throw new \Exception('无效的活动状态');
  207. }
  208. if (isset($data['lottery_type']) && !LotteryEnum::isValidLotteryType($data['lottery_type'])) {
  209. throw new \Exception('无效的开奖方式');
  210. }
  211. return $activity->save($data);
  212. }
  213. /**
  214. * 删除活动
  215. */
  216. public static function deleteActivity(LotteryActivity $activity)
  217. {
  218. // 检查是否可以删除
  219. if (self::isRunning($activity)) {
  220. throw new \Exception('进行中的活动不能删除');
  221. }
  222. return $activity->delete();
  223. }
  224. /**
  225. * 获取奖品列表
  226. * @param int|null $activityId 活动ID,不传则查询进行中活动的奖品
  227. * @param int $page 页码
  228. * @param int $pageSize 每页数量
  229. * @param array|null $type 奖品类型筛选数组
  230. * @return \think\Paginator
  231. */
  232. public static function getPrizes($activityId = null, $page = 1, $pageSize = 10, $type = null)
  233. {
  234. $where = [];
  235. // 如果指定了活动ID,查询该活动的奖品
  236. if ($activityId) {
  237. $where['activity_id'] = $activityId;
  238. } else {
  239. // 否则查询进行中活动的奖品
  240. $now = time();
  241. $runningActivityIds = LotteryActivity::where('status', LotteryEnum::STATUS_ONGOING)
  242. ->where('start_time', '<=', $now)
  243. ->where('end_time', '>=', $now)
  244. ->column('id');
  245. if (empty($runningActivityIds)) {
  246. // 返回空的分页对象
  247. $prizeModel = new \app\common\model\lottery\LotteryPrize();
  248. return $prizeModel->where('id', 0)->paginate($pageSize, false, ['page' => $page]);
  249. }
  250. $where['activity_id'] = ['in', $runningActivityIds];
  251. }
  252. // 奖品状态筛选(只查询有效的奖品)
  253. $where['status'] = 1;
  254. // 奖品类型筛选
  255. if ($type && is_array($type) && !empty($type)) {
  256. $where['type'] = ['in', $type];
  257. }
  258. // 使用模型的分页查询器
  259. $prizeModel = new \app\common\model\lottery\LotteryPrize();
  260. $paginate = $prizeModel->where($where)
  261. ->field('id,activity_id,name,type,image,description,probability,total_stock,remain_stock,win_prompt,sort_order,unlock_people_num,createtime')
  262. ->order('sort_order asc, createtime desc')
  263. ->paginate($pageSize, false, ['page' => $page]);
  264. // 处理分页数据,添加额外信息
  265. foreach ($paginate->items() as $prize) {
  266. // 获取活动信息
  267. $activity = LotteryActivity::find($prize->activity_id);
  268. $prize->activity_name = $activity->name ?? '';
  269. $prize->activity_status = $activity->status ?? 0;
  270. // 奖品类型文本
  271. $prize->type_text = LotteryEnum::getPrizeTypeText($prize->type);
  272. // 检查奖品是否已解锁(如果活动开启按人数解锁)
  273. if ($activity && $activity->unlock_by_people && $prize->unlock_people_num) {
  274. $currentPeopleCount = \app\common\Service\lottery\LotteryChanceService::getActivityParticipants($prize->activity_id);
  275. $prize->is_unlocked = $currentPeopleCount >= $prize->unlock_people_num;
  276. } else {
  277. $prize->is_unlocked = true;
  278. }
  279. // 计算中奖率百分比
  280. $prize->probability_percent = round($prize->probability * 100, 2);
  281. // 计算库存百分比
  282. if ($prize->total_stock > 0) {
  283. $prize->stock_percent = round(($prize->remain_stock / $prize->total_stock) * 100, 2);
  284. } else {
  285. $prize->stock_percent = 0;
  286. }
  287. }
  288. return $paginate;
  289. }
  290. /**
  291. * 获取活动奖品统计信息
  292. * @param int $activityId 活动ID
  293. * @return array
  294. */
  295. public static function getActivityPrizeStats($activityId)
  296. {
  297. $prizes = \app\common\model\lottery\LotteryPrize::where('activity_id', $activityId)
  298. ->where('status', 1)
  299. ->select();
  300. $stats = [
  301. 'total_prizes' => 0,
  302. 'total_stock' => 0,
  303. 'remain_stock' => 0,
  304. 'used_stock' => 0,
  305. 'prize_types' => [],
  306. 'unlocked_prizes' => 0,
  307. 'locked_prizes' => 0
  308. ];
  309. foreach ($prizes as $prize) {
  310. $stats['total_prizes']++;
  311. $stats['total_stock'] += $prize->total_stock;
  312. $stats['remain_stock'] += $prize->remain_stock;
  313. $stats['used_stock'] += ($prize->total_stock - $prize->remain_stock);
  314. // 统计奖品类型
  315. $typeText = LotteryEnum::getPrizeTypeText($prize->type);
  316. if (!isset($stats['prize_types'][$prize->type])) {
  317. $stats['prize_types'][$prize->type] = [
  318. 'type' => $prize->type,
  319. 'type_text' => $typeText,
  320. 'count' => 0,
  321. 'total_stock' => 0,
  322. 'remain_stock' => 0
  323. ];
  324. }
  325. $stats['prize_types'][$prize->type]['count']++;
  326. $stats['prize_types'][$prize->type]['total_stock'] += $prize->total_stock;
  327. $stats['prize_types'][$prize->type]['remain_stock'] += $prize->remain_stock;
  328. // 检查解锁状态
  329. $activity = LotteryActivity::find($activityId);
  330. if ($activity && $activity->unlock_by_people && $prize->unlock_people_num) {
  331. $currentPeopleCount = \app\common\Service\lottery\LotteryChanceService::getActivityParticipants($activityId);
  332. if ($currentPeopleCount >= $prize->unlock_people_num) {
  333. $stats['unlocked_prizes']++;
  334. } else {
  335. $stats['locked_prizes']++;
  336. }
  337. } else {
  338. $stats['unlocked_prizes']++;
  339. }
  340. }
  341. return $stats;
  342. }
  343. /**
  344. * 获取进行中活动的奖品列表
  345. * @param int $page 页码
  346. * @param int $pageSize 每页数量
  347. * @param int|array|null $type 奖品类型筛选,支持单个类型或类型数组
  348. * @return \think\Paginator
  349. */
  350. public static function getRunningActivityPrizes($page = 1, $pageSize = 20, $type = null)
  351. {
  352. return self::getPrizes(null, $page, $pageSize, $type);
  353. }
  354. /**
  355. * 获取指定活动的奖品列表
  356. * @param int $activityId 活动ID
  357. * @param int $page 页码
  358. * @param int $pageSize 每页数量
  359. * @param int|array|null $type 奖品类型筛选,支持单个类型或类型数组
  360. * @return \think\Paginator
  361. */
  362. public static function getActivityPrizes($activityId, $page = 1, $pageSize = 20, $type = null)
  363. {
  364. return self::getPrizes($activityId, $page, $pageSize, $type);
  365. }
  366. }