lkddi/chatroom
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source 
- 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 层）
This commit is contained in:
流星
2026-03-01 15:09:33 +08:00
parent 384cf8e078
commit 4f49fb7ce8
12 changed files with 929 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
app/Events/EnvelopeClaimed.php
+64
View File
@@ -0,0 +1,64 @@
<?php
/**
* 文件功能：婚礼红包领取成功事件（广播至领取者私人频道）
*
* 触发时机：WeddingController::claim() 成功后广播，前端展示到账 Toast。
*
* @author ChatRoom Laravel
*
* @version 1.0.0
*/
namespace App\Events;
use App\Models\User;
use Illuminate\Broadcasting\InteractsWithSockets;
use Illuminate\Broadcasting\PrivateChannel;
use Illuminate\Contracts\Broadcasting\ShouldBroadcastNow;
use Illuminate\Foundation\Events\Dispatchable;
use Illuminate\Queue\SerializesModels;
class EnvelopeClaimed implements ShouldBroadcastNow
{
use Dispatchable, InteractsWithSockets, SerializesModels;
/**
* @param User $claimer 领取用户
* @param int $amount 领取金额
* @param int $ceremonyId 婚礼仪式 ID
*/
public function __construct(
public readonly User $claimer,
public readonly int $amount,
public readonly int $ceremonyId,
) {}
/**
* 广播至领取者私人频道。
*
* @return array<int, \Illuminate\Broadcasting\Channel>
*/
public function broadcastOn(): array
{
return [new PrivateChannel('user.'.$this->claimer->id)];
}
/**
* @return array<string, mixed>
*/
public function broadcastWith(): array
{
return [
'ceremony_id' => $this->ceremonyId,
'amount' => $this->amount,
'message' => "🎉 成功领取 {$this->amount} 金币婚礼红包！",
];
}
/** 广播事件名称。 */
public function broadcastAs(): string
{
return 'envelope.claimed';
}
}
app/Events/MarriageAccepted.php
+68
View File
@@ -0,0 +1,68 @@
<?php
/**
* 文件功能：结婚公告事件（广播至全房间）
*
* 触发时机：求婚被接受，正式结婚后广播。
* 前端收到后展示全屏烟花特效 + 婚礼设置弹窗（仅婚姻双方）。
*
* @author ChatRoom Laravel
*
* @version 1.0.0
*/
namespace App\Events;
use App\Models\Marriage;
use Illuminate\Broadcasting\InteractsWithSockets;
use Illuminate\Broadcasting\PresenceChannel;
use Illuminate\Contracts\Broadcasting\ShouldBroadcastNow;
use Illuminate\Foundation\Events\Dispatchable;
use Illuminate\Queue\SerializesModels;
class MarriageAccepted implements ShouldBroadcastNow
{
use Dispatchable, InteractsWithSockets, SerializesModels;
/**
* @param Marriage $marriage 婚姻记录
*/
public function __construct(
public readonly Marriage $marriage,
) {}
/**
* 广播至当前所有房间（PresenceChannel room.*）。
* 使用大厅房间 ID=1，若业务支持多房间可扩展。
*
* @return array<int, \Illuminate\Broadcasting\Channel>
*/
public function broadcastOn(): array
{
return [new PresenceChannel('room.1')];
}
/**
* 广播数据。
*
* @return array<string, mixed>
*/
public function broadcastWith(): array
{
$this->marriage->load(['user:id,username,headface', 'partner:id,username,headface', 'ringItem:id,name,icon']);
return [
'marriage_id' => $this->marriage->id,
'user' => $this->marriage->user?->only(['id', 'username', 'headface']),
'partner' => $this->marriage->partner?->only(['id', 'username', 'headface']),
'ring' => $this->marriage->ringItem?->only(['name', 'icon']),
'married_at' => $this->marriage->married_at,
];
}
/** 广播事件名称。 */
public function broadcastAs(): string
{
return 'marriage.accepted';
}
}
app/Events/MarriageDivorceRequested.php
+70
View File
@@ -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';
}
}
app/Events/MarriageDivorced.php
+65
View File
@@ -0,0 +1,65 @@
<?php
/**
* 文件功能：离婚公告事件（广播至全房间）
*
* 触发时机：协议/强制/自动离婚完成后广播。
* 强制离婚时额外显示财产转移信息。
*
* @author ChatRoom Laravel
*
* @version 1.0.0
*/
namespace App\Events;
use App\Models\Marriage;
use Illuminate\Broadcasting\InteractsWithSockets;
use Illuminate\Broadcasting\PresenceChannel;
use Illuminate\Contracts\Broadcasting\ShouldBroadcastNow;
use Illuminate\Foundation\Events\Dispatchable;
use Illuminate\Queue\SerializesModels;
class MarriageDivorced implements ShouldBroadcastNow
{
use Dispatchable, InteractsWithSockets, SerializesModels;
/**
* @param Marriage $marriage 婚姻记录
* @param string $divorceType 离婚类型（mutual|forced|auto|admin）
*/
public function __construct(
public readonly Marriage $marriage,
public readonly string $divorceType,
) {}
/**
* 广播至全房间。
*
* @return array<int, \Illuminate\Broadcasting\Channel>
*/
public function broadcastOn(): array
{
return [new PresenceChannel('room.1')];
}
/**
* @return array<string, mixed>
*/
public function broadcastWith(): array
{
$this->marriage->load(['user:id,username', 'partner:id,username']);
return [
'user_username' => $this->marriage->user?->username,
'partner_username' => $this->marriage->partner?->username,
'divorce_type' => $this->divorceType,
];
}
/** 广播事件名称。 */
public function broadcastAs(): string
{
return 'marriage.divorced';
}
}
app/Events/MarriageExpired.php
+60
View File
@@ -0,0 +1,60 @@
<?php
/**
* 文件功能：求婚超时失效事件（广播至求婚方私人频道）
*
* 触发时机：Horizon Job ExpireMarriageProposals 扫描到超时求婚后广播。
*
* @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 MarriageExpired implements ShouldBroadcastNow
{
use Dispatchable, InteractsWithSockets, SerializesModels;
/**
* @param Marriage $marriage 婚姻记录
*/
public function __construct(
public readonly Marriage $marriage,
) {}
/**
* 广播至求婚方私人频道。
*
* @return array<int, \Illuminate\Broadcasting\Channel>
*/
public function broadcastOn(): array
{
return [new PrivateChannel('user.'.$this->marriage->user_id)];
}
/**
* @return array<string, mixed>
*/
public function broadcastWith(): array
{
return [
'partner_username' => $this->marriage->partner?->username,
'ring_name' => $this->marriage->ringItem?->name,
'message' => '求婚已超时失效，戒指已消失。',
];
}
/** 广播事件名称。 */
public function broadcastAs(): string
{
return 'marriage.expired';
}
}
app/Events/MarriageProposed.php
+73
View File
@@ -0,0 +1,73 @@
<?php
/**
* 文件功能：求婚事件（广播至被求婚方私人频道）
*
* 触发时机：MarriageController::propose() 成功后广播。
* B 上线时前端订阅频道立即收到，展示求婚 Banner 弹窗。
*
* @author ChatRoom Laravel
*
* @version 1.0.0
*/
namespace App\Events;
use App\Models\Marriage;
use App\Models\User;
use Illuminate\Broadcasting\InteractsWithSockets;
use Illuminate\Broadcasting\PrivateChannel;
use Illuminate\Contracts\Broadcasting\ShouldBroadcastNow;
use Illuminate\Foundation\Events\Dispatchable;
use Illuminate\Queue\SerializesModels;
class MarriageProposed implements ShouldBroadcastNow
{
use Dispatchable, InteractsWithSockets, SerializesModels;
/**
* @param Marriage $marriage 婚姻记录
* @param User $proposer 求婚方
* @param User $target 被求婚方
*/
public function __construct(
public readonly Marriage $marriage,
public readonly User $proposer,
public readonly User $target,
) {}
/**
* 广播至被求婚方私人频道。
*
* @return array<int, \Illuminate\Broadcasting\Channel>
*/
public function broadcastOn(): array
{
return [new PrivateChannel('user.'.$this->target->id)];
}
/**
* 广播数据。
*
* @return array<string, mixed>
*/
public function broadcastWith(): array
{
return [
'marriage_id' => $this->marriage->id,
'proposer' => [
'username' => $this->proposer->username,
'headface' => $this->proposer->headface,
'user_level' => $this->proposer->user_level,
],
'ring' => $this->marriage->ringItem?->only(['name', 'icon']),
'expires_at' => $this->marriage->expires_at,
];
}
/** 广播事件名称。 */
public function broadcastAs(): string
{
return 'marriage.proposed';
}
}
app/Events/MarriageRejected.php
+60
View File
@@ -0,0 +1,60 @@
<?php
/**
* 文件功能：求婚被拒事件（广播至求婚方私人频道）
*
* 触发时机：对方拒绝求婚，戒指消失后广播。
*
* @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 MarriageRejected implements ShouldBroadcastNow
{
use Dispatchable, InteractsWithSockets, SerializesModels;
/**
* @param Marriage $marriage 婚姻记录
*/
public function __construct(
public readonly Marriage $marriage,
) {}
/**
* 广播至求婚方私人频道。
*
* @return array<int, \Illuminate\Broadcasting\Channel>
*/
public function broadcastOn(): array
{
return [new PrivateChannel('user.'.$this->marriage->user_id)];
}
/**
* @return array<string, mixed>
*/
public function broadcastWith(): array
{
return [
'partner_username' => $this->marriage->partner?->username,
'ring_name' => $this->marriage->ringItem?->name,
'message' => '对方拒绝了您的求婚，戒指已消失。',
];
}
/** 广播事件名称。 */
public function broadcastAs(): string
{
return 'marriage.rejected';
}
}
app/Events/WeddingCelebration.php
+73
View File
@@ -0,0 +1,73 @@
<?php
/**
* 文件功能：婚礼庆典事件（广播至全房间）
*
* 触发时机：婚礼红包触发分发后广播。
* 前端收到后：播放烟花特效 + 婚礼音效 + 展示红包弹窗（含领取按钮）。
*
* @author ChatRoom Laravel
*
* @version 1.0.0
*/
namespace App\Events;
use App\Models\Marriage;
use App\Models\WeddingCeremony;
use Illuminate\Broadcasting\InteractsWithSockets;
use Illuminate\Broadcasting\PresenceChannel;
use Illuminate\Contracts\Broadcasting\ShouldBroadcastNow;
use Illuminate\Foundation\Events\Dispatchable;
use Illuminate\Queue\SerializesModels;
class WeddingCelebration implements ShouldBroadcastNow
{
use Dispatchable, InteractsWithSockets, SerializesModels;
/**
* @param WeddingCeremony $ceremony 婚礼仪式记录
* @param Marriage $marriage 婚姻记录
*/
public function __construct(
public readonly WeddingCeremony $ceremony,
public readonly Marriage $marriage,
) {}
/**
* 广播至全房间。
*
* @return array<int, \Illuminate\Broadcasting\Channel>
*/
public function broadcastOn(): array
{
return [new PresenceChannel('room.1')];
}
/**
* 广播数据（前端据此展示红包弹窗及新人信息）。
*
* @return array<string, mixed>
*/
public function broadcastWith(): array
{
$this->marriage->load(['user:id,username,headface', 'partner:id,username,headface', 'ringItem:id,name,icon']);
return [
'ceremony_id' => $this->ceremony->id,
'tier_name' => $this->ceremony->tier?->name ?? '婚礼',
'tier_icon' => $this->ceremony->tier?->icon ?? '🎊',
'total_amount' => $this->ceremony->total_amount,
'expires_at' => $this->ceremony->expires_at,
'user' => $this->marriage->user?->only(['id', 'username', 'headface']),
'partner' => $this->marriage->partner?->only(['id', 'username', 'headface']),
'ring' => $this->marriage->ringItem?->only(['name', 'icon']),
];
}
/** 广播事件名称。 */
public function broadcastAs(): string
{
return 'wedding.celebration';
}
}