<?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,
        ];
    }
}