feat: 增强代理和玩家管理功能

- 在多个控制器中更新权限检查逻辑，确保管理员能够更灵活地管理代理和玩家。
- 在 AdminPlayerStoreController 中引入对玩家创建能力的验证，确保只有具备相应权限的管理员能够创建玩家。
- 更新请求验证逻辑，新增 credit_limit、rebate_rate 和 extra_rebate_rate 字段，以支持更细粒度的玩家管理。
- 在 AgentNodeProfileController 中添加对父代理能力授予的验证，确保子代理的权限在父代理范围内。
- 引入 AgentProfileFieldRules 以简化代理资料更新请求的规则定义，提升代码复用性。

tests/Feature/AgentSettlementPeriodSummaryTest.php

@@ -0,0 +1,76 @@
+<?php
+
+use App\Models\AdminUser;
+use App\Services\AgentSettlement\AgentSettlementPeriodSummaryService;
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Hash;
+
+uses(RefreshDatabase::class);
+
+test('settlement periods index includes bill summary per period', function (): void {
+    $siteId = (int) DB::table('admin_sites')->where('is_default', true)->value('id');
+    $periodId = (int) DB::table('settlement_periods')->insertGetId([
+        'admin_site_id' => $siteId,
+        'period_start' => now()->subWeek(),
+        'period_end' => now(),
+        'status' => 'closed',
+        'created_at' => now(),
+        'updated_at' => now(),
+    ]);
+
+    DB::table('settlement_bills')->insert([
+        [
+            'settlement_period_id' => $periodId,
+            'bill_type' => 'player',
+            'owner_type' => 'player',
+            'owner_id' => 1,
+            'counterparty_type' => 'agent',
+            'counterparty_id' => 1,
+            'net_amount' => 1000,
+            'unpaid_amount' => 1000,
+            'paid_amount' => 0,
+            'status' => 'pending_confirm',
+            'created_at' => now(),
+            'updated_at' => now(),
+        ],
+        [
+            'settlement_period_id' => $periodId,
+            'bill_type' => 'agent',
+            'owner_type' => 'agent',
+            'owner_id' => 1,
+            'counterparty_type' => 'platform',
+            'counterparty_id' => 0,
+            'net_amount' => 5000,
+            'unpaid_amount' => 5000,
+            'paid_amount' => 0,
+            'status' => 'confirmed',
+            'created_at' => now(),
+            'updated_at' => now(),
+        ],
+    ]);
+
+    $admin = AdminUser::query()->create([
+        'username' => 'period_summary_admin',
+        'name' => 'Summary',
+        '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/settlement-periods?admin_site_id='.$siteId)
+        ->assertOk()
+        ->assertJsonPath('data.items.0.summary.player_bills', 1)
+        ->assertJsonPath('data.items.0.summary.agent_bills', 1)
+        ->assertJsonPath('data.items.0.summary.pending_confirm', 1)
+        ->assertJsonPath('data.items.0.summary.awaiting_payment', 1)
+        ->assertJsonPath('data.items.0.summary.total_unpaid', 6000);
+
+    $service = app(AgentSettlementPeriodSummaryService::class);
+    $summaries = $service->summariesForPeriodIds([$periodId]);
+    expect($summaries[$periodId]['player_bills'])->toBe(1);
+    expect($summaries[$periodId]['agent_bills'])->toBe(1);
+});