Files
lotteryLaravel/app/Services/AgentSettlement/AgentSettlementPeriodSummaryService.php
kang 2d32f006c5 feat: 增强代理结算和账单管理功能
- 在多个控制器中引入 SettlementPartyEnrichment 服务,以优化代理结算和账单的处理逻辑。
- 更新 AgentSettlementBillIndexController 和 AgentSettlementBillShowController,支持根据账单 ID 和关键字进行查询。
- 在 AgentSettlementPeriodCloseController 中添加对站点管理权限的验证,确保只有具备相应权限的管理员能够关闭账期。
- 在 AgentSettlementPeriodIndexController 中更新账期数据的返回格式,提升数据的完整性和可用性。
- 引入对相对占成比例的支持,增强代理资料的管理能力,确保数据一致性。
2026-06-05 18:00:56 +08:00

105 lines
4.0 KiB
PHP

<?php
namespace App\Services\AgentSettlement;
use App\Models\AdminUser;
use App\Support\AdminAgentSettlementScope;
use Illuminate\Support\Collection;
use Illuminate\Support\Facades\DB;
/** 账期维度账单笔数与待办汇总(结算中心看板)。 */
final class AgentSettlementPeriodSummaryService
{
public function __construct(
private readonly AgentSettlementPeriodPipelineService $pipelineService,
private readonly ShareLedgerScopedProfitAggregator $scopedProfitAggregator,
) {}
/**
* @param list<int> $periodIds
* @return array<int, array<string, int>>
*/
public function summariesForPeriodIds(array $periodIds, ?AdminUser $admin = null): array
{
if ($periodIds === []) {
return [];
}
$query = DB::table('settlement_bills')
->whereIn('settlement_period_id', $periodIds);
if ($admin !== null) {
AdminAgentSettlementScope::applySubtreeToBillsQuery($query, $admin);
}
$rows = $query
->groupBy('settlement_period_id')
->selectRaw('settlement_period_id')
->selectRaw("SUM(CASE WHEN bill_type = 'player' THEN 1 ELSE 0 END) as player_bills")
->selectRaw("SUM(CASE WHEN bill_type = 'agent' THEN 1 ELSE 0 END) as agent_bills")
->selectRaw("SUM(CASE WHEN bill_type IN ('adjustment', 'reversal') THEN 1 ELSE 0 END) as adjustment_bills")
->selectRaw("SUM(CASE WHEN status = 'pending_confirm' THEN 1 ELSE 0 END) as pending_confirm")
->selectRaw("SUM(CASE WHEN status IN ('confirmed', 'partial_paid', 'overdue') AND unpaid_amount > 0 THEN 1 ELSE 0 END) as awaiting_payment")
->selectRaw("SUM(CASE WHEN status = 'settled' THEN 1 ELSE 0 END) as settled")
->selectRaw('COALESCE(SUM(unpaid_amount), 0) as total_unpaid')
->selectRaw('COALESCE(SUM(net_amount), 0) as total_net')
->get();
$out = [];
foreach ($rows as $row) {
$periodId = (int) $row->settlement_period_id;
$out[$periodId] = [
'player_bills' => (int) $row->player_bills,
'agent_bills' => (int) $row->agent_bills,
'adjustment_bills' => (int) $row->adjustment_bills,
'pending_confirm' => (int) $row->pending_confirm,
'awaiting_payment' => (int) $row->awaiting_payment,
'settled' => (int) $row->settled,
'total_unpaid' => (int) $row->total_unpaid,
'total_net' => (int) $row->total_net,
];
}
return $out;
}
/**
* @param Collection<int, object> $periods
* @return list<array<string, mixed>>
*/
public function attachToPeriodRows(Collection $periods, ?AdminUser $admin = null): array
{
$ids = $periods->pluck('id')->map(static fn ($id): int => (int) $id)->all();
$summaries = $this->summariesForPeriodIds($ids, $admin);
$pipelines = $this->pipelineService->countsForPeriods($periods, $admin);
$empty = [
'player_bills' => 0,
'agent_bills' => 0,
'adjustment_bills' => 0,
'pending_confirm' => 0,
'awaiting_payment' => 0,
'settled' => 0,
'total_unpaid' => 0,
'total_net' => 0,
];
$viewerScope = $this->scopedProfitAggregator->resolveViewer($admin)['scope'];
$emptyPipeline = [
'credit_ledger_count' => 0,
'share_ledger_count' => 0,
'game_win_loss_total' => 0,
'win_loss_scope' => $viewerScope,
'basic_rebate_total' => 0,
'unsettled_ticket_count' => 0,
];
$items = [];
foreach ($periods as $period) {
$row = (array) $period;
$row['summary'] = $summaries[(int) $period->id] ?? $empty;
$row['pipeline'] = $pipelines[(int) $period->id] ?? $emptyPipeline;
$items[] = $row;
}
return $items;
}
}