新增节日福利系统：①数据库表+模型 ②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/Admin/HolidayEventController.php
+++ b/app/Http/Controllers/Admin/HolidayEventController.php
@@ -0,0 +1,151 @@
+<?php
+
+/**
+ * 文件功能：节日福利后台管理控制器
+ *
+ * 管理员可在此创建、编辑、删除节日福利活动，
+ * 也可手动立即触发活动，以及查看领取明细。
+ *
+ * @author  ChatRoom Laravel
+ *
+ * @version 1.0.0
+ */
+
+namespace App\Http\Controllers\Admin;
+
+use App\Http\Controllers\Controller;
+use App\Jobs\TriggerHolidayEventJob;
+use App\Models\HolidayEvent;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\RedirectResponse;
+use Illuminate\Http\Request;
+use Illuminate\View\View;
+
+class HolidayEventController extends Controller
+{
+    /**
+     * 节日福利活动列表页。
+     */
+    public function index(): View
+    {
+        $events = HolidayEvent::query()
+            ->orderByDesc('send_at')
+            ->paginate(20);
+
+        return view('admin.holiday-events.index', compact('events'));
+    }
+
+    /**
+     * 新建活动表单页。
+     */
+    public function create(): View
+    {
+        return view('admin.holiday-events.create');
+    }
+
+    /**
+     * 保存新活动。
+     */
+    public function store(Request $request): RedirectResponse
+    {
+        $data = $request->validate([
+            'name' => 'required|string|max:100',
+            'description' => 'nullable|string|max:500',
+            'total_amount' => 'required|integer|min:1',
+            'max_claimants' => 'required|integer|min:0',
+            'distribute_type' => 'required|in:random,fixed',
+            'min_amount' => 'nullable|integer|min:1',
+            'max_amount' => 'nullable|integer|min:1',
+            'fixed_amount' => 'nullable|integer|min:1',
+            'send_at' => 'required|date',
+            'expire_minutes' => 'required|integer|min:1|max:1440',
+            'repeat_type' => 'required|in:once,daily,weekly,monthly,cron',
+            'cron_expr' => 'nullable|string|max:100',
+            'target_type' => 'required|in:all,vip,level',
+            'target_value' => 'nullable|string|max:50',
+            'enabled' => 'boolean',
+        ]);
+
+        $data['status'] = 'pending';
+        $data['enabled'] = $request->boolean('enabled', true);
+
+        HolidayEvent::create($data);
+
+        return redirect()->route('admin.holiday-events.index')->with('success', '节日福利活动创建成功！');
+    }
+
+    /**
+     * 编辑活动表单页。
+     */
+    public function edit(HolidayEvent $holidayEvent): View
+    {
+        return view('admin.holiday-events.edit', ['event' => $holidayEvent]);
+    }
+
+    /**
+     * 更新活动。
+     */
+    public function update(Request $request, HolidayEvent $holidayEvent): RedirectResponse
+    {
+        $data = $request->validate([
+            'name' => 'required|string|max:100',
+            'description' => 'nullable|string|max:500',
+            'total_amount' => 'required|integer|min:1',
+            'max_claimants' => 'required|integer|min:0',
+            'distribute_type' => 'required|in:random,fixed',
+            'min_amount' => 'nullable|integer|min:1',
+            'max_amount' => 'nullable|integer|min:1',
+            'fixed_amount' => 'nullable|integer|min:1',
+            'send_at' => 'required|date',
+            'expire_minutes' => 'required|integer|min:1|max:1440',
+            'repeat_type' => 'required|in:once,daily,weekly,monthly,cron',
+            'cron_expr' => 'nullable|string|max:100',
+            'target_type' => 'required|in:all,vip,level',
+            'target_value' => 'nullable|string|max:50',
+        ]);
+
+        $holidayEvent->update($data);
+
+        return redirect()->route('admin.holiday-events.index')->with('success', '活动已更新！');
+    }
+
+    /**
+     * 切换活动启用/禁用状态。
+     */
+    public function toggle(HolidayEvent $holidayEvent): JsonResponse
+    {
+        $holidayEvent->update(['enabled' => ! $holidayEvent->enabled]);
+
+        return response()->json([
+            'ok' => true,
+            'enabled' => $holidayEvent->enabled,
+            'message' => $holidayEvent->enabled ? '已启用' : '已禁用',
+        ]);
+    }
+
+    /**
+     * 手动立即触发活动（管理员操作）。
+     */
+    public function triggerNow(HolidayEvent $holidayEvent): RedirectResponse
+    {
+        if ($holidayEvent->status !== 'pending') {
+            return back()->with('error', '只有待触发状态的活动才能手动触发。');
+        }
+
+        // 设置触发时间为当前，立即入队
+        $holidayEvent->update(['send_at' => now()]);
+        TriggerHolidayEventJob::dispatch($holidayEvent);
+
+        return back()->with('success', '活动已触发，请稍后刷新查看状态。');
+    }
+
+    /**
+     * 删除活动。
+     */
+    public function destroy(HolidayEvent $holidayEvent): RedirectResponse
+    {
+        $holidayEvent->delete();
+
+        return redirect()->route('admin.holiday-events.index')->with('success', '活动已删除。');
+    }
+}