Add VIP presence themes and custom greetings

app/Jobs/ProcessUserLeave.php

@@ -1,5 +1,10 @@
 <?php
 
+/**
+ * 文件功能：用户离开聊天室后的异步清理与播报任务
+ * 负责清理在线状态、关闭勤务日志，并根据会员/管理员身份发送不同的离场提示。
+ */
+
 namespace App\Jobs;
 
 use App\Models\PositionDutyLog;
@@ -19,12 +24,18 @@ class ProcessUserLeave implements ShouldQueue
 {
     use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;
 
+    /**
+     * 构造离场处理任务实例。
+     */
     public function __construct(
         public int $roomId,
         public User $user,
         public float $leaveTime
     ) {}
 
+    /**
+     * 执行离场任务：清理在线状态并广播离场消息。
+     */
     public function handle(ChatStateService $chatState, RoomBroadcastService $broadcast): void
     {
         // 获取该用户最后一次进入房间的时间
@@ -66,6 +77,7 @@ class ProcessUserLeave implements ShouldQueue
             ];
         } else {
             [$leaveText, $color] = $broadcast->buildLeaveBroadcast($this->user);
+            $vipPresencePayload = $broadcast->buildVipPresencePayload($this->user, 'leave');
             $leaveMsg = [
                 'id' => $chatState->nextMessageId($this->roomId),
                 'room_id' => $this->roomId,
@@ -74,16 +86,26 @@ class ProcessUserLeave implements ShouldQueue
                 'content' => "<span style=\"color: {$color}; font-weight: bold;\">{$leaveText}</span>",
                 'is_secret' => false,
                 'font_color' => $color,
-                'action' => 'system_welcome',
+                'action' => empty($vipPresencePayload) ? 'system_welcome' : 'vip_presence',
                 'welcome_user' => $this->user->username,
                 'sent_at' => now()->toDateTimeString(),
             ];
+
+            // 会员离场时，把横幅与特效信息挂到消息体，前端才能展示专属离场效果。
+            if (! empty($vipPresencePayload)) {
+                $leaveMsg = array_merge($leaveMsg, $vipPresencePayload);
+            }
         }
 
         // 将播报存入 Redis 历史及广播
         $chatState->pushMessage($this->roomId, $leaveMsg);
         broadcast(new \App\Events\UserLeft($this->roomId, $this->user->username))->toOthers();
         broadcast(new \App\Events\MessageSent($this->roomId, $leaveMsg))->toOthers();
+
+        // 离场特效单独发送给房间内仍在线的其他人，避免和消息播报逻辑耦死。
+        if (! empty($leaveMsg['presence_effect'])) {
+            broadcast(new \App\Events\EffectBroadcast($this->roomId, $leaveMsg['presence_effect'], $this->user->username))->toOthers();
+        }
     }
 
     /**