fix(core): harden settlement and wallet integration

tests/Feature/GameSettlementReversalTest.php

@@ -1,10 +1,13 @@
 <?php
 
+use App\Models\Draw;
 use App\Models\Player;
 use App\Models\TicketItem;
-use App\Services\AgentSettlement\GameSettlementReversalService;
-use Illuminate\Foundation\Testing\RefreshDatabase;
+use App\Lottery\DrawStatus;
 use Illuminate\Support\Facades\DB;
+use App\Services\Player\PlayerCreditService;
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use App\Services\AgentSettlement\GameSettlementReversalService;
 
 uses(RefreshDatabase::class);
 
@@ -31,11 +34,11 @@ test('reversal zeroes share ledger net and marks rebates reversed', function ():
         'status' => 0,
     ]);
 
-    $drawId = (int) \App\Models\Draw::query()->create([
+    $drawId = (int) Draw::query()->create([
         'draw_no' => 'REV-DRAW-1',
         'business_date' => now()->toDateString(),
         'sequence_no' => 1,
-        'status' => \App\Lottery\DrawStatus::Open->value,
+        'status' => DrawStatus::Open->value,
         'current_result_version' => 0,
         'settle_version' => 0,
         'is_reopened' => false,
@@ -148,11 +151,11 @@ test('reversal restores credit used for settled win on credit player', function
         'updated_at' => now(),
     ]);
 
-    $drawId = (int) \App\Models\Draw::query()->create([
+    $drawId = (int) Draw::query()->create([
         'draw_no' => 'REV-CREDIT-DRAW',
         'business_date' => now()->toDateString(),
         'sequence_no' => 1,
-        'status' => \App\Lottery\DrawStatus::Open->value,
+        'status' => DrawStatus::Open->value,
         'current_result_version' => 0,
         'settle_version' => 0,
         'is_reopened' => false,
@@ -219,12 +222,52 @@ test('reversal restores credit used for settled win on credit player', function
         'updated_at' => now(),
     ]);
 
-  // Simulate post-win used_credit (win decreased used by 10 major for 1000 minor).
+    // 模拟结算前已有 11 主单位占额：释放本注 1，再以中奖额释放 10，结算后为 0。
     DB::table('player_credit_accounts')->where('player_id', $player->id)->update(['used_credit' => 0]);
 
     $item = TicketItem::query()->findOrFail($itemId);
     app(GameSettlementReversalService::class)->reverseTicketItem($item);
 
-    expect((int) DB::table('player_credit_accounts')->where('player_id', $player->id)->value('used_credit'))->toBe(10);
+    expect((int) DB::table('player_credit_accounts')->where('player_id', $player->id)->value('used_credit'))->toBe(11);
     expect(DB::table('credit_ledger')->where('reason', 'game_settlement_reversal')->where('owner_id', $player->id)->exists())->toBeTrue();
 });
+
+test('reversal restores only the credit actually released by an oversized win', function (): void {
+    $site = DB::table('admin_sites')->where('is_default', true)->first();
+    $player = Player::query()->create([
+        'site_code' => (string) $site->code,
+        'agent_node_id' => (int) DB::table('agent_nodes')->where('depth', 0)->value('id'),
+        'site_player_id' => 'rev-credit-clipped',
+        'auth_source' => 'lottery_native',
+        'funding_mode' => 'credit',
+        'username' => 'revcreditclipped',
+        'nickname' => null,
+        'default_currency' => 'NPR',
+        'status' => 0,
+    ]);
+
+    DB::table('player_credit_accounts')->insert([
+        'player_id' => $player->id,
+        'credit_limit' => 10000,
+        'used_credit' => 1,
+        'frozen_credit' => 0,
+        'created_at' => now(),
+        'updated_at' => now(),
+    ]);
+
+    $credit = app(PlayerCreditService::class);
+    $credit->releaseBetHold($player, 100, 99881, 1);
+    $credit->applySettledWin($player, 1000, 99881, 1);
+
+    expect((int) DB::table('player_credit_accounts')->where('player_id', $player->id)->value('used_credit'))->toBe(0)
+        ->and((int) DB::table('credit_ledger')
+            ->where('ref_id', 99881)
+            ->where('reason', 'game_settlement_win')
+            ->where('settlement_version', 1)
+            ->value('amount'))->toBe(0);
+
+    $credit->reverseGameSettlement($player, -1000, 99881, 1);
+    $credit->restoreBetHoldAfterSettlementReversal($player, 100, 99881, 1);
+
+    expect((int) DB::table('player_credit_accounts')->where('player_id', $player->id)->value('used_credit'))->toBe(1);
+});