feat: enhance agent management and validation logic

- Updated AGENTS.md to clarify agent account restrictions and permissions.
- Implemented checks in AgentNodeAdminUserStoreController and AgentNodeRoleStoreController to restrict admin user and role creation to the agent's own node.
- Enhanced validation in AdminPlayerStoreController and AdminPlayerUpdateController to enforce credit limit and rebate rate rules based on player funding mode.
- Refactored various request classes to utilize shared admin account field rules for consistency.
- Improved error handling in services related to credit allocation and rebate limits to ensure proper validation and messaging.

app/Http/Requests/Admin/AdminPlayerStoreRequest.php

@@ -3,6 +3,7 @@
 namespace App\Http\Requests\Admin;
 
 use Illuminate\Validation\Rule;
+use App\Http\Requests\Admin\Concerns\AdminAccountFieldRules;
 use App\Http\Requests\ApiFormRequest;
 
 /**
@@ -12,6 +13,8 @@ use App\Http\Requests\ApiFormRequest;
  */
 final class AdminPlayerStoreRequest extends ApiFormRequest
 {
+    use AdminAccountFieldRules;
+
     public function authorize(): bool
     {
         return true;
@@ -22,13 +25,13 @@ final class AdminPlayerStoreRequest extends ApiFormRequest
         return [
             'site_code' => ['required', 'string', 'max:64'],
             'site_player_id' => ['nullable', 'string', 'max:128'],
-            'username' => ['nullable', 'string', 'max:128'],
-            'password' => ['nullable', 'string', 'min:6', 'max:128'],
+            'username' => $this->nativePlayerUsernameRules(),
+            'password' => $this->nativePlayerPasswordRules(),
             'nickname' => ['nullable', 'string', 'max:128'],
             'default_currency' => ['sometimes', 'string', 'max:16', Rule::exists('currencies', 'code')],
             'status' => ['sometimes', 'integer', 'in:0,1,2'],
-            'agent_node_id' => ['sometimes', 'nullable', 'integer', 'min:1'],
-            'credit_limit' => ['sometimes', 'integer', 'min:0'],
+            'agent_node_id' => ['sometimes', 'nullable', 'integer', 'min:1', 'exists:agent_nodes,id'],
+            'credit_limit' => ['sometimes', 'integer', 'min:0', 'max:999999999'],
             'rebate_rate' => ['sometimes', 'numeric', 'min:0', 'max:100'],
             'extra_rebate_rate' => ['sometimes', 'numeric', 'min:0', 'max:100'],
         ];
@@ -36,6 +39,8 @@ final class AdminPlayerStoreRequest extends ApiFormRequest
 
     protected function prepareForValidation(): void
     {
+        $this->normalizeAdminAccountFields();
+
         if (! $this->has('default_currency')) {
             return;
         }