kang
f0e0966a73
- 为多个广播事件添加 retryUntil 方法，设置派发后 30 秒内必须执行，否则丢弃 - 修改 LotteryDrawTickCommand handle，添加异常捕获及错误日志，保证失败时返回 FAILURE - 修改 LotteryHallCountdownCommand handle，添加异常捕获及错误日志，超时情况写入警告日志 - 针对 SettlementOrchestrator 和 DrawHallSnapshotBuilder 查询结果添加限制，防止数据量过大 - 调整计划任务 withoutOverlapping 调用，增加 expiresAt 参数避免任务锁死 - 更新 .env.example，完善本地开发与生产环境部署说明及日志配置说明 - 移除 e2e 相关测试代码、配置及依赖，精简项目体积
82 lines
2.5 KiB
PHP
82 lines
2.5 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;
|
||
|
||
/**
|
||
* 界面文档 §2.1：`risk.warning` —— 号码赔付池占用超 80% 预警推送。
|
||
*
|
||
* 触发时机：某号码的风险池占用比例超过阈值（默认 80%）时。
|
||
* 前端处理：该号码的玩法格子显示预警样式（如黄色边框或图标）。
|
||
*/
|
||
final class RiskWarningBroadcast 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 期号编号
|
||
* @param string $normalizedNumber 标准化后的 4 位号码
|
||
* @param float $usageRatio 占用比例（0-1 之间，如 0.85 表示 85%）
|
||
* @param int $emittedAtMs 发送时间戳（毫秒）
|
||
*/
|
||
public function __construct(
|
||
public readonly int $drawId,
|
||
public readonly string $drawNo,
|
||
public readonly string $normalizedNumber,
|
||
public readonly float $usageRatio,
|
||
public readonly int $emittedAtMs,
|
||
) {}
|
||
|
||
/**
|
||
* 公共频道，所有在大厅的玩家都能收到。
|
||
*
|
||
* @return array<int, Channel>
|
||
*/
|
||
public function broadcastOn(): array
|
||
{
|
||
return [new Channel('lottery-hall')];
|
||
}
|
||
|
||
public function broadcastAs(): string
|
||
{
|
||
return 'risk.warning';
|
||
}
|
||
|
||
/**
|
||
* @return array{draw_id: int, draw_no: string, normalized_number: string, usage_ratio: float, usage_percent: int, warning_threshold: float, emitted_at_ms: int}
|
||
*/
|
||
public function broadcastWith(): array
|
||
{
|
||
return [
|
||
'draw_id' => $this->drawId,
|
||
'draw_no' => $this->drawNo,
|
||
'normalized_number' => $this->normalizedNumber,
|
||
'usage_ratio' => round($this->usageRatio, 4),
|
||
'usage_percent' => (int) round($this->usageRatio * 100),
|
||
'warning_threshold' => 0.8, // 80% 阈值
|
||
'emitted_at_ms' => $this->emittedAtMs,
|
||
];
|
||
}
|
||
}
|