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/Services/AgentSettlement/SettlementPaymentService.php
+++ b/app/Services/AgentSettlement/SettlementPaymentService.php
@@ -0,0 +1,81 @@
+<?php
+
+namespace App\Services\AgentSettlement;
+
+use App\Models\Player;
+use App\Services\Player\PlayerCreditService;
+use Illuminate\Support\Facades\DB;
+
+final class SettlementPaymentService
+{
+    public function __construct(
+        private readonly AgentSettlementBillGuard $billGuard,
+        private readonly PlayerCreditService $playerCreditService,
+        private readonly PeriodCloseRebateService $periodCloseRebate,
+        private readonly AgentSettlementPeriodCompletionService $periodCompletion,
+    ) {}
+
+    public function confirmBill(int $billId): void
+    {
+        $this->billGuard->markConfirmed($billId);
+    }
+
+    /**
+     * @param  array{method?: string|null, proof?: string|null, remark?: string|null}  $meta
+     */
+    public function recordPayment(int $billId, int $amount, int $adminUserId, array $meta = []): void
+    {
+        $bill = DB::table('settlement_bills')->where('id', $billId)->first();
+        if ($bill === null) {
+            throw new \InvalidArgumentException('bill_not_found');
+        }
+
+        $this->billGuard->assertPeriodMutable($billId);
+
+        $amount = min($amount, (int) $bill->unpaid_amount);
+        if ($amount <= 0) {
+            return;
+        }
+
+        DB::table('payment_records')->insert([
+            'settlement_bill_id' => $billId,
+            'payer_type' => (string) $bill->owner_type,
+            'payer_id' => (int) $bill->owner_id,
+            'payee_type' => (string) $bill->counterparty_type,
+            'payee_id' => (int) $bill->counterparty_id,
+            'amount' => $amount,
+            'method' => $meta['method'] ?? null,
+            'proof' => $meta['proof'] ?? null,
+            'remark' => $meta['remark'] ?? null,
+            'status' => 'confirmed',
+            'created_by' => $adminUserId,
+            'confirmed_by' => $adminUserId,
+            'confirmed_at' => now(),
+            'created_at' => now(),
+            'updated_at' => now(),
+        ]);
+
+        $newPaid = (int) $bill->paid_amount + $amount;
+        $newUnpaid = max(0, (int) $bill->unpaid_amount - $amount);
+        $status = $newUnpaid === 0 ? 'settled' : 'partial_paid';
+
+        DB::table('settlement_bills')->where('id', $billId)->update([
+            'paid_amount' => $newPaid,
+            'unpaid_amount' => $newUnpaid,
+            'status' => $status,
+            'updated_at' => now(),
+        ]);
+
+        if ($bill->owner_type === 'player' && (int) $bill->owner_id > 0) {
+            $player = Player::query()->find((int) $bill->owner_id);
+            if ($player !== null) {
+                $this->playerCreditService->releaseFromSettlement($player, $amount, $billId);
+                if ($status === 'settled') {
+                    $this->periodCloseRebate->markRebatesSettledForBill($billId);
+                }
+            }
+        }
+
+        $this->periodCompletion->syncIfReady((int) $bill->settlement_period_id);
+    }
+}