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

@@ -0,0 +1,30 @@
<?php
namespace App\Support;
use Carbon\Carbon;
/** 账期起止统一为日界startOfDay / endOfDay供聚合、流水、关账回填共用。 */
final class AgentSettlementPeriodWindow
{
/**
* @return array{0: Carbon, 1: Carbon}
*/
public static function bounds(string $periodStart, string $periodEnd): array
{
return [
Carbon::parse($periodStart)->startOfDay(),
Carbon::parse($periodEnd)->endOfDay(),
];
}
/**
* @return array{0: string, 1: string}
*/
public static function boundStrings(string $periodStart, string $periodEnd): array
{
[$start, $end] = self::bounds($periodStart, $periodEnd);
return [$start->toDateTimeString(), $end->toDateTimeString()];
}
}