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/AgentSettlementPeriodCompletionService.php
+++ b/app/Services/AgentSettlement/AgentSettlementPeriodCompletionService.php
@@ -0,0 +1,58 @@
+<?php
+
+namespace App\Services\AgentSettlement;
+
+use Illuminate\Support\Facades\DB;
+
+/** 账期全部账单结清或核销后标记为 completed（§4）。 */
+final class AgentSettlementPeriodCompletionService
+{
+    public function syncIfReady(int $periodId): void
+    {
+        if ($periodId <= 0) {
+            return;
+        }
+
+        $period = DB::table('settlement_periods')->where('id', $periodId)->first();
+        if ($period === null || (string) $period->status !== 'closed') {
+            return;
+        }
+
+        if ($this->hasOpenSettlementWork($periodId)) {
+            return;
+        }
+
+        DB::table('settlement_periods')
+            ->where('id', $periodId)
+            ->update([
+                'status' => 'completed',
+                'updated_at' => now(),
+            ]);
+    }
+
+    public function isPeriodReadOnly(int $periodId): bool
+    {
+        if ($periodId <= 0) {
+            return false;
+        }
+
+        $status = DB::table('settlement_periods')->where('id', $periodId)->value('status');
+
+        return $status !== null && (string) $status === 'completed';
+    }
+
+    private function hasOpenSettlementWork(int $periodId): bool
+    {
+        return DB::table('settlement_bills')
+            ->where('settlement_period_id', $periodId)
+            ->whereNotIn('bill_type', ['bad_debt'])
+            ->where(function ($query): void {
+                $query->where('status', 'pending_confirm')
+                    ->orWhere(function ($inner): void {
+                        $inner->whereIn('status', ['confirmed', 'partial_paid', 'overdue'])
+                            ->where('unpaid_amount', '>', 0);
+                    });
+            })
+            ->exists();
+    }
+}