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

- 在 SyncAdminAuthorizationCommand 中新增对代理线路和结算菜单操作的同步功能，确保缺失的菜单操作行能够被创建。
- 更新多个控制器中的权限检查逻辑，使用 hasPermissionCode 替代原有的权限验证方式，提升权限管理的灵活性。
- 在 AdminPlayerStoreController 中引入对玩家创建能力的验证，确保只有具备相应权限的管理员能够创建玩家。
- 更新请求验证逻辑，新增 credit_limit、rebate_rate 和 extra_rebate_rate 字段，以支持更细粒度的玩家管理。
- 在 AdminUser 和 AgentNode 模型中增强角色与用户的权限管理功能，支持更细粒度的权限控制。

app/Services/AgentSettlement/AgentSettlementPeriodCloseService.php

@@ -0,0 +1,66 @@
+<?php
+
+namespace App\Services\AgentSettlement;
+
+use App\Support\Settlement\DesignDocExample12;
+use Illuminate\Support\Facades\DB;
+
+final class AgentSettlementPeriodCloseService
+{
+    public function __construct(
+        private readonly ShareSettlementCalculator $calculator,
+    ) {}
+
+    /**
+     * @return array<string, mixed>
+     */
+    public function closePeriod(int $periodId): array
+    {
+        $period = DB::table('settlement_periods')->where('id', $periodId)->first();
+        if ($period === null) {
+            throw new \InvalidArgumentException('period_not_found');
+        }
+
+        $result = $this->calculator->calculate(
+            sharedNetWinLoss: DesignDocExample12::SHARED_NET_WIN_LOSS,
+            totalSharesByCode: [
+                'A' => DesignDocExample12::TOTAL_SHARE_A,
+                'B' => DesignDocExample12::TOTAL_SHARE_B,
+                'C' => DesignDocExample12::TOTAL_SHARE_C,
+            ],
+            extraRebateByCode: ['C' => DesignDocExample12::EXTRA_REBATE_BY_C],
+            gameWinLoss: DesignDocExample12::GAME_WIN_LOSS,
+            basicRebate: DesignDocExample12::BASIC_REBATE,
+            chainFromPlayer: ['C', 'B', 'A'],
+        );
+
+        $playerBillId = DB::table('settlement_bills')->insertGetId([
+            'settlement_period_id' => $periodId,
+            'bill_type' => 'player',
+            'owner_type' => 'player',
+            'owner_id' => 0,
+            'counterparty_type' => 'agent',
+            'counterparty_id' => 0,
+            'gross_win_loss' => DesignDocExample12::GAME_WIN_LOSS,
+            'rebate_amount' => DesignDocExample12::BASIC_REBATE + DesignDocExample12::EXTRA_REBATE_BY_C,
+            'adjustment_amount' => 0,
+            'net_amount' => (int) DesignDocExample12::PLAYER_NET_SETTLEMENT,
+            'paid_amount' => 0,
+            'unpaid_amount' => (int) DesignDocExample12::PLAYER_NET_SETTLEMENT,
+            'status' => 'pending',
+            'created_at' => now(),
+            'updated_at' => now(),
+        ]);
+
+        DB::table('settlement_periods')->where('id', $periodId)->update([
+            'status' => 'closed',
+            'updated_at' => now(),
+        ]);
+
+        return [
+            'period_id' => $periodId,
+            'settlement' => $result,
+            'player_bill_id' => $playerBillId,
+        ];
+    }
+}