feat: 扩展奖池、风控与报表能力，新增对账补偿、广播和人工操作接口

app/Services/Draw/DrawHallSnapshotBuilder.php

@@ -9,6 +9,7 @@ use App\Lottery\DrawStatus;
 use App\Models\DrawResultItem;
 use App\Models\DrawResultBatch;
 use App\Lottery\DrawResultBatchStatus;
+use App\Services\Jackpot\JackpotSummaryService;
 
 /**
  * `GET draw/current` 与大厅 WS 快照共用数据结构。
@@ -17,6 +18,10 @@ use App\Lottery\DrawResultBatchStatus;
  */
 final class DrawHallSnapshotBuilder
 {
+    public function __construct(
+        private readonly JackpotSummaryService $jackpotSummary,
+    ) {}
+
     /**
      * Tick 未及时跑时，DB 仍为 `open` 但已到封盘时刻；对外快照与界面应对齐真实可下注态（见 DrawTickService::openToClosingOrClosed）。
      *
@@ -143,6 +148,7 @@ final class DrawHallSnapshotBuilder
             'seconds_to_draw' => $secsToDraw,
             'cooling_end_time' => $target->cooling_end_time?->toIso8601String(),
             'seconds_remaining_in_cooldown' => $coolingRemain,
+            'jackpot' => $this->jackpotSummary->summary('NPR'),
         ];
 
         $riskAlerts = RiskPool::query()

app/Services/Draw/DrawResultViewService.php

@@ -8,6 +8,7 @@ use App\Models\DrawResultItem;
 use App\Models\DrawResultBatch;
 use Illuminate\Support\Collection;
 use App\Lottery\DrawResultBatchStatus;
+use App\Services\Jackpot\JackpotSummaryService;
 use Illuminate\Contracts\Pagination\LengthAwarePaginator;
 
 /**
@@ -15,6 +16,10 @@ use Illuminate\Contracts\Pagination\LengthAwarePaginator;
  */
 final class DrawResultViewService
 {
+    public function __construct(
+        private readonly JackpotSummaryService $jackpotSummary,
+    ) {}
+
     /**
      * 与 `docs/01-产品文档` GET /api/v1/results 示例键名对齐（1st/2nd/3rd/starter/consolation）。
      *
@@ -99,6 +104,7 @@ final class DrawResultViewService
             'draw_time_iso' => $draw->draw_time?->toIso8601String(),
             'result_version' => $version,
             'result_source' => $draw->result_source,
+            'jackpot' => $this->jackpotSummary->summary('NPR'),
             'results' => $numbers,
             'result_items' => $items->map(fn (DrawResultItem $r) => [
                 'prize_type' => $r->prize_type,

app/Services/Draw/LotteryHallRealtimeBroadcaster.php

@@ -6,6 +6,7 @@ use App\Events\OddsUpdateBroadcast;
 use App\Events\PlayToggleBroadcast;
 use App\Events\RiskSoldOutBroadcast;
 use App\Events\RiskWarningBroadcast;
+use App\Events\JackpotBurstBroadcast;
 use App\Events\DrawCountdownBroadcast;
 use App\Events\DrawStatusChangeBroadcast;
 use App\Events\DrawResultPublishedBroadcast;
@@ -13,7 +14,7 @@ use App\Events\DrawResultPublishedBroadcast;
 /**
  * 对齐界面文档 §2.1：大厅公共频道广播（`lottery-hall`）。
  * 包含：draw.countdown、draw.status_change、result.published、
- *       risk.sold_out、risk.warning、play.toggle、odds.update
+ *       risk.sold_out、risk.warning、play.toggle、odds.update、jackpot.burst
  */
 final class LotteryHallRealtimeBroadcaster
 {
@@ -132,6 +133,34 @@ final class LotteryHallRealtimeBroadcaster
         ));
     }
 
+    /** `jackpot.burst` —— Jackpot 爆池动画与浏览器通知 */
+    public function notifyJackpotBurst(
+        int $drawId,
+        string $drawNo,
+        string $firstPrizeNumber,
+        string $currencyCode,
+        int $totalPayoutAmount,
+        int $winnerCount,
+        string $triggerType,
+        int $poolAmountAfter,
+    ): void {
+        if (! $this->driverSupportsRealtime()) {
+            return;
+        }
+
+        broadcast(new JackpotBurstBroadcast(
+            $drawId,
+            $drawNo,
+            $firstPrizeNumber,
+            strtoupper($currencyCode),
+            $totalPayoutAmount,
+            $winnerCount,
+            $triggerType,
+            $poolAmountAfter,
+            (int) floor(microtime(true) * 1000),
+        ));
+    }
+
     private function driverSupportsRealtime(): bool
     {
         $default = config('broadcasting.default');