Files
lotteryLaravel/app/Events/PlayCatalogUpdatedBroadcast.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

74 lines
2.2 KiB
PHP

<?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;
/**
* 界面文档扩展:`play.catalog_updated` —— 玩法目录/限额/封顶等生效版本变更。
*
* 触发时机:后台发布玩法配置、赔率、风控封顶版本(及同类全量变更)时。
* 前端处理:重新拉取 `GET /api/v1/play/effective`。
*/
final class PlayCatalogUpdatedBroadcast 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 string $module play_config|odds|risk_cap
* @param array<string, mixed>|null $meta
*/
public function __construct(
public readonly string $module,
public readonly int $versionId,
public readonly string $versionLabel,
public readonly ?array $meta,
public readonly int $emittedAtMs,
) {}
/** @return array<int, Channel> */
public function broadcastOn(): array
{
return [new Channel('lottery-hall')];
}
public function broadcastAs(): string
{
return 'play.catalog_updated';
}
/**
* @return array{module: string, version_id: int, version_label: string, meta: array<string, mixed>|null, message: string, emitted_at_ms: int}
*/
public function broadcastWith(): array
{
return [
'module' => $this->module,
'version_id' => $this->versionId,
'version_label' => $this->versionLabel,
'meta' => $this->meta,
'message' => '玩法配置已更新,请刷新后下注',
'emitted_at_ms' => $this->emittedAtMs,
];
}
}