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

- 在多个控制器中引入 SettlementPartyEnrichment 服务,以优化代理结算和账单的处理逻辑。
- 更新 AgentSettlementBillIndexController 和 AgentSettlementBillShowController,支持根据账单 ID 和关键字进行查询。
- 在 AgentSettlementPeriodCloseController 中添加对站点管理权限的验证,确保只有具备相应权限的管理员能够关闭账期。
- 在 AgentSettlementPeriodIndexController 中更新账期数据的返回格式,提升数据的完整性和可用性。
- 引入对相对占成比例的支持,增强代理资料的管理能力,确保数据一致性。
This commit is contained in:
2026-06-05 18:00:56 +08:00
parent a44679665d
commit 2d32f006c5
63 changed files with 4893 additions and 288 deletions

View File

@@ -32,8 +32,22 @@ final class AgentProfileService
$rebateLimit = (float) ($payload['rebate_limit'] ?? 0);
$defaultRebate = (float) ($payload['default_player_rebate'] ?? 0);
$useRelative = $parent !== null && array_key_exists('relative_share_rate', $payload);
// 如果提供了相对占成比例,计算绝对总占成
if ($useRelative) {
$relativeShare = (float) $payload['relative_share_rate'];
$this->shareRateValidator->assertRelativeShareWithinBounds($relativeShare);
$parentRate = $this->shareRateValidator->totalShareRateForNode($parent);
$totalShare = round($parentRate * $relativeShare / 100, 2);
}
if ($parent !== null) {
$this->shareRateValidator->assertChildWithinParent($parent, $totalShare);
$this->shareRateValidator->assertChildWithinParent(
$parent,
$totalShare,
$useRelative ? 'relative_share_rate' : 'total_share_rate',
);
}
return DB::transaction(function () use ($node, $payload, $parent, $totalShare, $creditLimit, $rebateLimit, $defaultRebate): AgentProfile {