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.

tests/Feature/AgentCreditAllocationTest.php

@@ -51,6 +51,8 @@ test('player credit account syncs agent allocated credit', function (): void {
         'site_code' => 'line-alloc',
         'agent_node_id' => $root->id,
         'site_player_id' => 'p-alloc-1',
+        'auth_source' => 'lottery_native',
+        'funding_mode' => 'credit',
         'username' => 'alloc1',
         'nickname' => null,
         'default_currency' => 'NPR',
@@ -90,6 +92,8 @@ test('win loss does not change agent allocated credit', function (): void {
         'site_code' => 'line-hold',
         'agent_node_id' => $root->id,
         'site_player_id' => 'p-hold-1',
+        'auth_source' => 'lottery_native',
+        'funding_mode' => 'credit',
         'username' => 'hold1',
         'nickname' => null,
         'default_currency' => 'NPR',
@@ -121,6 +125,8 @@ test('raising player credit limit succeeds when agent allocated credit includes
         'site_code' => 'line-player-raise',
         'agent_node_id' => $root->id,
         'site_player_id' => 'p-other',
+        'auth_source' => 'lottery_native',
+        'funding_mode' => 'credit',
         'username' => 'other',
         'nickname' => null,
         'default_currency' => 'NPR',
@@ -144,6 +150,8 @@ test('raising player credit limit succeeds when agent allocated credit includes
         'site_code' => 'line-player-raise',
         'agent_node_id' => $root->id,
         'site_player_id' => 'p-raise-1',
+        'auth_source' => 'lottery_native',
+        'funding_mode' => 'credit',
         'username' => 'raise1',
         'nickname' => null,
         'default_currency' => 'NPR',