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

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

app/Http/Controllers/Api/V1/Admin/AgentSettlement/AgentSettlementReportShowController.php

@@ -0,0 +1,106 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1\Admin\AgentSettlement;
+
+use App\Http\Controllers\Controller;
+use App\Services\AgentSettlement\AgentSettlementReportQueryService;
+use App\Support\ApiResponse;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\DB;
+final class AgentSettlementReportShowController extends Controller
+{
+    private const TYPES = [
+        'summary',
+        'player_win_loss',
+        'agent_share',
+        'rebate',
+        'credit',
+        'unpaid_bills',
+        'overdue',
+        'platform_pnl',
+        'draw_period',
+    ];
+
+    public function __invoke(Request $request, AgentSettlementReportQueryService $reports): JsonResponse
+    {
+        $admin = $request->lotteryAdmin();
+        abort_if($admin === null, 401);
+
+        $type = (string) $request->query('type', 'summary');
+        abort_unless(in_array($type, self::TYPES, true), 404);
+
+        $periodId = (int) $request->query('settlement_period_id', 0);
+        $period = $this->resolvePeriod($periodId, $request);
+
+        $data = match ($type) {
+            'summary' => $reports->summary($admin, $periodId),
+            'player_win_loss' => [
+                'items' => $reports->playerWinLoss($admin, $periodId, $period['start'], $period['end']),
+            ],
+            'agent_share' => [
+                'items' => $reports->agentShare($admin, $period['start'], $period['end']),
+            ],
+            'rebate' => $reports->rebate($admin, $periodId, $period['start'], $period['end']),
+            'credit' => $reports->credit($admin),
+            'unpaid_bills' => [
+                'items' => $reports->unpaidBills($admin, $periodId),
+            ],
+            'overdue' => [
+                'items' => $reports->overdue($admin),
+            ],
+            'platform_pnl' => $periodId > 0
+                ? $reports->platformPnl($admin, $periodId)
+                : ['error' => 'settlement_period_id_required'],
+            'draw_period' => [
+                'items' => $reports->drawPeriod($admin, $period['start'], $period['end']),
+            ],
+            default => [],
+        };
+
+        return ApiResponse::success([
+            'type' => $type,
+            'settlement_period_id' => $periodId > 0 ? $periodId : null,
+            'period_start' => $period['start'],
+            'period_end' => $period['end'],
+            'data' => $data,
+            'footnote' => $type === 'summary'
+                ? null
+                : 'agent_credit_line_settlement',
+        ]);
+    }
+
+    /**
+     * @return array{start: string, end: string}
+     */
+    private function resolvePeriod(int $periodId, Request $request): array
+    {
+        if ($periodId > 0) {
+            $row = DB::table('settlement_periods')->where('id', $periodId)->first();
+            abort_if($row === null, 404);
+
+            return [
+                'start' => (string) $row->period_start,
+                'end' => (string) $row->period_end,
+            ];
+        }
+
+        $request->validate([
+            'period_start' => ['required_with:period_end', 'date'],
+            'period_end' => ['required_with:period_start', 'date', 'after_or_equal:period_start'],
+        ]);
+
+        $start = $request->query('period_start');
+        $end = $request->query('period_end');
+        if ($start && $end) {
+            return ['start' => (string) $start, 'end' => (string) $end];
+        }
+
+        $now = now();
+
+        return [
+            'start' => $now->copy()->subDays(7)->toDateTimeString(),
+            'end' => $now->toDateTimeString(),
+        ];
+    }
+}