Files
lotteryLaravel/app/Events/RiskSoldOutBroadcast.php
kang f0e0966a73
Some checks failed
lotterLaravel CI / test (push) Has been cancelled
lotterLaravel E2E / e2e-api (push) Has been cancelled
fix(lottery): 增加广播任务时效保护并强化命令异常处理
- 为多个广播事件添加 retryUntil 方法,设置派发后 30 秒内必须执行,否则丢弃
- 修改 LotteryDrawTickCommand handle,添加异常捕获及错误日志,保证失败时返回 FAILURE
- 修改 LotteryHallCountdownCommand handle,添加异常捕获及错误日志,超时情况写入警告日志
- 针对 SettlementOrchestrator 和 DrawHallSnapshotBuilder 查询结果添加限制,防止数据量过大
- 调整计划任务 withoutOverlapping 调用,增加 expiresAt 参数避免任务锁死
- 更新 .env.example,完善本地开发与生产环境部署说明及日志配置说明
- 移除 e2e 相关测试代码、配置及依赖,精简项目体积
2026-07-07 13:37:05 +08:00

77 lines
2.1 KiB
PHP
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<?php
namespace App\Events;
use Illuminate\Broadcasting\Channel;
use Illuminate\Queue\SerializesModels;
use Illuminate\Foundation\Events\Dispatchable;
use Illuminate\Broadcasting\InteractsWithSockets;
use Illuminate\Contracts\Broadcasting\ShouldBroadcast;
/**
* 界面文档 §2.1`risk.sold_out` —— 号码赔付池耗尽推送。
*
* 触发时机:某号码的风险池额度被完全占用时。
* 前端处理:该号码的玩法格子标记为售罄(置灰或禁用)。
*/
final class RiskSoldOutBroadcast implements ShouldBroadcast
{
use Dispatchable, InteractsWithSockets, SerializesModels;
/** 异步广播队列 */
public string $queue = 'broadcasts';
/** 最多重试 3 次 */
public int $tries = 3;
/** 单任务超时 10 秒 */
public int $timeout = 10;
/** 广播时效性保护:派发后 30 秒内必须开始执行,否则丢弃 */
public function retryUntil(): \DateTimeInterface
{
return now()->addSeconds(30);
}
/**
* @param int $drawId 期号 ID
* @param string $drawNo 期号编号(如 20260101-001
* @param string $normalizedNumber 标准化后的 4 位号码
* @param int $emittedAtMs 发送时间戳(毫秒)
*/
public function __construct(
public readonly int $drawId,
public readonly string $drawNo,
public readonly string $normalizedNumber,
public readonly int $emittedAtMs,
) {}
/**
* 公共频道,所有在大厅的玩家都能收到。
*
* @return array<int, Channel>
*/
public function broadcastOn(): array
{
return [new Channel('lottery-hall')];
}
public function broadcastAs(): string
{
return 'risk.sold_out';
}
/**
* @return array{draw_id: int, draw_no: string, normalized_number: string, emitted_at_ms: int}
*/
public function broadcastWith(): array
{
return [
'draw_id' => $this->drawId,
'draw_no' => $this->drawNo,
'normalized_number' => $this->normalizedNumber,
'emitted_at_ms' => $this->emittedAtMs,
];
}
}