feat: enhance player authentication and agent management features

- Updated AGENTS.md to clarify player interface bindings and agent account restrictions.
- Improved PlayerAuthLoginController to include captcha verification for player login.
- Enhanced AdminPlayerIndexController with permission checks for admin users.
- Refactored AdminPlayerStoreController to enforce agent node restrictions for non-super admins.
- Introduced new error codes for player authentication failures and updated related services.
- Enhanced validation rules for agent profiles to include settlement cycle options.
- Improved AdminCaptchaService to support separate scopes for admin and player captcha handling.
- Updated various services to ensure proper credit management and settlement processes.

app/Services/Agent/AgentProfileService.php

@@ -40,6 +40,12 @@ final class AgentProfileService
         $defaultRebate = array_key_exists('default_player_rebate', $payload)
             ? (float) $payload['default_player_rebate'] / 100
             : (float) ($existingProfile->default_player_rebate ?? 0);
+        $settlementCycle = array_key_exists('settlement_cycle', $payload)
+            ? (string) $payload['settlement_cycle']
+            : (string) ($existingProfile->settlement_cycle ?? config('agent_line_defaults.settlement_cycle', 'weekly'));
+        if ($settlementCycle === '') {
+            $settlementCycle = 'weekly';
+        }
 
         $useRelative = $parent !== null && array_key_exists('relative_share_rate', $payload);
 
@@ -59,7 +65,7 @@ final class AgentProfileService
             );
         }
 
-        return DB::transaction(function () use ($node, $payload, $parent, $totalShare, $creditLimit, $rebateLimit, $defaultRebate): AgentProfile {
+        return DB::transaction(function () use ($node, $payload, $parent, $totalShare, $creditLimit, $rebateLimit, $defaultRebate, $settlementCycle): AgentProfile {
             $profile = AgentProfile::query()->firstOrNew(['agent_node_id' => $node->id]);
             $previousCredit = (int) $profile->credit_limit;
             $isNew = ! $profile->exists;
@@ -104,6 +110,7 @@ final class AgentProfileService
                 'can_grant_extra_rebate' => (bool) ($payload['can_grant_extra_rebate'] ?? $profile->can_grant_extra_rebate ?? false),
                 'can_create_child_agent' => (bool) ($payload['can_create_child_agent'] ?? ($isNew ? false : $profile->can_create_child_agent)),
                 'can_create_player' => (bool) ($payload['can_create_player'] ?? ($isNew ? true : $profile->can_create_player ?? true)),
+                'settlement_cycle' => $settlementCycle,
             ]);
             if (! $profile->exists) {
                 $profile->allocated_credit = 0;
@@ -141,6 +148,7 @@ final class AgentProfileService
             'can_grant_extra_rebate' => (bool) $profile->can_grant_extra_rebate,
             'can_create_child_agent' => (bool) $profile->can_create_child_agent,
             'can_create_player' => (bool) $profile->can_create_player,
+            'settlement_cycle' => (string) ($profile->settlement_cycle ?? 'weekly'),
         ];
     }