修复跑马 不能正常显示赢后的奖励金额

tests/Feature/HorseRaceControllerTest.php

@@ -1,7 +1,15 @@
 <?php
 
+/**
+ * 文件功能：赛马竞猜功能测试
+ *
+ * 覆盖当前场次查询、下注约束、历史记录以及结算广播数据，
+ * 用于保证赛马玩法的接口行为与奖金展示链路稳定。
+ */
+
 namespace Tests\Feature;
 
+use App\Events\HorseRaceSettled;
 use App\Jobs\CloseHorseRaceJob;
 use App\Models\GameConfig;
 use App\Models\HorseBet;
@@ -13,10 +21,19 @@ use Illuminate\Support\Facades\Event;
 use Illuminate\Support\Facades\Queue;
 use Tests\TestCase;
 
+/**
+ * 类功能：赛马竞猜控制器与结算流程测试类
+ *
+ * 验证前台接口、结算任务以及广播载荷，防止下注和中奖金额
+ * 相关逻辑出现回归。
+ */
 class HorseRaceControllerTest extends TestCase
 {
     use RefreshDatabase;
 
+    /**
+     * 方法功能：初始化赛马默认配置。
+     */
     protected function setUp(): void
     {
         parent::setUp();
@@ -37,6 +54,9 @@ class HorseRaceControllerTest extends TestCase
         );
     }
 
+    /**
+     * 方法功能：验证可获取当前进行中的场次。
+     */
     public function test_can_get_current_race()
     {
         /** @var \App\Models\User $user */
@@ -61,6 +81,9 @@ class HorseRaceControllerTest extends TestCase
         $this->assertEquals($race->id, $response->json('race.id'));
     }
 
+    /**
+     * 方法功能：验证当前场次总注池会包含种子池金额。
+     */
     public function test_current_race_total_pool_includes_seed_pool(): void
     {
         GameConfig::updateOrCreate(
@@ -101,6 +124,52 @@ class HorseRaceControllerTest extends TestCase
         $this->assertSame(10000, $response->json('race.total_pool'));
     }
 
+    /**
+     * 方法功能：验证跑马阶段的总注池不会重复叠加下注金额。
+     */
+    public function test_current_race_running_total_pool_is_not_double_counted(): void
+    {
+        /** @var \App\Models\User $user */
+        $user = User::factory()->create();
+
+        $race = HorseRace::create([
+            'status' => 'running',
+            'bet_opens_at' => now()->subMinutes(2),
+            'bet_closes_at' => now()->subMinute(),
+            'race_starts_at' => now()->subSeconds(30),
+            'horses' => [
+                ['id' => 1, 'name' => 'Horse A', 'emoji' => '🐎'],
+                ['id' => 2, 'name' => 'Horse B', 'emoji' => '🏇'],
+            ],
+            'total_bets' => 2,
+            'total_pool' => 10000,
+        ]);
+
+        HorseBet::create([
+            'race_id' => $race->id,
+            'user_id' => User::factory()->create()->id,
+            'horse_id' => 1,
+            'amount' => 5000,
+            'status' => 'pending',
+        ]);
+
+        HorseBet::create([
+            'race_id' => $race->id,
+            'user_id' => User::factory()->create()->id,
+            'horse_id' => 2,
+            'amount' => 5000,
+            'status' => 'pending',
+        ]);
+
+        $response = $this->actingAs($user)->getJson(route('horse-race.current'));
+
+        $response->assertOk();
+        $this->assertSame(10000, $response->json('race.total_pool'));
+    }
+
+    /**
+     * 方法功能：验证用户可以成功下注。
+     */
     public function test_can_bet()
     {
         Event::fake();
@@ -138,6 +207,9 @@ class HorseRaceControllerTest extends TestCase
         ]);
     }
 
+    /**
+     * 方法功能：验证超出配置范围的下注会被拦截。
+     */
     public function test_cannot_bet_out_of_range()
     {
         /** @var \App\Models\User $user */
@@ -165,6 +237,9 @@ class HorseRaceControllerTest extends TestCase
         $response->assertJson(['ok' => false]);
     }
 
+    /**
+     * 方法功能：验证同一用户同一场只能下注一次。
+     */
     public function test_cannot_bet_twice_in_same_race()
     {
         /** @var \App\Models\User $user */
@@ -200,6 +275,9 @@ class HorseRaceControllerTest extends TestCase
         $response->assertJson(['ok' => false]);
     }
 
+    /**
+     * 方法功能：验证可读取最近的赛马历史记录。
+     */
     public function test_can_get_history()
     {
         /** @var \App\Models\User $user */
@@ -226,6 +304,9 @@ class HorseRaceControllerTest extends TestCase
         $this->assertCount(1, $response->json('history'));
     }
 
+    /**
+     * 方法功能：验证单个赢家至少拿回本金，并可获得种子池补贴。
+     */
     public function test_single_winner_receives_seed_pool_and_does_not_lose_principal(): void
     {
         Event::fake();
@@ -287,4 +368,49 @@ class HorseRaceControllerTest extends TestCase
         $this->assertSame(105, $bet->payout);
         $this->assertSame(505, $user->fresh()->jjb);
     }
+
+    /**
+     * 方法功能：验证结算广播会携带前端展示奖金所需的奖池参数。
+     */
+    public function test_settled_broadcast_contains_pool_data_for_payout_display(): void
+    {
+        $race = HorseRace::create([
+            'status' => 'settled',
+            'bet_opens_at' => now()->subMinutes(2),
+            'bet_closes_at' => now()->subMinute(),
+            'race_starts_at' => now()->subSeconds(30),
+            'race_ends_at' => now()->subSecond(),
+            'settled_at' => now(),
+            'winner_horse_id' => 1,
+            'horses' => [
+                ['id' => 1, 'name' => 'Horse A', 'emoji' => '🐎'],
+                ['id' => 2, 'name' => 'Horse B', 'emoji' => '🏇'],
+            ],
+            'total_pool' => 10000,
+        ]);
+
+        HorseBet::create([
+            'race_id' => $race->id,
+            'user_id' => User::factory()->create()->id,
+            'horse_id' => 1,
+            'amount' => 5000,
+            'status' => 'won',
+            'payout' => 9500,
+        ]);
+
+        HorseBet::create([
+            'race_id' => $race->id,
+            'user_id' => User::factory()->create()->id,
+            'horse_id' => 2,
+            'amount' => 5000,
+            'status' => 'lost',
+            'payout' => 0,
+        ]);
+
+        $payload = (new HorseRaceSettled($race))->broadcastWith();
+
+        $this->assertSame(10000, $payload['total_pool']);
+        $this->assertSame(5000, $payload['winner_pool']);
+        $this->assertSame(9500, $payload['distributable_pool']);
+    }
 }