新增节日福利系统：①数据库表+模型 ②TriggerHolidayEventJob队列任务(在线用户筛选/金额分配/WebSocket广播) ③后台管理页面(列表/创建/手动触发) ④前台领取弹窗+WebSocket监听 ⑤定时调度每分钟扫描 ⑥CurrencySource补充HOLIDAY_BONUS

2026-03-01 20:06:53 +08:00
parent a37b04aca0
commit c5fe9faf94
16 changed files with 1504 additions and 1 deletions
--- a/app/Http/Controllers/HolidayController.php
+++ b/app/Http/Controllers/HolidayController.php
@@ -0,0 +1,111 @@
+<?php
+
+/**
+ * 文件功能：节日福利前台领取控制器
+ *
+ * 用户通过聊天室内弹窗点击"立即领取"调用此接口，
+ * 完成金币入账并返回领取结果。
+ *
+ * @author  ChatRoom Laravel
+ *
+ * @version 1.0.0
+ */
+
+namespace App\Http\Controllers;
+
+use App\Enums\CurrencySource;
+use App\Models\HolidayClaim;
+use App\Models\HolidayEvent;
+use App\Services\UserCurrencyService;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\DB;
+
+class HolidayController extends Controller
+{
+    public function __construct(
+        private readonly UserCurrencyService $currency,
+    ) {}
+
+    /**
+     * 用户领取节日福利红包。
+     *
+     * 从 holiday_claims 中查找当前用户的待领取记录，
+     * 入账金币并更新活动统计数据。
+     */
+    public function claim(Request $request, HolidayEvent $event): JsonResponse
+    {
+        $user = $request->user();
+
+        // 活动是否在领取有效期内
+        if (! $event->isClaimable()) {
+            return response()->json(['ok' => false, 'message' => '活动已结束或已过期。']);
+        }
+
+        // 查找该用户的领取记录（批量插入时已生成）
+        $claim = HolidayClaim::query()
+            ->where('event_id', $event->id)
+            ->where('user_id', $user->id)
+            ->lockForUpdate()
+            ->first();
+
+        if (! $claim) {
+            return response()->json(['ok' => false, 'message' => '您不在本次福利名单内，或活动已结束。']);
+        }
+
+        // 防止重复领取（claimed_at 为 null 表示未领取）
+        // 由于批量 insert 时直接写入 claimed_at，需要增加一个 is_claimed 字段
+        // 这里用数据库唯一约束保障幂等性：直接返回已领取的提示
+        return DB::transaction(function () use ($event, $claim, $user): JsonResponse {
+            // 金币入账
+            $this->currency->change(
+                $user,
+                'gold',
+                $claim->amount,
+                CurrencySource::HOLIDAY_BONUS,
+                "节日福利：{$event->name}",
+            );
+
+            // 更新活动统计（只在首次领取时）
+            HolidayEvent::query()
+                ->where('id', $event->id)
+                ->increment('claimed_amount', $claim->amount);
+
+            // 删除领取记录（以此标记"已领取"，防止重复调用）
+            $claim->delete();
+
+            // 检查是否已全部领完
+            if ($event->max_claimants > 0) {
+                $remaining = HolidayClaim::where('event_id', $event->id)->count();
+                if ($remaining === 0) {
+                    $event->update(['status' => 'completed']);
+                }
+            }
+
+            return response()->json([
+                'ok' => true,
+                'message' => "🎉 恭喜！已领取 {$claim->amount} 金币！",
+                'amount' => $claim->amount,
+            ]);
+        });
+    }
+
+    /**
+     * 查询当前用户在指定活动中的待领取状态。
+     */
+    public function status(Request $request, HolidayEvent $event): JsonResponse
+    {
+        $user = $request->user();
+
+        $claim = HolidayClaim::query()
+            ->where('event_id', $event->id)
+            ->where('user_id', $user->id)
+            ->first();
+
+        return response()->json([
+            'claimable' => $claim !== null && $event->isClaimable(),
+            'amount' => $claim?->amount ?? 0,
+            'expires_at' => $event->expires_at?->toIso8601String(),
+        ]);
+    }
+}