CaiWuXiTong/app/Business/InvoiceQuotaPageData.php
linchong 29e2779c7e fix: 发票额度预警使用精确支撑天数 (#1240)
使用未舍入的可支撑天数判断 5 天阈值,并以两位小数展示。
2026-11-18 16:52:10 +08:00

354 lines
13 KiB
PHP

<?php
namespace App\Business;
use App\Business\Piaoju\PiaojuSellerQuotaRepository;
use App\Models\Business\InvoiceBasic;
use Illuminate\Pagination\LengthAwarePaginator;
use Illuminate\Support\Carbon;
use Illuminate\Support\Collection;
use Throwable;
class InvoiceQuotaPageData
{
private const PER_PAGE = 50;
private const QUOTA_WARNING_DAYS = 5;
public function __construct(
private readonly PiaojuSellerQuotaRepository $piaojuQuotas,
) {
}
public function page(): array
{
try {
$periodOptions = InvoiceBasic::query()
->select('period')
->whereNotNull('period')
->where('period', '<>', '')
->distinct()
->orderByDesc('period')
->pluck('period')
->map(static fn ($period): string => trim((string) $period))
->filter(fn (string $period): bool => $this->normalizePeriod($period) !== null)
->unique()
->values();
$requestedPeriod = $this->normalizePeriod(
trim((string) request()->query('period', ''))
);
$period = $requestedPeriod ?? $periodOptions->first() ?? '';
$forecastContext = $this->forecastContext($period);
$sellerEntity = mb_substr(
trim((string) request()->query('seller_entity', '')),
0,
100
);
$query = InvoiceBasic::query()->select([
'id',
'store_entity',
'invoice_issuer',
'output_amount',
'period',
]);
if ($period !== '') {
$query->where('period', $period);
} else {
$query->where(function ($query): void {
$query->whereNull('period')->orWhere('period', '');
});
}
if ($sellerEntity !== '') {
$needle = '%' . addcslashes($sellerEntity, '%_\\') . '%';
$query->where('store_entity', 'like', $needle);
}
$snapshots = $this->piaojuQuotas->byNormalizedName();
$rows = $query
->orderBy('store_entity')
->orderByDesc('id')
->get()
->map(fn (InvoiceBasic $row): object => $this->presentRow(
$row,
$snapshots->get(PiaojuSellerQuotaRepository::normalizeName((string) $row->store_entity)),
$forecastContext,
))
->sortBy(static fn (object $row): string => sprintf(
'%02d|%s',
$row->status_rank,
(string) $row->store_entity
))
->values();
$total = $rows->count();
$lastPage = max(1, (int) ceil($total / self::PER_PAGE));
$currentPage = min(max((int) request()->query('page', 1), 1), $lastPage);
$pageRows = $rows
->slice(($currentPage - 1) * self::PER_PAGE, self::PER_PAGE)
->values();
$paginator = new LengthAwarePaginator(
$pageRows,
$total,
self::PER_PAGE,
$currentPage,
[
'path' => request()->url(),
'query' => request()->query(),
]
);
$usedAmount = $rows->sum(static fn (object $row): float => (float) $row->output_amount);
$usedTotal = round($usedAmount, 2);
$forecastTotal = (int) ($forecastContext['elapsed_days'] ?? 0) > 0
? round(
$usedAmount
* (int) ($forecastContext['days_in_month'] ?? 0)
/ (int) $forecastContext['elapsed_days'],
2
)
: 0.0;
$availableRows = $rows->filter(
static fn (object $row): bool => $row->available_amount !== null
);
$availableTotal = round($availableRows->sum(
static fn (object $row): float => (float) $row->available_amount
), 2);
$matchedCount = $rows->where('snapshot_matched', true)->count();
$unmatchedCount = $rows->where('snapshot_matched', false)->count();
$unavailableCount = $rows->where('snapshot_unavailable', true)->count();
$insufficientCount = $rows->where('insufficient', true)->count();
$warningCount = $rows->where('quota_warning', true)->count();
return [
'view' => 'business.pages.invoice_quota',
'title' => '发票额度',
'period' => $period,
'periodOptions' => $periodOptions,
'sellerEntity' => $sellerEntity,
'rows' => $paginator,
'summary' => [
'record_count' => $total,
'used_total' => $usedTotal,
'forecast_total' => $forecastTotal,
'available_total' => $availableTotal,
'matched_count' => $matchedCount,
'unmatched_count' => $unmatchedCount,
'unavailable_count' => $unavailableCount,
'insufficient_count' => $insufficientCount,
'warning_count' => $warningCount,
'forecast_elapsed_days' => $forecastContext['elapsed_days'],
'forecast_days_in_month' => $forecastContext['days_in_month'],
'forecast_is_current' => $forecastContext['is_current'],
'latest_quota_updated_at' => $this->latestDateTime(
$rows->pluck('quota_updated_at')
),
'latest_source_fetched_at' => $this->latestDateTime(
$rows->pluck('source_fetched_at')
),
],
'loadError' => null,
];
} catch (Throwable $exception) {
report($exception);
return $this->errorPayload();
}
}
private function presentRow(
InvoiceBasic $row,
?object $snapshot,
array $forecastContext,
): object
{
$outputAmount = round((float) $row->output_amount, 2);
$availableAmount = $snapshot !== null && is_numeric($snapshot->invoice_limit)
? round((float) $snapshot->invoice_limit, 2)
: null;
$authStatus = strtoupper(trim((string) ($snapshot->auth_status ?? '')));
$elapsedDays = (int) ($forecastContext['elapsed_days'] ?? 0);
$daysInMonth = (int) ($forecastContext['days_in_month'] ?? 0);
$dailyAverageRaw = $elapsedDays > 0
? $outputAmount / $elapsedDays
: null;
$dailyAverage = $dailyAverageRaw !== null ? round($dailyAverageRaw, 2) : null;
$forecastMonthly = $dailyAverageRaw !== null && $daysInMonth > 0
? round($outputAmount * $daysInMonth / $elapsedDays, 2)
: null;
$coverageDaysRaw = $dailyAverageRaw !== null && $dailyAverageRaw > 0 && $availableAmount !== null
? max($availableAmount, 0) / $dailyAverageRaw
: null;
$coverageDays = $coverageDaysRaw !== null ? round($coverageDaysRaw, 2) : null;
$quotaWarning = (bool) ($forecastContext['is_current'] ?? false)
&& $authStatus === 'AUTHENTICATED'
&& $availableAmount !== null
&& $availableAmount > 0
&& $coverageDaysRaw !== null
&& $coverageDaysRaw < self::QUOTA_WARNING_DAYS;
if ($snapshot === null) {
$status = '未匹配';
$statusTone = 'muted';
$statusIcon = 'link_off';
$statusRank = 0;
} elseif ($authStatus === 'AUTHENTICATED_EXPIRED') {
$status = '授权过期';
$statusTone = 'warning';
$statusIcon = 'schedule';
$statusRank = 1;
} elseif ($authStatus !== 'AUTHENTICATED') {
$status = '不可查看';
$statusTone = 'muted';
$statusIcon = 'visibility_off';
$statusRank = 1;
} elseif ($availableAmount === null) {
$status = '未获取额度';
$statusTone = 'muted';
$statusIcon = 'cloud_off';
$statusRank = 1;
} elseif ($availableAmount <= 0) {
$status = '额度不足';
$statusTone = 'danger';
$statusIcon = 'error';
$statusRank = 2;
} elseif ($quotaWarning) {
$status = '5天内预警';
$statusTone = 'danger';
$statusIcon = 'notification_important';
$statusRank = 2;
} else {
$status = '正常';
$statusTone = 'success';
$statusIcon = 'check_circle_outline';
$statusRank = 3;
}
return (object) [
'id' => $row->id,
'store_entity' => $row->store_entity,
'invoice_issuer' => $row->invoice_issuer,
'output_amount' => $outputAmount,
'daily_average' => $dailyAverage,
'forecast_monthly' => $forecastMonthly,
'available_amount' => $availableAmount,
'coverage_days' => $coverageDays,
'quota_updated_at' => $this->formatDateTime($snapshot->invoice_limit_updated_at ?? null),
'source_fetched_at' => $this->formatDateTime($snapshot->source_fetched_at ?? null),
'snapshot_matched' => $snapshot !== null,
'snapshot_unavailable' => $snapshot !== null
&& ($authStatus !== 'AUTHENTICATED' || $availableAmount === null),
'insufficient' => $snapshot !== null
&& $authStatus === 'AUTHENTICATED'
&& $availableAmount !== null
&& $availableAmount <= 0,
'quota_warning' => $quotaWarning,
'status' => $status,
'status_tone' => $statusTone,
'status_icon' => $statusIcon,
'status_rank' => $statusRank,
'period' => $row->period,
];
}
private function formatDateTime(mixed $value): ?string
{
$text = trim((string) ($value ?? ''));
if ($text === '') {
return null;
}
try {
return Carbon::parse($text, 'Asia/Shanghai')->format('Y-m-d H:i');
} catch (Throwable) {
return null;
}
}
private function latestDateTime(Collection $values): ?string
{
return $values
->filter(static fn (mixed $value): bool => trim((string) $value) !== '')
->sortDesc()
->first();
}
private function normalizePeriod(string $period): ?string
{
return preg_match('/^\d{4}-(0[1-9]|1[0-2])$/', $period) === 1
? $period
: null;
}
/**
* @return array{elapsed_days:int,days_in_month:int,is_current:bool}
*/
private function forecastContext(string $period): array
{
if ($period === '') {
return ['elapsed_days' => 0, 'days_in_month' => 0, 'is_current' => false];
}
try {
$month = Carbon::createFromFormat('!Y-m-d', $period . '-01', 'Asia/Shanghai');
$today = Carbon::now('Asia/Shanghai')->startOfDay();
} catch (Throwable) {
return ['elapsed_days' => 0, 'days_in_month' => 0, 'is_current' => false];
}
$daysInMonth = $month->daysInMonth;
if ($month->format('Y-m') === $today->format('Y-m')) {
return [
'elapsed_days' => min($today->day, $daysInMonth),
'days_in_month' => $daysInMonth,
'is_current' => true,
];
}
if ($month->lt($today->copy()->startOfMonth())) {
return [
'elapsed_days' => $daysInMonth,
'days_in_month' => $daysInMonth,
'is_current' => false,
];
}
return ['elapsed_days' => 0, 'days_in_month' => $daysInMonth, 'is_current' => false];
}
private function errorPayload(): array
{
return [
'view' => 'business.pages.invoice_quota',
'title' => '发票额度',
'period' => '',
'periodOptions' => collect(),
'sellerEntity' => '',
'rows' => new LengthAwarePaginator([], 0, self::PER_PAGE, 1, [
'path' => request()->url(),
'query' => request()->query(),
]),
'summary' => [
'record_count' => 0,
'used_total' => 0.0,
'forecast_total' => 0.0,
'available_total' => 0.0,
'matched_count' => 0,
'unmatched_count' => 0,
'unavailable_count' => 0,
'insufficient_count' => 0,
'warning_count' => 0,
'forecast_elapsed_days' => 0,
'forecast_days_in_month' => 0,
'forecast_is_current' => false,
'latest_quota_updated_at' => null,
'latest_source_fetched_at' => null,
],
'loadError' => '发票额度数据暂时无法读取,请稍后重试。',
];
}
}