feat(agent-profile): 限制代理及玩家返点和分成范围，增强权限校验

- 添加ensureSuperAdmin方法，限制管理员设置操作权限
- 在AdminSettingController接口中新增权限检查，防止非超级管理员操作
- AdminPlayerIndexController新增direct agent筛选支持
- AdminPlayerUpdateController新增对信用玩家默认币别变更的拒绝逻辑
- 新增WalletSettlementBillsController，实现玩家信用盘账期账单摘要接口
- AgentProfileService调整，新增返点限额和分享比例自动下调机制，保持子代理及玩家配置不超父级
- AgentProfileService增加can_grant_extra_rebate权限继承限制，阻止无权限代理开启
- AgentSettlementPeriodCloseService增加玩家账单回水信用释放逻辑，确保信用额度同步
- PlayerCreditService新增释放账单回水对应信用逻辑，维护账期信用一致性
- TicketPlacementService和TicketPreviewService新增信用玩家投注币别匹配校验，防止币别不符
- PlayerLedgerLogsService优化信用额度计算，增加可用额度上下限限制，防止负值和超限
- 调整后台管理导航，仅超管可见设置入口，强化权限隔离
- 路由新增玩家信用账单查询接口
- 补充多项AgentProfile相关单元测试覆盖额度限制、返点继承、返点下调场景及权限限制
- 增加站点管理员登录测试，验证系统设置菜单不可见，提升用户权限体验

app/Http/Controllers/Api/V1/Admin/AdminSettingController.php

@@ -7,11 +7,14 @@ use App\Http\Middleware\RecordAdminApiAudit;
 use App\Http\Requests\Admin\AdminSettingBatchUpdateRequest;
 use App\Http\Requests\Admin\AdminSettingIndexRequest;
 use App\Http\Requests\Admin\AdminSettingUpdateRequest;
+use App\Lottery\ErrorCode;
 use App\Models\LotterySetting;
 use App\Services\AuditLogger;
-use App\Support\ApiResponse;
 use App\Services\LotterySettings;
+use App\Support\ApiMessage;
+use App\Support\ApiResponse;
 use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
 use Illuminate\Support\Facades\DB;
 
 /**
@@ -19,13 +22,21 @@ use Illuminate\Support\Facades\DB;
  */
 final class AdminSettingController extends Controller
 {
-    public function deployment(): JsonResponse
+    public function deployment(Request $request): JsonResponse
     {
+        if ($denied = $this->ensureSuperAdmin($request)) {
+            return $denied;
+        }
+
         return ApiResponse::success(LotterySettings::deploymentSnapshot());
     }
 
     public function index(AdminSettingIndexRequest $request): JsonResponse
     {
+        if ($denied = $this->ensureSuperAdmin($request)) {
+            return $denied;
+        }
+
         $validated = $request->validated();
         $query = LotterySetting::query()->orderBy('setting_key');
 
@@ -45,6 +56,10 @@ final class AdminSettingController extends Controller
 
     public function update(AdminSettingUpdateRequest $request, string $key): JsonResponse
     {
+        if ($denied = $this->ensureSuperAdmin($request)) {
+            return $denied;
+        }
+
         $setting = LotterySetting::query()->where('setting_key', $key)->first();
 
         LotterySettings::put(
@@ -66,6 +81,10 @@ final class AdminSettingController extends Controller
 
     public function batchUpdate(AdminSettingBatchUpdateRequest $request): JsonResponse
     {
+        if ($denied = $this->ensureSuperAdmin($request)) {
+            return $denied;
+        }
+
         /** @var list<array{key: string, value: mixed}> $items */
         $items = $request->validated('items');
 
@@ -106,4 +125,14 @@ final class AdminSettingController extends Controller
             ])->values()->all(),
         ]);
     }
+
+    private function ensureSuperAdmin(Request $request): ?JsonResponse
+    {
+        $admin = $request->lotteryAdmin();
+        if ($admin === null || ! $admin->isSuperAdmin()) {
+            return ApiMessage::errorResponse($request, 'admin.permission_denied', ErrorCode::AdminForbidden->value, null, 403);
+        }
+
+        return null;
+    }
 }

app/Http/Controllers/Api/V1/Admin/Player/AdminPlayerIndexController.php

@@ -38,6 +38,7 @@ final class AdminPlayerIndexController extends Controller
         $p = AdminApiList::readPaging($request);
         $keyword = trim((string) $request->query('keyword', ''));
         $status = $request->query('status');
+        $agentScope = trim((string) $request->query('agent_scope', ''));
         $scope = AdminScopePolicy::resolveContext($request, $admin);
 
         $q = Player::query()
@@ -49,6 +50,10 @@ final class AdminPlayerIndexController extends Controller
 
         AdminScopePolicy::applyPlayerFilters($q, $scope);
 
+        if ($agentScope === 'direct' && $scope->effectiveRequestedAgentNodeId() !== null) {
+            $q->where('agent_node_id', $scope->effectiveRequestedAgentNodeId());
+        }
+
         if ($keyword !== '') {
             $term = '%'.addcslashes($keyword, '%_\\').'%';
             $q->where(static function ($sub) use ($term, $keyword): void {

app/Http/Controllers/Api/V1/Admin/Player/AdminPlayerUpdateController.php

@@ -42,6 +42,14 @@ final class AdminPlayerUpdateController extends Controller
             $data['status'] = (int) $data['status'];
         }
 
+        if ($request->has('default_currency')
+            && PlayerFundingMode::usesCredit($player)
+            && strtoupper((string) $request->input('default_currency')) !== strtoupper((string) $player->default_currency)) {
+            throw ValidationException::withMessages([
+                'default_currency' => ['credit_player_currency_locked'],
+            ]);
+        }
+
         $agent = $player->agent_node_id !== null
             ? AgentNode::query()->find((int) $player->agent_node_id)
             : null;