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/AgentNodeStoreRequest.php

@@ -2,12 +2,14 @@
 
 namespace App\Http\Requests\Admin;
 
+use App\Http\Requests\Admin\Concerns\AdminAccountFieldRules;
 use App\Http\Requests\Admin\Concerns\AgentProfileFieldRules;
 use App\Http\Requests\ApiFormRequest;
 use Illuminate\Validation\Rule;
 
 final class AgentNodeStoreRequest extends ApiFormRequest
 {
+    use AdminAccountFieldRules;
     use AgentProfileFieldRules;
     public function authorize(): bool
     {
@@ -16,6 +18,7 @@ final class AgentNodeStoreRequest extends ApiFormRequest
 
     protected function prepareForValidation(): void
     {
+        $this->normalizeAdminAccountFields();
         $this->prepareAgentProfileFieldsForValidation();
     }
 
@@ -26,7 +29,7 @@ final class AgentNodeStoreRequest extends ApiFormRequest
             'parent_id' => ['required', 'integer', 'exists:agent_nodes,id'],
             'code' => ['sometimes', 'nullable', 'string', 'max:64', 'regex:/^[a-zA-Z0-9_-]+$/'],
             'name' => ['required', 'string', 'max:128'],
-            'username' => ['sometimes', 'nullable', 'string', 'max:64', Rule::unique('admin_users', 'username')],
+            'username' => ['sometimes', 'nullable', ...$this->adminOperatorUsernameRules(required: false), Rule::unique('admin_users', 'username')],
             'email' => ['nullable', 'email', 'max:255', Rule::unique('admin_users', 'email')],
             'password' => ['required', 'string', 'min:8', 'max:128'],
             'status' => ['sometimes', 'integer', 'in:0,1'],