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/Controllers/Api/V1/Admin/Player/AdminPlayerUpdateController.php

@@ -7,12 +7,14 @@ use App\Models\AgentNode;
 use App\Support\ApiResponse;
 use App\Support\AdminSiteScope;
 use Illuminate\Http\JsonResponse;
+use App\Support\PlayerFundingMode;
 use Illuminate\Support\Facades\DB;
 use App\Support\PlayerApiPresenter;
 use App\Http\Controllers\Controller;
 use App\Services\Agent\AgentProfileService;
 use App\Services\Agent\RebateLimitValidator;
 use App\Services\Player\PlayerCreditService;
+use Illuminate\Validation\ValidationException;
 use App\Services\Player\PlayerRebateProfileService;
 use App\Http\Requests\Admin\AdminPlayerUpdateRequest;
 
@@ -44,9 +46,18 @@ final class AdminPlayerUpdateController extends Controller
             ? AgentNode::query()->find((int) $player->agent_node_id)
             : null;
 
+        if (
+            ($request->has('credit_limit') || $request->has('rebate_rate') || $request->has('extra_rebate_rate'))
+            && ! PlayerFundingMode::usesCredit($player)
+        ) {
+            throw ValidationException::withMessages([
+                'credit_limit' => ['wallet_player_prohibited'],
+            ]);
+        }
+
         $rebateRate = 0.0;
         $extraRebateRate = 0.0;
-        if ($agent !== null && $request->has('rebate_rate')) {
+        if ($agent !== null && ($request->has('rebate_rate') || $request->has('extra_rebate_rate'))) {
             $rebateRate = (float) $request->input('rebate_rate', 0) / 100;
             $extraRebateRate = (float) $request->input('extra_rebate_rate', 0) / 100;
             $rebateLimitValidator->assertPlayerRebateWithinAgent(
@@ -67,7 +78,7 @@ final class AdminPlayerUpdateController extends Controller
             unset($data['credit_limit']);
         }
 
-        if ($request->has('rebate_rate')) {
+        if ($request->has('rebate_rate') || $request->has('extra_rebate_rate')) {
             DB::table('player_rebate_profiles')->updateOrInsert(
                 ['player_id' => $player->id, 'game_type' => '*'],
                 [