feat(wallet): 增强资金流水和信用账本的公共类型过滤，支持游戏结算和账单结算

tests/Feature/AdminCreditLedgerFilterTest.php

@@ -94,6 +94,64 @@ test('credit ledger biz_type payment_record excludes credit rows', function ():
         ->assertJsonPath('data.items.0.entry_kind', 'credit');
 });
 
+test('credit ledger accepts public game settlement filter', function (): void {
+    $site = DB::table('admin_sites')->where('is_default', true)->first();
+    $siteId = (int) $site->id;
+    $siteCode = (string) $site->code;
+
+    $player = Player::query()->create([
+        'site_code' => $siteCode,
+        'site_player_id' => 'native:game-settlement-filter',
+        'funding_mode' => PlayerFundingMode::CREDIT,
+        'username' => 'game_settlement_filter_user',
+        'default_currency' => 'NPR',
+        'status' => 0,
+    ]);
+
+    DB::table('credit_ledger')->insert([
+        [
+            'owner_type' => 'player',
+            'owner_id' => $player->id,
+            'amount' => -100,
+            'reason' => 'bet_hold',
+            'created_at' => now()->subMinute(),
+            'updated_at' => now()->subMinute(),
+        ],
+        [
+            'owner_type' => 'player',
+            'owner_id' => $player->id,
+            'amount' => 100,
+            'reason' => 'bet_hold_release',
+            'created_at' => now(),
+            'updated_at' => now(),
+        ],
+        [
+            'owner_type' => 'player',
+            'owner_id' => $player->id,
+            'amount' => 200,
+            'reason' => 'game_settlement_win',
+            'created_at' => now(),
+            'updated_at' => now(),
+        ],
+    ]);
+
+    $admin = AdminUser::query()->create([
+        'username' => 'ledger_game_settlement_super',
+        'name' => 'Game Settlement Ledger',
+        'email' => null,
+        'password' => Hash::make('secret-strong'),
+        'status' => 0,
+    ]);
+    grantSuperAdminRole($admin);
+    $token = $admin->createToken('test', ['*'], now()->addDay())->plainTextToken;
+
+    $this->withHeader('Authorization', 'Bearer '.$token)
+        ->getJson('/api/v1/admin/credit-ledger?admin_site_id='.$siteId.'&reason=game_settlement')
+        ->assertOk()
+        ->assertJsonPath('data.total', 2)
+        ->assertJsonPath('data.items.0.entry_kind', 'credit');
+});
+
 test('credit ledger index includes payment on agent bill', function (): void {
     $site = DB::table('admin_sites')->where('is_default', true)->first();
     $siteId = (int) $site->id;

tests/Feature/AdminWalletApiTest.php

@@ -352,6 +352,66 @@ test('admin lists wallet transactions and filters abnormal', function (): void {
         ->assertJsonPath('data.items.0.status', 'pending_reconcile');
 });
 
+test('admin wallet transactions accepts public flow type filters', function (): void {
+    $token = makeAdminToken();
+
+    $player = Player::query()->create([
+        'site_code' => 'main',
+        'site_player_id' => 'public-flow-filter',
+        'username' => null,
+        'nickname' => null,
+        'default_currency' => 'NPR',
+        'status' => 0,
+    ]);
+
+    $wallet = PlayerWallet::query()->create([
+        'player_id' => $player->id,
+        'wallet_type' => 'lottery',
+        'currency_code' => 'NPR',
+        'balance' => 5000,
+        'frozen_balance' => 0,
+        'status' => 0,
+        'version' => 1,
+    ]);
+
+    foreach ([
+        ['WX_admin_bet', 'bet_deduct', 2],
+        ['WX_admin_prize', 'settle_payout', 1],
+        ['WX_admin_reversal', 'bet_reverse', 1],
+    ] as [$txnNo, $bizType, $direction]) {
+        WalletTxn::query()->create([
+            'txn_no' => $txnNo,
+            'player_id' => $player->id,
+            'wallet_id' => $wallet->id,
+            'biz_type' => $bizType,
+            'biz_no' => $txnNo,
+            'direction' => $direction,
+            'amount' => 100,
+            'balance_before' => 1000,
+            'balance_after' => 1000,
+            'status' => 'posted',
+        ]);
+    }
+
+    $this->withHeader('Authorization', 'Bearer '.$token)
+        ->getJson('/api/v1/admin/wallet/transactions?biz_type=bet')
+        ->assertOk()
+        ->assertJsonPath('data.total', 1)
+        ->assertJsonPath('data.items.0.biz_type', 'bet_deduct');
+
+    $this->withHeader('Authorization', 'Bearer '.$token)
+        ->getJson('/api/v1/admin/wallet/transactions?biz_type=prize')
+        ->assertOk()
+        ->assertJsonPath('data.total', 1)
+        ->assertJsonPath('data.items.0.biz_type', 'settle_payout');
+
+    $this->withHeader('Authorization', 'Bearer '.$token)
+        ->getJson('/api/v1/admin/wallet/transactions?biz_type=reversal')
+        ->assertOk()
+        ->assertJsonPath('data.total', 1)
+        ->assertJsonPath('data.items.0.biz_type', 'bet_reverse');
+});
+
 test('admin transfer reverse is idempotent under concurrent reconcile', function (): void {
     $player = Player::query()->create([
         'site_code' => 'main',

tests/Feature/CreditWalletLogsTest.php

@@ -106,7 +106,7 @@ test('credit player wallet logs distinguish win credit from bill settlement', fu
 
     $response->assertOk()
         ->assertJsonPath('data.total', 2)
-        ->assertJsonPath('data.items.0.type', 'win_credit')
+        ->assertJsonPath('data.items.0.type', 'game_settlement')
         ->assertJsonPath('data.items.0.biz_type', 'game_settlement_win')
         ->assertJsonPath('data.items.0.affects_available_credit', true)
         ->assertJsonPath('data.items.1.type', 'bill_settlement')
@@ -126,13 +126,105 @@ test('credit player wallet logs distinguish win credit from bill settlement', fu
         ->getJson('/api/v1/wallet/logs?type=win_credit')
         ->assertOk()
         ->assertJsonPath('data.total', 1)
-        ->assertJsonPath('data.items.0.type', 'win_credit');
+        ->assertJsonPath('data.items.0.type', 'game_settlement');
 
     $this->withHeader('Authorization', 'Bearer dev:'.$player->id)
         ->getJson('/api/v1/wallet/logs?type=credit_release')
         ->assertOk()
         ->assertJsonPath('data.total', 1)
-        ->assertJsonPath('data.items.0.type', 'win_credit');
+        ->assertJsonPath('data.items.0.type', 'game_settlement');
+
+    $this->withHeader('Authorization', 'Bearer dev:'.$player->id)
+        ->getJson('/api/v1/wallet/logs?type=game_settlement')
+        ->assertOk()
+        ->assertJsonPath('data.total', 1)
+        ->assertJsonPath('data.items.0.type', 'game_settlement');
+});
+
+test('credit player wallet logs include period rebate records without affecting available credit', function (): void {
+    $player = Player::query()->create([
+        'site_code' => 'default_site',
+        'site_player_id' => 'native:logs-rebate',
+        'auth_source' => PlayerAuthSource::LOTTERY_NATIVE,
+        'funding_mode' => PlayerFundingMode::CREDIT,
+        'username' => 'credit_logs_rebate',
+        'default_currency' => 'NPR',
+        'status' => 0,
+    ]);
+
+    DB::table('player_credit_accounts')->insert([
+        'player_id' => $player->id,
+        'credit_limit' => 500,
+        'used_credit' => 0,
+        'frozen_credit' => 0,
+        'created_at' => now(),
+        'updated_at' => now(),
+    ]);
+
+    $drawId = (int) DB::table('draws')->insertGetId([
+        'draw_no' => 'RB-LOG-001',
+        'business_date' => now()->toDateString(),
+        'sequence_no' => 1,
+        'status' => 'settled',
+        'created_at' => now(),
+        'updated_at' => now(),
+    ]);
+    $orderId = (int) DB::table('ticket_orders')->insertGetId([
+        'order_no' => 'RB-LOG-ORDER-001',
+        'player_id' => $player->id,
+        'draw_id' => $drawId,
+        'currency_code' => 'NPR',
+        'status' => 'settled',
+        'created_at' => now(),
+        'updated_at' => now(),
+    ]);
+    $ticketItemId = (int) DB::table('ticket_items')->insertGetId([
+        'ticket_no' => 'RB-LOG-TICKET-001',
+        'order_id' => $orderId,
+        'player_id' => $player->id,
+        'draw_id' => $drawId,
+        'normalized_number' => '1234',
+        'play_code' => '4d',
+        'total_bet_amount' => 10000,
+        'status' => 'settled',
+        'created_at' => now(),
+        'updated_at' => now(),
+    ]);
+
+    DB::table('rebate_records')->insert([
+        'player_id' => $player->id,
+        'ticket_item_id' => $ticketItemId,
+        'game_type' => '*',
+        'valid_bet_amount' => 10000,
+        'rebate_rate' => 0.01,
+        'rebate_amount' => 100,
+        'rebate_type' => 'basic',
+        'owner_agent_id' => null,
+        'status' => 'accrued',
+        'created_at' => now(),
+        'updated_at' => now(),
+    ]);
+
+    $this->withHeader('Authorization', 'Bearer dev:'.$player->id)
+        ->getJson('/api/v1/wallet/logs?page=1&size=10')
+        ->assertOk()
+        ->assertJsonPath('data.total', 1)
+        ->assertJsonPath('data.items.0.type', 'rebate')
+        ->assertJsonPath('data.items.0.biz_type', 'rebate_accrued')
+        ->assertJsonPath('data.items.0.ledger_source', 'rebate_record')
+        ->assertJsonPath('data.items.0.affects_available_credit', false)
+        ->assertJsonPath('data.items.0.balance_after', null);
+
+    $this->withHeader('Authorization', 'Bearer dev:'.$player->id)
+        ->getJson('/api/v1/wallet/logs?type=rebate')
+        ->assertOk()
+        ->assertJsonPath('data.total', 1)
+        ->assertJsonPath('data.items.0.type', 'rebate');
+
+    $this->withHeader('Authorization', 'Bearer dev:'.$player->id)
+        ->getJson('/api/v1/wallet/logs?type=bet')
+        ->assertOk()
+        ->assertJsonPath('data.total', 0);
 });
 
 test('credit wallet logs page 2 balance_after continues from page 1 baseline', function (): void {