Files
lotteryLaravel/app/Http/Controllers/Api/V1/Admin/AgentSettlement/AgentSettlementReportShowController.php
kang a44679665d feat: 增强代理和玩家管理功能
- 在多个控制器中更新权限检查逻辑,确保管理员能够更灵活地管理代理和玩家。
- 在 AdminPlayerStoreController 中引入对玩家创建能力的验证,确保只有具备相应权限的管理员能够创建玩家。
- 更新请求验证逻辑,新增 credit_limit、rebate_rate 和 extra_rebate_rate 字段,以支持更细粒度的玩家管理。
- 在 AgentNodeProfileController 中添加对父代理能力授予的验证,确保子代理的权限在父代理范围内。
- 引入 AgentProfileFieldRules 以简化代理资料更新请求的规则定义,提升代码复用性。
2026-06-04 18:00:50 +08:00

107 lines
3.5 KiB
PHP

<?php
namespace App\Http\Controllers\Api\V1\Admin\AgentSettlement;
use App\Http\Controllers\Controller;
use App\Services\AgentSettlement\AgentSettlementReportQueryService;
use App\Support\ApiResponse;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\DB;
final class AgentSettlementReportShowController extends Controller
{
private const TYPES = [
'summary',
'player_win_loss',
'agent_share',
'rebate',
'credit',
'unpaid_bills',
'overdue',
'platform_pnl',
'draw_period',
];
public function __invoke(Request $request, AgentSettlementReportQueryService $reports): JsonResponse
{
$admin = $request->lotteryAdmin();
abort_if($admin === null, 401);
$type = (string) $request->query('type', 'summary');
abort_unless(in_array($type, self::TYPES, true), 404);
$periodId = (int) $request->query('settlement_period_id', 0);
$period = $this->resolvePeriod($periodId, $request);
$data = match ($type) {
'summary' => $reports->summary($admin, $periodId),
'player_win_loss' => [
'items' => $reports->playerWinLoss($admin, $periodId, $period['start'], $period['end']),
],
'agent_share' => [
'items' => $reports->agentShare($admin, $period['start'], $period['end']),
],
'rebate' => $reports->rebate($admin, $periodId, $period['start'], $period['end']),
'credit' => $reports->credit($admin),
'unpaid_bills' => [
'items' => $reports->unpaidBills($admin, $periodId),
],
'overdue' => [
'items' => $reports->overdue($admin),
],
'platform_pnl' => $periodId > 0
? $reports->platformPnl($admin, $periodId)
: ['error' => 'settlement_period_id_required'],
'draw_period' => [
'items' => $reports->drawPeriod($admin, $period['start'], $period['end']),
],
default => [],
};
return ApiResponse::success([
'type' => $type,
'settlement_period_id' => $periodId > 0 ? $periodId : null,
'period_start' => $period['start'],
'period_end' => $period['end'],
'data' => $data,
'footnote' => $type === 'summary'
? null
: 'agent_credit_line_settlement',
]);
}
/**
* @return array{start: string, end: string}
*/
private function resolvePeriod(int $periodId, Request $request): array
{
if ($periodId > 0) {
$row = DB::table('settlement_periods')->where('id', $periodId)->first();
abort_if($row === null, 404);
return [
'start' => (string) $row->period_start,
'end' => (string) $row->period_end,
];
}
$request->validate([
'period_start' => ['required_with:period_end', 'date'],
'period_end' => ['required_with:period_start', 'date', 'after_or_equal:period_start'],
]);
$start = $request->query('period_start');
$end = $request->query('period_end');
if ($start && $end) {
return ['start' => (string) $start, 'end' => (string) $end];
}
$now = now();
return [
'start' => $now->copy()->subDays(7)->toDateTimeString(),
'end' => $now->toDateTimeString(),
];
}
}