Feat: 实现全屏特效系统（烟花/下雨/雷电），管理员一键触发全房间广播

app/Events/EffectBroadcast.php

@@ -0,0 +1,68 @@
+<?php
+
+/**
+ * 文件功能：聊天室全屏特效广播事件
+ *
+ * 管理员触发烟花/下雨/雷电等特效后，
+ * 通过 WebSocket 广播给房间内所有在线用户，前端收到后播放对应 Canvas 动画。
+ *
+ * @package  App\Events
+ * @author   ChatRoom Laravel
+ * @version  1.0.0
+ */
+
+namespace App\Events;
+
+use Illuminate\Broadcasting\InteractsWithSockets;
+use Illuminate\Broadcasting\PresenceChannel;
+use Illuminate\Contracts\Broadcasting\ShouldBroadcastNow;
+use Illuminate\Foundation\Events\Dispatchable;
+use Illuminate\Queue\SerializesModels;
+
+class EffectBroadcast implements ShouldBroadcastNow
+{
+    use Dispatchable, InteractsWithSockets, SerializesModels;
+
+    /**
+     * 支持的特效类型列表（用于校验）
+     */
+    public const TYPES = ['fireworks', 'rain', 'lightning'];
+
+    /**
+     * 构造函数
+     *
+     * @param  int     $roomId    房间 ID
+     * @param  string  $type      特效类型：fireworks / rain / lightning
+     * @param  string  $operator  触发特效的管理员用户名
+     */
+    public function __construct(
+        public readonly int $roomId,
+        public readonly string $type,
+        public readonly string $operator,
+    ) {}
+
+    /**
+     * 广播频道：向房间内所有在线用户推送
+     *
+     * @return array<int, \Illuminate\Broadcasting\Channel>
+     */
+    public function broadcastOn(): array
+    {
+        return [
+            new PresenceChannel('room.' . $this->roomId),
+        ];
+    }
+
+    /**
+     * 广播数据：特效类型和操作者
+     *
+     * @return array<string, mixed>
+     */
+    public function broadcastWith(): array
+    {
+        return [
+            'type'     => $this->type,
+            'operator' => $this->operator,
+        ];
+    }
+}

app/Http/Controllers/AdminCommandController.php

@@ -373,6 +373,38 @@ class AdminCommandController extends Controller
         return response()->json(['status' => 'success', 'message' => '已执行全员清屏']);
     }
 
+    /**
+     * 管理员触发全屏特效（烟花/下雨/雷电）
+     *
+     * 向房间内所有用户广播 EffectBroadcast 事件，前端收到后播放对应 Canvas 动画。
+     * 仅 superlevel 等级管理员可触发。
+     *
+     * @param  Request  $request  请求对象，需包含 room_id, type
+     * @return JsonResponse 操作结果
+     */
+    public function effect(Request $request): JsonResponse
+    {
+        $request->validate([
+            'room_id' => 'required|integer',
+            'type'    => 'required|in:fireworks,rain,lightning',
+        ]);
+
+        $admin      = Auth::user();
+        $roomId     = $request->input('room_id');
+        $type       = $request->input('type');
+        $superLevel = (int) Sysparam::getValue('superlevel', '100');
+
+        // 仅 superlevel 等级可触发特效
+        if ($admin->user_level < $superLevel) {
+            return response()->json(['status' => 'error', 'message' => '仅站长可触发特效'], 403);
+        }
+
+        // 广播特效事件给房间内所有在线用户
+        broadcast(new \App\Events\EffectBroadcast($roomId, $type, $admin->username));
+
+        return response()->json(['status' => 'success', 'message' => "已触发特效：{$type}"]);
+    }
+
     /**
      * 权限检查：管理员是否可对目标用户执行指定操作
      *