feat: add idempotency support for settlement adjustments and payments, fix rebate handling

- Added idempotency_key parameter to settlement bill adjustment and payment endpoints to prevent duplicate operations
- Fixed player rebate profile updates to preserve existing values when only one field is modified
- Moved wallet player validation earlier in AdminPlayerStoreController to prevent unnecessary processing
- Enhanced extra rebate calculation to include 'in_bill' and 'settled' statuses in AgentP

tests/Feature/AdminPlayerManageApiTest.php

@@ -374,3 +374,89 @@ test('native player create rejects chinese username', function (): void {
         ->assertStatus(422)
         ->assertJsonPath('code', \App\Lottery\ErrorCode::ValidationFailed->value);
 });
+
+test('partial rebate update preserves the other rebate field', function (): void {
+    $siteCode = DB::table('admin_sites')->where('is_default', true)->value('code');
+    $siteCode = is_string($siteCode) && $siteCode !== '' ? $siteCode : 'default_site';
+    $rootId = (int) DB::table('agent_nodes')->where('depth', 0)->value('id');
+
+    AgentProfile::query()->updateOrCreate(
+        ['agent_node_id' => $rootId],
+        [
+            'total_share_rate' => 100,
+            'credit_limit' => 50_000,
+            'allocated_credit' => 0,
+            'used_credit' => 0,
+            'rebate_limit' => 0.02,
+            'default_player_rebate' => 0.005,
+            'can_grant_extra_rebate' => true,
+        ],
+    );
+
+    $player = Player::query()->create([
+        'site_code' => $siteCode,
+        'agent_node_id' => $rootId,
+        'site_player_id' => 'partial-rebate-1',
+        'auth_source' => PlayerAuthSource::LOTTERY_NATIVE,
+        'funding_mode' => PlayerFundingMode::CREDIT,
+        'username' => 'partial_rebate_user',
+        'default_currency' => 'NPR',
+        'status' => 0,
+    ]);
+
+    DB::table('player_credit_accounts')->insert([
+        'player_id' => $player->id,
+        'credit_limit' => 0,
+        'used_credit' => 0,
+        'frozen_credit' => 0,
+        'created_at' => now(),
+        'updated_at' => now(),
+    ]);
+
+    DB::table('player_rebate_profiles')->insert([
+        'player_id' => $player->id,
+        'game_type' => '*',
+        'inherit_from_agent' => false,
+        'rebate_rate' => 0.005,
+        'extra_rebate_rate' => 0.002,
+        'created_at' => now(),
+        'updated_at' => now(),
+    ]);
+
+    $token = playerManageAdminToken();
+
+    $this->withHeader('Authorization', 'Bearer '.$token)
+        ->putJson('/api/v1/admin/players/'.$player->id, [
+            'extra_rebate_rate' => 0.1,
+        ])
+        ->assertOk();
+
+    $this->assertDatabaseHas('player_rebate_profiles', [
+        'player_id' => $player->id,
+        'game_type' => '*',
+        'rebate_rate' => 0.005,
+        'extra_rebate_rate' => 0.001,
+    ]);
+
+    DB::table('player_rebate_profiles')
+        ->where('player_id', $player->id)
+        ->where('game_type', '*')
+        ->update([
+            'rebate_rate' => 0.008,
+            'extra_rebate_rate' => 0.001,
+            'updated_at' => now(),
+        ]);
+
+    $this->withHeader('Authorization', 'Bearer '.$token)
+        ->putJson('/api/v1/admin/players/'.$player->id, [
+            'rebate_rate' => 0.3,
+        ])
+        ->assertOk();
+
+    $this->assertDatabaseHas('player_rebate_profiles', [
+        'player_id' => $player->id,
+        'game_type' => '*',
+        'rebate_rate' => 0.003,
+        'extra_rebate_rate' => 0.001,
+    ]);
+});