feat: 添加新的错误码以支持投注功能，更新数据库填充器以增强玩法和赔率配置，扩展 API 路由以支持风险池管理

2026-05-11 11:52:23 +08:00
parent 067c2b39f5
commit 058f596f34
29 changed files with 2300 additions and 122 deletions
--- a/tests/Feature/AdminRiskPoolApiTest.php
+++ b/tests/Feature/AdminRiskPoolApiTest.php
@@ -0,0 +1,133 @@
+<?php
+
+use App\Models\AdminUser;
+use App\Models\Draw;
+use App\Models\RiskPool;
+use App\Models\RiskPoolLockLog;
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Illuminate\Support\Facades\Hash;
+
+uses(RefreshDatabase::class);
+
+function mintRiskAdminToken(): string
+{
+    $admin = AdminUser::query()->create([
+        'username' => 'risk_pool_admin',
+        'name' => 'Risk QA',
+        'email' => null,
+        'password' => Hash::make('secret-strong'),
+        'status' => 0,
+    ]);
+
+    return $admin->createToken('test', ['*'], now()->addDay())->plainTextToken;
+}
+
+test('admin risk pools index returns rows for draw', function (): void {
+    $draw = Draw::query()->create([
+        'draw_no' => '20260512-001',
+        'business_date' => '2026-05-12',
+        'sequence_no' => 1,
+        'status' => 'open',
+        'start_time' => now()->subHour(),
+        'close_time' => now()->addHour(),
+        'draw_time' => now()->addHours(2),
+        'cooling_end_time' => null,
+        'result_source' => null,
+        'current_result_version' => 0,
+        'settle_version' => 0,
+        'is_reopened' => false,
+    ]);
+
+    RiskPool::query()->create([
+        'draw_id' => $draw->id,
+        'normalized_number' => '1234',
+        'total_cap_amount' => 1_000_000,
+        'locked_amount' => 200_000,
+        'remaining_amount' => 800_000,
+        'sold_out_status' => 0,
+        'version' => 1,
+    ]);
+
+    RiskPool::query()->create([
+        'draw_id' => $draw->id,
+        'normalized_number' => '9999',
+        'total_cap_amount' => 100,
+        'locked_amount' => 100,
+        'remaining_amount' => 0,
+        'sold_out_status' => 1,
+        'version' => 2,
+    ]);
+
+    $token = mintRiskAdminToken();
+
+    $this->withHeader('Authorization', 'Bearer '.$token)
+        ->getJson('/api/v1/admin/draws/'.$draw->id.'/risk-pools?per_page=10')
+        ->assertOk()
+        ->assertJsonPath('data.draw_no', '20260512-001')
+        ->assertJsonPath('data.meta.total', 2);
+
+    $this->withHeader('Authorization', 'Bearer '.$token)
+        ->getJson('/api/v1/admin/draws/'.$draw->id.'/risk-pools?sold_out_only=1')
+        ->assertOk()
+        ->assertJsonPath('data.meta.total', 1)
+        ->assertJsonPath('data.items.0.normalized_number', '9999')
+        ->assertJsonPath('data.items.0.is_sold_out', true);
+});
+
+test('admin risk pool lock logs include ticket_no when linked', function (): void {
+    $draw = Draw::query()->create([
+        'draw_no' => '20260512-002',
+        'business_date' => '2026-05-12',
+        'sequence_no' => 2,
+        'status' => 'open',
+        'start_time' => now()->subHour(),
+        'close_time' => now()->addHour(),
+        'draw_time' => now()->addHours(2),
+        'cooling_end_time' => null,
+        'result_source' => null,
+        'current_result_version' => 0,
+        'settle_version' => 0,
+        'is_reopened' => false,
+    ]);
+
+    RiskPoolLockLog::query()->create([
+        'draw_id' => $draw->id,
+        'normalized_number' => '5678',
+        'ticket_item_id' => null,
+        'action_type' => 'lock',
+        'amount' => 50,
+        'source_reason' => 'ticket_place',
+        'created_at' => now(),
+    ]);
+
+    $token = mintRiskAdminToken();
+
+    $this->withHeader('Authorization', 'Bearer '.$token)
+        ->getJson('/api/v1/admin/draws/'.$draw->id.'/risk-pool-lock-logs')
+        ->assertOk()
+        ->assertJsonPath('data.meta.total', 1)
+        ->assertJsonPath('data.items.0.amount', 50);
+});
+
+test('admin risk pool show 404 when pool missing', function (): void {
+    $draw = Draw::query()->create([
+        'draw_no' => '20260512-003',
+        'business_date' => '2026-05-12',
+        'sequence_no' => 3,
+        'status' => 'open',
+        'start_time' => now()->subHour(),
+        'close_time' => now()->addHour(),
+        'draw_time' => now()->addHours(2),
+        'cooling_end_time' => null,
+        'result_source' => null,
+        'current_result_version' => 0,
+        'settle_version' => 0,
+        'is_reopened' => false,
+    ]);
+
+    $token = mintRiskAdminToken();
+
+    $this->withHeader('Authorization', 'Bearer '.$token)
+        ->getJson('/api/v1/admin/draws/'.$draw->id.'/risk-pools/0000')
+        ->assertStatus(404);
+});
--- a/tests/Feature/TicketBettingApiTest.php
+++ b/tests/Feature/TicketBettingApiTest.php
@@ -0,0 +1,227 @@
+<?php
+
+use App\Lottery\ConfigVersionStatus;
+use App\Lottery\DrawStatus;
+use App\Lottery\ErrorCode;
+use App\Models\Draw;
+use App\Models\OddsVersion;
+use App\Models\Player;
+use App\Models\PlayerWallet;
+use App\Models\RiskPool;
+use App\Models\TicketItem;
+use App\Models\TicketOrder;
+use App\Models\WalletTxn;
+use Database\Seeders\CurrencySeeder;
+use Database\Seeders\LotterySettingsSeeder;
+use Database\Seeders\OperationalConfigV1Seeder;
+use Database\Seeders\PlayTypeSeeder;
+use Illuminate\Foundation\Testing\RefreshDatabase;
+
+uses(RefreshDatabase::class);
+
+beforeEach(function (): void {
+    $this->seed(CurrencySeeder::class);
+    $this->seed(PlayTypeSeeder::class);
+    $this->seed(OperationalConfigV1Seeder::class);
+    $this->seed(LotterySettingsSeeder::class);
+});
+
+function ticketPlayerWithWallet(int $balance = 200_000): Player
+{
+    $player = Player::query()->create([
+        'site_code' => 'test',
+        'site_player_id' => 'ticket-player-1',
+        'username' => 'tp1',
+        'nickname' => null,
+        'default_currency' => 'NPR',
+        'status' => 0,
+    ]);
+
+    PlayerWallet::query()->create([
+        'player_id' => $player->id,
+        'wallet_type' => 'lottery',
+        'currency_code' => 'NPR',
+        'balance' => $balance,
+        'frozen_balance' => 0,
+        'status' => 0,
+        'version' => 0,
+    ]);
+
+    return $player;
+}
+
+function ticketOpenDraw(string $drawNo = '20260511-001'): Draw
+{
+    return Draw::query()->create([
+        'draw_no' => $drawNo,
+        'business_date' => '2026-05-11',
+        'sequence_no' => 1,
+        'status' => DrawStatus::Open->value,
+        'start_time' => now()->subMinutes(2),
+        'close_time' => now()->addMinutes(5),
+        'draw_time' => now()->addMinutes(6),
+        'cooling_end_time' => null,
+        'result_source' => null,
+        'current_result_version' => 0,
+        'settle_version' => 0,
+        'is_reopened' => false,
+    ]);
+}
+
+function ticketPreviewPayload(string $drawNo = '20260511-001'): array
+{
+    return [
+        'draw_id' => $drawNo,
+        'currency_code' => 'NPR',
+        'client_trace_id' => 'trace-001',
+        'lines' => [
+            [
+                'number' => '1234',
+                'play_code' => 'big',
+                'amount' => 10_000,
+            ],
+            [
+                'number' => '1234',
+                'play_code' => 'ibox',
+                'amount' => 100,
+            ],
+        ],
+    ];
+}
+
+test('ticket preview returns computed summary for open draw', function (): void {
+    $player = ticketPlayerWithWallet();
+    ticketOpenDraw();
+
+    $this->withHeader('Authorization', 'Bearer dev:'.$player->id)
+        ->postJson('/api/v1/ticket/preview', ticketPreviewPayload())
+        ->assertOk()
+        ->assertJsonPath('code', ErrorCode::Success->value)
+        ->assertJsonPath('data.draw.draw_id', '20260511-001')
+        ->assertJsonPath('data.summary.total_bet_amount', 12_400)
+        ->assertJsonPath('data.summary.total_actual_deduct', 12_400)
+        ->assertJsonPath('data.config_versions.play_config_version_no', 1)
+        ->assertJsonPath('data.config_versions.odds_version_no', 1)
+        ->assertJsonPath('data.config_versions.risk_cap_version_no', 1)
+        ->assertJsonCount(2, 'data.lines');
+});
+
+test('ticket place deducts wallet and persists order items combinations and logs', function (): void {
+    $player = ticketPlayerWithWallet();
+    ticketOpenDraw();
+
+    $this->withHeader('Authorization', 'Bearer dev:'.$player->id)
+        ->postJson('/api/v1/ticket/place', ticketPreviewPayload())
+        ->assertOk()
+        ->assertJsonPath('code', ErrorCode::Success->value)
+        ->assertJsonPath('data.draw.draw_id', '20260511-001')
+        ->assertJsonPath('data.summary.total_bet_amount', 12_400)
+        ->assertJsonPath('data.summary.total_actual_deduct', 12_400);
+
+    expect(TicketOrder::query()->count())->toBe(1);
+    expect(TicketItem::query()->count())->toBe(2);
+    expect(WalletTxn::query()->where('biz_type', 'bet_deduct')->count())->toBe(1);
+    expect(RiskPool::query()->count())->toBeGreaterThan(0);
+
+    $wallet = PlayerWallet::query()->where('player_id', $player->id)->firstOrFail();
+    expect((int) $wallet->balance)->toBe(200_000 - 12_400);
+});
+
+test('ticket place rejects closed draw', function (): void {
+    $player = ticketPlayerWithWallet();
+    $draw = ticketOpenDraw();
+    $draw->update(['status' => DrawStatus::Closed->value]);
+
+    $this->withHeader('Authorization', 'Bearer dev:'.$player->id)
+        ->postJson('/api/v1/ticket/place', ticketPreviewPayload())
+        ->assertStatus(400)
+        ->assertJsonPath('code', ErrorCode::DrawClosed->value);
+});
+
+test('ticket place rejects insufficient balance', function (): void {
+    $player = ticketPlayerWithWallet(1_000);
+    ticketOpenDraw();
+
+    $this->withHeader('Authorization', 'Bearer dev:'.$player->id)
+        ->postJson('/api/v1/ticket/place', ticketPreviewPayload())
+        ->assertStatus(400)
+        ->assertJsonPath('code', ErrorCode::BetInsufficientBalance->value);
+
+    expect(TicketOrder::query()->count())->toBe(0);
+    expect(WalletTxn::query()->where('biz_type', 'bet_deduct')->count())->toBe(0);
+});
+
+test('ticket place succeeds when expected_config_versions matches preview', function (): void {
+    $player = ticketPlayerWithWallet();
+    ticketOpenDraw();
+
+    $versions = $this->withHeader('Authorization', 'Bearer dev:'.$player->id)
+        ->postJson('/api/v1/ticket/preview', ticketPreviewPayload())
+        ->assertOk()
+        ->json('data.config_versions');
+
+    $payload = array_merge(ticketPreviewPayload(), ['expected_config_versions' => $versions]);
+
+    $this->withHeader('Authorization', 'Bearer dev:'.$player->id)
+        ->postJson('/api/v1/ticket/place', $payload)
+        ->assertOk()
+        ->assertJsonPath('code', ErrorCode::Success->value);
+
+    expect(TicketOrder::query()->count())->toBe(1);
+});
+
+test('ticket place rejects stale expected_config_versions', function (): void {
+    $player = ticketPlayerWithWallet();
+    ticketOpenDraw();
+
+    $preview = $this->withHeader('Authorization', 'Bearer dev:'.$player->id)
+        ->postJson('/api/v1/ticket/preview', ticketPreviewPayload())
+        ->assertOk()
+        ->json('data.config_versions');
+
+    OddsVersion::query()->where('status', ConfigVersionStatus::Active->value)->update(['version_no' => 99]);
+
+    $payload = array_merge(ticketPreviewPayload(), ['expected_config_versions' => $preview]);
+
+    $this->withHeader('Authorization', 'Bearer dev:'.$player->id)
+        ->postJson('/api/v1/ticket/place', $payload)
+        ->assertStatus(400)
+        ->assertJsonPath('code', ErrorCode::BetConfigStale->value);
+
+    expect(TicketOrder::query()->count())->toBe(0);
+});
+
+test('ticket place rejects sold out risk pool', function (): void {
+    $player = ticketPlayerWithWallet();
+    $draw = ticketOpenDraw();
+
+    RiskPool::query()->create([
+        'draw_id' => $draw->id,
+        'normalized_number' => '1234',
+        'total_cap_amount' => 100,
+        'locked_amount' => 100,
+        'remaining_amount' => 0,
+        'sold_out_status' => 1,
+        'version' => 1,
+    ]);
+
+    $this->withHeader('Authorization', 'Bearer dev:'.$player->id)
+        ->postJson('/api/v1/ticket/place', [
+            'draw_id' => '20260511-001',
+            'currency_code' => 'NPR',
+            'client_trace_id' => 'trace-002',
+            'lines' => [
+                [
+                    'number' => '1234',
+                    'play_code' => 'big',
+                    'amount' => 10_000,
+                ],
+            ],
+        ])
+        ->assertStatus(400)
+        ->assertJsonPath('code', ErrorCode::RiskPoolSoldOut->value);
+
+    $wallet = PlayerWallet::query()->where('player_id', $player->id)->firstOrFail();
+    expect((int) $wallet->balance)->toBe(200_000);
+    expect(TicketOrder::query()->count())->toBe(0);
+});