功能：婚姻系统第8&10步（Controllers + Events + 路由）

- MarriageController：propose/accept/reject/divorce/confirmDivorce/status - WeddingController：tiers/setup（立即触发）/claim/envelopeStatus - 8个 WebSocket Events： Marriage{Proposed|Accepted|Rejected|Expired|Divorced|DivorceRequested} WeddingCelebration / EnvelopeClaimed - 前台路由：marriage.* + wedding.* - 后台路由：admin.marriages.*（superlevel 层）
2026-03-01 15:09:33 +08:00
parent 384cf8e078
commit 4f49fb7ce8
12 changed files with 929 additions and 0 deletions
@@ -0,0 +1,70 @@
+<?php
+
+/**
+ * 文件功能：协议离婚申请通知事件（广播至对方私人频道）
+ *
+ * 触发时机：一方申请协议离婚后广播，对方收到 Banner 含确认/拒绝按钮。
+ *
+ * @author  ChatRoom Laravel
+ *
+ * @version 1.0.0
+ */
+
+namespace App\Events;
+
+use App\Models\Marriage;
+use Illuminate\Broadcasting\InteractsWithSockets;
+use Illuminate\Broadcasting\PrivateChannel;
+use Illuminate\Contracts\Broadcasting\ShouldBroadcastNow;
+use Illuminate\Foundation\Events\Dispatchable;
+use Illuminate\Queue\SerializesModels;
+
+class MarriageDivorceRequested implements ShouldBroadcastNow
+{
+    use Dispatchable, InteractsWithSockets, SerializesModels;
+
+    /**
+     * @param  Marriage  $marriage  婚姻记录
+     */
+    public function __construct(
+        public readonly Marriage $marriage,
+    ) {}
+
+    /**
+     * 广播至对方私人频道（divorcer 的对方）。
+     *
+     * @return array<int, \Illuminate\Broadcasting\Channel>
+     */
+    public function broadcastOn(): array
+    {
+        // 离婚申请方的对方
+        $targetId = $this->marriage->user_id === $this->marriage->divorcer_id
+            ? $this->marriage->partner_id
+            : $this->marriage->user_id;
+
+        return [new PrivateChannel('user.'.$targetId)];
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function broadcastWith(): array
+    {
+        $this->marriage->load(['user:id,username', 'partner:id,username']);
+
+        return [
+            'marriage_id' => $this->marriage->id,
+            'divorcer_username' => $this->marriage->user_id === $this->marriage->divorcer_id
+                ? $this->marriage->user?->username
+                : $this->marriage->partner?->username,
+            'timeout_hours' => 72,
+            'requested_at' => $this->marriage->divorce_requested_at,
+        ];
+    }
+
+    /** 广播事件名称。 */
+    public function broadcastAs(): string
+    {
+        return 'marriage.divorce_requested';
+    }
+}