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

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

app/Services/Agent/ShareRateValidator.php

@@ -8,17 +8,26 @@ use Illuminate\Validation\ValidationException;
 
 final class ShareRateValidator
 {
-    public function assertChildWithinParent(AgentNode $parent, float $childTotalShareRate): void
+    public function assertChildWithinParent(AgentNode $parent, float $childTotalShareRate, string $field = 'total_share_rate'): void
     {
         $parentRate = $this->totalShareRateForNode($parent);
         if ($childTotalShareRate > $parentRate) {
             throw ValidationException::withMessages([
-                'total_share_rate' => ['exceeds_parent'],
+                $field => ['exceeds_parent'],
             ]);
         }
         if ($childTotalShareRate < 0 || $childTotalShareRate > 100) {
             throw ValidationException::withMessages([
-                'total_share_rate' => ['invalid_range'],
+                $field => ['invalid_range'],
+            ]);
+        }
+    }
+
+    public function assertRelativeShareWithinBounds(float $relativeShareRate, string $field = 'relative_share_rate'): void
+    {
+        if ($relativeShareRate < 0 || $relativeShareRate > 100) {
+            throw ValidationException::withMessages([
+                $field => ['invalid_range'],
             ]);
         }
     }