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

- 在多个控制器中更新权限检查逻辑，确保管理员能够更灵活地管理代理和玩家。 - 在 AdminPlayerStoreController 中引入对玩家创建能力的验证，确保只有具备相应权限的管理员能够创建玩家。 - 更新请求验证逻辑，新增 credit_limit、rebate_rate 和 extra_rebate_rate 字段，以支持更细粒度的玩家管理。 - 在 AgentNodeProfileController 中添加对父代理能力授予的验证，确保子代理的权限在父代理范围内。 - 引入 AgentProfileFieldRules 以简化代理资料更新请求的规则定义，提升代码复用性。
2026-06-04 18:00:50 +08:00
parent 96545f87f6
commit a44679665d
183 changed files with 10054 additions and 857 deletions
--- a/app/Http/Controllers/Api/V1/Admin/AgentSettlement/AgentSettlementBillAdjustmentController.php
+++ b/app/Http/Controllers/Api/V1/Admin/AgentSettlement/AgentSettlementBillAdjustmentController.php
@@ -0,0 +1,57 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1\Admin\AgentSettlement;
+
+use App\Http\Controllers\Controller;
+use App\Http\Middleware\RecordAdminApiAudit;
+use App\Http\Requests\Admin\AdminSettlementBillAdjustmentRequest;
+use App\Services\AgentSettlement\AgentSettlementBillAdjustmentService;
+use App\Services\AuditLogger;
+use App\Support\AdminAgentSettlementScope;
+use App\Support\ApiResponse;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Support\Facades\DB;
+
+final class AgentSettlementBillAdjustmentController extends Controller
+{
+    public function __invoke(
+        AdminSettlementBillAdjustmentRequest $request,
+        int $settlement_bill,
+        AgentSettlementBillAdjustmentService $adjustments,
+    ): JsonResponse {
+        $admin = $request->lotteryAdmin();
+        abort_if($admin === null, 401);
+        abort_if(! AdminAgentSettlementScope::billAccessible($admin, $settlement_bill), 404);
+
+        $before = DB::table('settlement_bills')->where('id', $settlement_bill)->first();
+        abort_if($before === null, 404);
+
+        $newBillId = $adjustments->createAdjustment(
+            $settlement_bill,
+            (int) $request->validated('amount'),
+            (string) ($request->validated('adjustment_type') ?? 'adjustment'),
+            $request->validated('reason'),
+            (int) $admin->id,
+        );
+
+        $after = DB::table('settlement_bills')->where('id', $newBillId)->first();
+
+        AuditLogger::recordForAdmin(
+            $admin,
+            $request,
+            moduleCode: 'settlement',
+            actionCode: 'settlement_bill.adjustment',
+            targetType: 'settlement_bill',
+            targetId: (string) $newBillId,
+            beforeJson: (array) $before,
+            afterJson: (array) $after,
+        );
+        $request->attributes->set(RecordAdminApiAudit::ATTRIBUTE_AUDIT_RECORDED, true);
+
+        return ApiResponse::success([
+            'original_bill_id' => $settlement_bill,
+            'adjustment_bill_id' => $newBillId,
+            'bill' => $after,
+        ]);
+    }
+}