feat: 添加结算功能，更新 TicketItem 模型以支持最新结算详情，增强 DrawTickService 以自动处理结算，更新 TicketWalletService 以支持派彩入账，扩展 API 路由以管理结算批次和奖池

2026-05-11 15:34:34 +08:00
parent 6a55fa9592
commit 19003f5041
50 changed files with 3604 additions and 3 deletions
--- a/tests/Feature/JackpotPlacementSettlementTest.php
+++ b/tests/Feature/JackpotPlacementSettlementTest.php
@@ -0,0 +1,141 @@
+<?php
+
+use App\Lottery\DrawResultBatchStatus;
+use App\Lottery\DrawStatus;
+use App\Models\Draw;
+use App\Models\DrawResultBatch;
+use App\Models\DrawResultItem;
+use App\Models\JackpotContribution;
+use App\Models\JackpotPayoutLog;
+use App\Models\JackpotPool;
+use App\Models\Player;
+use App\Models\PlayerWallet;
+use App\Models\TicketItem;
+use App\Models\TicketOrder;
+use App\Services\Draw\DrawPrizeLayout;
+use App\Services\Settlement\SettlementOrchestrator;
+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);
+});
+
+test('jackpot contributes on place and bursts on settle for first-prize straight', function (): void {
+    JackpotPool::query()->create([
+        'currency_code' => 'NPR',
+        'current_amount' => 0,
+        'contribution_rate' => '0.1000',
+        'trigger_threshold' => 1,
+        'payout_rate' => '1.0000',
+        'force_trigger_draw_gap' => 0,
+        'min_bet_amount' => 0,
+        'status' => 1,
+        'last_trigger_draw_id' => null,
+    ]);
+
+    $uniq = bin2hex(random_bytes(4));
+    $player = Player::query()->create([
+        'site_code' => 'test',
+        'site_player_id' => 'jp-p-'.$uniq,
+        'username' => 'jp_'.$uniq,
+        'nickname' => null,
+        'default_currency' => 'NPR',
+        'status' => 0,
+    ]);
+    PlayerWallet::query()->create([
+        'player_id' => $player->id,
+        'wallet_type' => 'lottery',
+        'currency_code' => 'NPR',
+        'balance' => 5_000_000,
+        'frozen_balance' => 0,
+        'status' => 0,
+        'version' => 0,
+    ]);
+
+    $draw = Draw::query()->create([
+        'draw_no' => '20260511-901',
+        'business_date' => '2026-05-11',
+        'sequence_no' => 901,
+        '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,
+    ]);
+
+    $this->withHeader('Authorization', 'Bearer dev:'.$player->id)
+        ->postJson('/api/v1/ticket/place', [
+            'draw_id' => '20260511-901',
+            'currency_code' => 'NPR',
+            'client_trace_id' => 'jp-trace-1',
+            'lines' => [
+                ['number' => '1234', 'play_code' => 'straight', 'amount' => 10_000],
+            ],
+        ])
+        ->assertOk();
+
+    expect(JackpotContribution::query()->count())->toBe(1);
+    $poolAfterBet = JackpotPool::query()->where('currency_code', 'NPR')->firstOrFail();
+    expect((int) $poolAfterBet->current_amount)->toBe(1_000);
+
+    $batch = DrawResultBatch::query()->create([
+        'draw_id' => $draw->id,
+        'result_version' => 1,
+        'source_type' => 'rng',
+        'rng_seed_hash' => 'test',
+        'raw_seed_encrypted' => null,
+        'status' => DrawResultBatchStatus::Published->value,
+        'created_by' => null,
+        'confirmed_by' => null,
+        'confirmed_at' => now(),
+    ]);
+
+    foreach (DrawPrizeLayout::slots() as $slot) {
+        $num = $slot['prize_type'] === 'first' ? '1234' : '5678';
+        $suffix3 = substr($num, -3);
+        $suffix2 = substr($num, -2);
+        DrawResultItem::query()->create([
+            'draw_id' => $draw->id,
+            'result_batch_id' => $batch->id,
+            'prize_type' => $slot['prize_type'],
+            'prize_index' => $slot['prize_index'],
+            'number_4d' => $num,
+            'suffix_3d' => $suffix3,
+            'suffix_2d' => $suffix2,
+            'head_digit' => (int) substr($num, 0, 1),
+            'tail_digit' => (int) substr($num, 3, 1),
+        ]);
+    }
+
+    $draw->forceFill([
+        'status' => DrawStatus::Settling->value,
+        'current_result_version' => 1,
+    ])->save();
+
+    $ran = app(SettlementOrchestrator::class)->trySettleDraw($draw->fresh());
+    expect($ran)->toBeTrue();
+
+    $item = TicketItem::query()->where('draw_id', $draw->id)->firstOrFail();
+    expect((int) $item->win_amount)->toBe(250_000);
+    expect((int) $item->jackpot_win_amount)->toBe(1_000);
+
+    $poolAfterSettle = JackpotPool::query()->where('currency_code', 'NPR')->firstOrFail();
+    expect((int) $poolAfterSettle->current_amount)->toBe(0);
+    expect(JackpotPayoutLog::query()->count())->toBe(1);
+
+    $order = TicketOrder::query()->whereKey($item->order_id)->firstOrFail();
+    expect($order->status)->toBe('settled');
+});