feat: 增强代理结算和账单管理功能

- 在多个控制器中引入 SettlementPartyEnrichment 服务，以优化代理结算和账单的处理逻辑。
- 更新 AgentSettlementBillIndexController 和 AgentSettlementBillShowController，支持根据账单 ID 和关键字进行查询。
- 在 AgentSettlementPeriodCloseController 中添加对站点管理权限的验证，确保只有具备相应权限的管理员能够关闭账期。
- 在 AgentSettlementPeriodIndexController 中更新账期数据的返回格式，提升数据的完整性和可用性。
- 引入对相对占成比例的支持，增强代理资料的管理能力，确保数据一致性。

app/Services/AgentSettlement/AgentSettlementBillGuard.php

@@ -9,6 +9,8 @@ final class AgentSettlementBillGuard
 {
     private const LOCKED_STATUSES = ['confirmed', 'partial_paid', 'settled', 'overdue', 'reversed'];
 
+    private const PAYABLE_STATUSES = ['confirmed', 'partial_paid', 'overdue'];
+
     public function __construct(
         private readonly AgentSettlementPeriodCompletionService $periodCompletion,
     ) {}
@@ -37,6 +39,20 @@ final class AgentSettlementBillGuard
         }
     }
 
+    public function assertPayable(int $billId): void
+    {
+        $bill = DB::table('settlement_bills')->where('id', $billId)->first();
+        if ($bill === null) {
+            throw new \InvalidArgumentException('bill_not_found');
+        }
+
+        if (! in_array((string) $bill->status, self::PAYABLE_STATUSES, true)) {
+            throw ValidationException::withMessages([
+                'bill' => ['not_payable'],
+            ]);
+        }
+    }
+
     public function markConfirmed(int $billId): void
     {
         $this->assertPeriodMutable($billId);