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

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

app/Support/SettlementBatchFinancialSummary.php

@@ -7,7 +7,17 @@ use App\Models\SettlementBatch;
 final class SettlementBatchFinancialSummary
 {
     /**
-     * @return array{total_bet_amount: int, total_actual_deduct: int, platform_profit: int, currency_code: ?string}
+     * 所有金额字段均为最小货币单位（minor）。
+     *
+     * @return array{
+     *   total_bet_amount: int,
+     *   total_actual_deduct: int,
+     *   platform_profit: int,
+     *   total_bet_amount_minor: int,
+     *   total_actual_deduct_minor: int,
+     *   platform_profit_minor: int,
+     *   currency_code: ?string
+     * }
      */
     public static function forBatch(SettlementBatch $batch): array
     {
@@ -27,6 +37,10 @@ final class SettlementBatchFinancialSummary
             'total_bet_amount' => $totalBet,
             'total_actual_deduct' => $totalActualDeduct,
             'platform_profit' => $totalActualDeduct - $totalPayout,
+            // 显式别名：避免调用方误解为主货币单位。
+            'total_bet_amount_minor' => $totalBet,
+            'total_actual_deduct_minor' => $totalActualDeduct,
+            'platform_profit_minor' => $totalActualDeduct - $totalPayout,
             'currency_code' => is_string($totals?->currency_code) && $totals->currency_code !== ''
                 ? $totals->currency_code
                 : null,