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

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

app/Http/Requests/Admin/AdminAgentLineStoreRequest.php

@@ -4,12 +4,15 @@ namespace App\Http\Requests\Admin;
 
 use App\Http\Requests\Admin\Concerns\AgentProfileFieldRules;
 use App\Http\Requests\ApiFormRequest;
-use App\Rules\WalletApiUrlRule;
+use App\Models\AdminSite;
+use App\Models\AgentNode;
 use Illuminate\Validation\Rule;
+use Illuminate\Validation\Validator;
 
 final class AdminAgentLineStoreRequest extends ApiFormRequest
 {
     use AgentProfileFieldRules;
+
     public function authorize(): bool
     {
         return true;
@@ -18,29 +21,56 @@ final class AdminAgentLineStoreRequest extends ApiFormRequest
     protected function prepareForValidation(): void
     {
         $this->prepareAgentProfileFieldsForValidation();
+
+        if ($this->has('site_code')) {
+            $this->merge([
+                'site_code' => strtolower(trim((string) $this->input('site_code'))),
+            ]);
+        }
+
+        if ($this->has('code')) {
+            $this->merge([
+                'code' => strtolower(trim((string) $this->input('code'))),
+            ]);
+        }
     }
 
     /** @return array<string, mixed> */
     public function rules(): array
     {
         return [
-            'code' => ['required', 'string', 'max:64', 'regex:/^[a-z0-9][a-z0-9_-]*$/', Rule::unique('admin_sites', 'code')],
+            'site_code' => ['required', 'string', 'max:64', 'regex:/^[a-z0-9][a-z0-9_-]*$/', Rule::exists('admin_sites', 'code')],
+            'code' => ['required', 'string', 'max:64', 'regex:/^[a-z0-9][a-z0-9_-]*$/', Rule::unique('agent_nodes', 'code')],
             'name' => ['required', 'string', 'max:128'],
-            'username' => ['required', 'string', 'max:64'],
+            'username' => ['required', 'string', 'max:64', Rule::unique('admin_users', 'username')],
             'password' => ['required', 'string', 'min:8', 'max:128'],
             'email' => ['nullable', 'string', 'email', 'max:255', Rule::unique('admin_users', 'email')],
-            'currency_code' => ['sometimes', 'string', 'max:16'],
             'status' => ['sometimes', 'integer', 'in:0,1'],
-            'wallet_api_url' => ['nullable', 'string', 'max:512', new WalletApiUrlRule()],
-            'wallet_debit_path' => ['sometimes', 'string', 'max:128'],
-            'wallet_credit_path' => ['sometimes', 'string', 'max:128'],
-            'wallet_balance_path' => ['sometimes', 'string', 'max:128'],
-            'wallet_timeout_seconds' => ['sometimes', 'integer', 'min:1', 'max:120'],
-            'iframe_allowed_origins' => ['nullable', 'array'],
-            'iframe_allowed_origins.*' => ['string', 'max:512'],
-            'lottery_h5_base_url' => ['nullable', 'string', 'max:512'],
-            'notes' => ['nullable', 'string', 'max:5000'],
             ...$this->agentProfileFieldRules(),
         ];
     }
+
+    public function withValidator(Validator $validator): void
+    {
+        $validator->after(function (Validator $validator): void {
+            if ($validator->errors()->isNotEmpty()) {
+                return;
+            }
+
+            $siteCode = (string) $this->input('site_code');
+            $site = AdminSite::query()->where('code', $siteCode)->first();
+            if ($site === null) {
+                return;
+            }
+
+            $hasRoot = AgentNode::query()
+                ->where('admin_site_id', $site->id)
+                ->where('depth', 0)
+                ->exists();
+
+            if ($hasRoot) {
+                $validator->errors()->add('site_code', 'site_root_exists');
+            }
+        });
+    }
 }

app/Http/Requests/Admin/AdminPlayerStoreRequest.php

@@ -21,8 +21,9 @@ final class AdminPlayerStoreRequest extends ApiFormRequest
     {
         return [
             'site_code' => ['required', 'string', 'max:64'],
-            'site_player_id' => ['required', 'string', 'max:128'],
+            'site_player_id' => ['nullable', 'string', 'max:128'],
             'username' => ['nullable', 'string', 'max:128'],
+            'password' => ['nullable', 'string', 'min:6', 'max:128'],
             'nickname' => ['nullable', 'string', 'max:128'],
             'default_currency' => ['sometimes', 'string', 'max:16', Rule::exists('currencies', 'code')],
             'status' => ['sometimes', 'integer', 'in:0,1,2'],

app/Http/Requests/Admin/AdminPlayerUpdateRequest.php

@@ -24,6 +24,16 @@ final class AdminPlayerUpdateRequest extends ApiFormRequest
             'nickname' => ['sometimes', 'nullable', 'string', 'max:128'],
             'default_currency' => ['sometimes', 'string', 'max:16', Rule::exists('currencies', 'code')],
             'status' => ['sometimes', 'integer', Rule::in([0, 1, 2])],
+            'credit_limit' => ['sometimes', 'integer', 'min:0'],
+            'rebate_rate' => ['sometimes', 'numeric', 'min:0', 'max:1'],
+            'extra_rebate_rate' => ['sometimes', 'numeric', 'min:0', 'max:1'],
+            'rebate_profiles' => ['sometimes', 'array'],
+            'rebate_profiles.*.game_type' => ['required_with:rebate_profiles', 'string', 'max:32'],
+            'rebate_profiles.*.rebate_rate' => ['sometimes', 'numeric', 'min:0', 'max:1'],
+            'rebate_profiles.*.extra_rebate_rate' => ['sometimes', 'numeric', 'min:0', 'max:1'],
+            'rebate_profiles.*.inherit_from_agent' => ['sometimes', 'boolean'],
+            'risk_tags' => ['sometimes', 'array'],
+            'risk_tags.*' => ['string', 'max:64'],
         ];
     }
 

app/Http/Requests/Admin/AdminSettlementBillAdjustmentRequest.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace App\Http\Requests\Admin;
+
+use App\Http\Requests\ApiFormRequest;
+
+final class AdminSettlementBillAdjustmentRequest extends ApiFormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    public function rules(): array
+    {
+        return [
+            'amount' => ['required', 'integer', 'not_in:0'],
+            'adjustment_type' => ['sometimes', 'string', 'in:adjustment,reversal'],
+            'reason' => ['sometimes', 'nullable', 'string', 'max:255'],
+        ];
+    }
+}

app/Http/Requests/Admin/AdminSettlementBillBadDebtRequest.php

@@ -0,0 +1,20 @@
+<?php
+
+namespace App\Http\Requests\Admin;
+
+use App\Http\Requests\ApiFormRequest;
+
+final class AdminSettlementBillBadDebtRequest extends ApiFormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    public function rules(): array
+    {
+        return [
+            'reason' => ['sometimes', 'nullable', 'string', 'max:255'],
+        ];
+    }
+}

app/Http/Requests/Admin/AdminSettlementBillPaymentRequest.php

@@ -0,0 +1,23 @@
+<?php
+
+namespace App\Http\Requests\Admin;
+
+use App\Http\Requests\ApiFormRequest;
+
+final class AdminSettlementBillPaymentRequest extends ApiFormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    public function rules(): array
+    {
+        return [
+            'amount' => ['required', 'integer', 'min:1'],
+            'method' => ['sometimes', 'nullable', 'string', 'max:32'],
+            'proof' => ['sometimes', 'nullable', 'string', 'max:2000'],
+            'remark' => ['sometimes', 'nullable', 'string', 'max:255'],
+        ];
+    }
+}

app/Http/Requests/Admin/AdminUserRoleSyncRequest.php

@@ -22,6 +22,7 @@ final class AdminUserRoleSyncRequest extends ApiFormRequest
     public function rules(): array
     {
         return [
+            'admin_site_id' => ['required', 'integer', 'exists:admin_sites,id'],
             'role_slugs' => ['required', 'array', 'min:1'],
             'role_slugs.*' => ['string', 'max:64', 'distinct', 'exists:admin_roles,slug'],
         ];

app/Http/Requests/Admin/AdminUserStoreRequest.php

@@ -52,6 +52,7 @@ final class AdminUserStoreRequest extends ApiFormRequest
             'email' => ['nullable', 'string', 'email', 'max:255'],
             'password' => ['required', 'string', 'min:8', 'max:256'],
             'status' => ['sometimes', 'integer', 'in:0,1'],
+            'admin_site_id' => ['required', 'integer', 'exists:admin_sites,id'],
             'role_slugs' => ['required', 'array', 'min:1'],
             'role_slugs.*' => ['string', 'max:64', 'distinct', 'exists:admin_roles,slug'],
         ];

app/Http/Requests/Admin/Concerns/AgentProfileFieldRules.php

@@ -18,6 +18,8 @@ trait AgentProfileFieldRules
             'can_grant_extra_rebate' => ['sometimes', 'boolean'],
             'can_create_child_agent' => ['sometimes', 'boolean'],
             'can_create_player' => ['sometimes', 'boolean'],
+            'risk_tags' => ['sometimes', 'array'],
+            'risk_tags.*' => ['string', 'max:64'],
         ];
     }