feat: 增强代理和玩家管理功能

- 在多个控制器中更新权限检查逻辑，确保管理员能够更灵活地管理代理和玩家。
- 在 AdminPlayerStoreController 中引入对玩家创建能力的验证，确保只有具备相应权限的管理员能够创建玩家。
- 更新请求验证逻辑，新增 credit_limit、rebate_rate 和 extra_rebate_rate 字段，以支持更细粒度的玩家管理。
- 在 AgentNodeProfileController 中添加对父代理能力授予的验证，确保子代理的权限在父代理范围内。
- 引入 AgentProfileFieldRules 以简化代理资料更新请求的规则定义，提升代码复用性。

app/Http/Controllers/Api/V1/Admin/AgentSettlement/AgentSettlementBillConfirmController.php

@@ -4,9 +4,8 @@ namespace App\Http\Controllers\Api\V1\Admin\AgentSettlement;
 
 use App\Http\Controllers\Controller;
 use App\Http\Middleware\RecordAdminApiAudit;
-use App\Models\Player;
+use App\Services\AgentSettlement\SettlementPaymentService;
 use App\Services\AuditLogger;
-use App\Services\Player\PlayerCreditService;
 use App\Support\AdminAgentSettlementScope;
 use App\Support\ApiResponse;
 use Illuminate\Http\JsonResponse;
@@ -18,7 +17,7 @@ final class AgentSettlementBillConfirmController extends Controller
     public function __invoke(
         Request $request,
         int $settlement_bill,
-        PlayerCreditService $creditService,
+        SettlementPaymentService $payments,
     ): JsonResponse {
         $admin = $request->lotteryAdmin();
         abort_if($admin === null, 401);
@@ -28,21 +27,7 @@ final class AgentSettlementBillConfirmController extends Controller
         $bill = DB::table('settlement_bills')->where('id', $settlement_bill)->first();
         abort_if($bill === null, 404);
 
-        $unpaid = (int) $bill->unpaid_amount;
-        DB::table('settlement_bills')->where('id', $settlement_bill)->update([
-            'paid_amount' => (int) $bill->paid_amount + $unpaid,
-            'unpaid_amount' => 0,
-            'status' => 'confirmed',
-            'confirmed_at' => now(),
-            'updated_at' => now(),
-        ]);
-
-        if ($bill->owner_type === 'player' && (int) $bill->owner_id > 0) {
-            $player = Player::query()->find((int) $bill->owner_id);
-            if ($player !== null) {
-                $creditService->releaseFromSettlement($player, $unpaid, $settlement_bill);
-            }
-        }
+        $payments->confirmBill($settlement_bill);
 
         AuditLogger::recordForAdmin(
             $admin,
@@ -51,8 +36,8 @@ final class AgentSettlementBillConfirmController extends Controller
             actionCode: 'settlement_bill.confirm',
             targetType: 'settlement_bill',
             targetId: (string) $settlement_bill,
-            beforeJson: ['status' => (string) $bill->status, 'unpaid_amount' => $unpaid],
-            afterJson: ['status' => 'confirmed', 'paid_amount' => (int) $bill->paid_amount + $unpaid],
+            beforeJson: ['status' => (string) $bill->status],
+            afterJson: ['status' => 'confirmed'],
         );
         $request->attributes->set(RecordAdminApiAudit::ATTRIBUTE_AUDIT_RECORDED, true);