feat: 拆分开奖与结算审核流程，新增手动结果录入、重开和派彩审批接口

tests/Feature/SettlementOrchestratorTest.php

@@ -10,6 +10,8 @@ use App\Models\PlayerWallet;
 use App\Models\DrawResultItem;
 use App\Models\DrawResultBatch;
 use App\Models\SettlementBatch;
+use App\Models\AdminUser;
+use Illuminate\Support\Facades\Hash;
 use Database\Seeders\CurrencySeeder;
 use Database\Seeders\PlayTypeSeeder;
 use App\Lottery\DrawResultBatchStatus;
@@ -18,6 +20,7 @@ use Database\Seeders\LotterySettingsSeeder;
 use Database\Seeders\OperationalConfigV1Seeder;
 use Illuminate\Foundation\Testing\RefreshDatabase;
 use App\Services\Settlement\SettlementOrchestrator;
+use App\Services\Settlement\SettlementBatchWorkflowService;
 
 uses(RefreshDatabase::class);
 
@@ -111,6 +114,18 @@ test('settlement pays big winner and marks ticket settled', function (): void {
     $ran = app(SettlementOrchestrator::class)->trySettleDraw($draw->fresh());
     expect($ran)->toBeTrue();
 
+    $admin = AdminUser::query()->create([
+        'username' => 'settlement_legacy_reviewer',
+        'name' => 'Settlement Legacy Reviewer',
+        'email' => null,
+        'password' => Hash::make('secret-strong'),
+        'status' => 0,
+    ]);
+    grantSuperAdminRole($admin);
+    $settlementBatch = SettlementBatch::query()->where('draw_id', $draw->id)->firstOrFail();
+    app(SettlementBatchWorkflowService::class)->approve($settlementBatch, $admin);
+    app(SettlementBatchWorkflowService::class)->payout($settlementBatch->fresh());
+
     $draw->refresh();
     expect($draw->status)->toBe(DrawStatus::Settled->value);
     expect((int) $draw->settle_version)->toBe(1);
@@ -129,3 +144,123 @@ test('settlement pays big winner and marks ticket settled', function (): void {
 
     expect(WalletTxn::query()->where('biz_type', 'settle_payout')->count())->toBe(1);
 });
+
+test('admin settlement requires review before payout and can export report', function (): void {
+    $uniq = bin2hex(random_bytes(4));
+    $player = Player::query()->create([
+        'site_code' => 'test',
+        'site_player_id' => 'settle-review-p-'.$uniq,
+        'username' => 'srp_'.$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' => 'settle-review-trace-1',
+            'lines' => [
+                ['number' => '1234', 'play_code' => 'big', 'amount' => 10_000],
+            ],
+        ])
+        ->assertOk();
+
+    $batch = DrawResultBatch::query()->create([
+        'draw_id' => $draw->id,
+        'result_version' => 1,
+        'source_type' => 'rng',
+        'rng_seed_hash' => 'review-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';
+        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' => substr($num, -3),
+            'suffix_2d' => substr($num, -2),
+            '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();
+
+    $admin = AdminUser::query()->create([
+        'username' => 'settlement_reviewer',
+        'name' => 'Settlement Reviewer',
+        'email' => null,
+        'password' => Hash::make('secret-strong'),
+        'status' => 0,
+    ]);
+    grantSuperAdminRole($admin);
+    $token = $admin->createToken('test', ['*'], now()->addDay())->plainTextToken;
+
+    $this->withHeader('Authorization', 'Bearer '.$token)
+        ->postJson("/api/v1/admin/draws/{$draw->id}/settlement/run")
+        ->assertOk()
+        ->assertJsonPath('data.status', DrawStatus::Settling->value);
+
+    $settlement = SettlementBatch::query()->where('draw_id', $draw->id)->firstOrFail();
+    expect($settlement->status)->toBe('pending_review');
+
+    $item = TicketItem::query()->where('draw_id', $draw->id)->firstOrFail();
+    expect($item->status)->toBe('pending_payout');
+    expect(WalletTxn::query()->where('biz_type', 'settle_payout')->count())->toBe(0);
+
+    $this->withHeader('Authorization', 'Bearer '.$token)
+        ->postJson("/api/v1/admin/settlement-batches/{$settlement->id}/approve")
+        ->assertOk()
+        ->assertJsonPath('data.review_status', 'approved');
+
+    $this->withHeader('Authorization', 'Bearer '.$token)
+        ->postJson("/api/v1/admin/settlement-batches/{$settlement->id}/payout")
+        ->assertOk()
+        ->assertJsonPath('data.status', 'paid');
+
+    $item->refresh();
+    expect($item->status)->toBe('settled_win');
+    expect(WalletTxn::query()->where('biz_type', 'settle_payout')->count())->toBe(1);
+
+    $this->withHeader('Authorization', 'Bearer '.$token)
+        ->get("/api/v1/admin/settlement-batches/{$settlement->id}/export")
+        ->assertOk()
+        ->assertHeader('content-type', 'text/csv; charset=UTF-8');
+});