TenantAtlas/app/Support/OpsUx/SummaryCountsNormalizer.php
2026-03-22 21:18:37 +01:00

123 lines
3.1 KiB
PHP

<?php
declare(strict_types=1);
namespace App\Support\OpsUx;
use App\Support\ReasonTranslation\ReasonTranslator;
final class SummaryCountsNormalizer
{
/**
* @param array<string, mixed> $summaryCounts
* @return array<string, int>
*/
public static function normalize(array $summaryCounts): array
{
$allowedKeys = array_flip(OperationSummaryKeys::all());
$sanitized = [];
foreach ($summaryCounts as $key => $value) {
$key = trim((string) $key);
if ($key === '' || ! isset($allowedKeys[$key])) {
continue;
}
if (is_int($value)) {
$sanitized[$key] = $value;
continue;
}
if (is_float($value) && is_finite($value)) {
$sanitized[$key] = (int) round($value);
continue;
}
if (is_numeric($value)) {
$sanitized[$key] = (int) $value;
}
}
$ordered = [];
foreach (OperationSummaryKeys::all() as $key) {
if (array_key_exists($key, $sanitized)) {
$ordered[$key] = $sanitized[$key];
}
}
return $ordered;
}
/**
* @param array<string, mixed> $summaryCounts
*/
public static function renderSummaryLine(array $summaryCounts): ?string
{
$normalized = self::normalize($summaryCounts);
if ($normalized === []) {
return null;
}
$parts = [];
foreach ($normalized as $key => $value) {
if ($value === 0) {
continue;
}
$parts[] = self::label($key).': '.$value;
}
if ($parts === []) {
return null;
}
return implode(' · ', $parts);
}
/**
* Convert a snake_case summary key to a human-readable label.
*/
public static function label(string $key): string
{
$reasonCode = null;
if (str_starts_with($key, 'reason_')) {
$reasonCode = substr($key, strlen('reason_'));
} elseif (str_starts_with($key, 'blocked_reason_')) {
$reasonCode = substr($key, strlen('blocked_reason_'));
}
if (is_string($reasonCode) && $reasonCode !== '') {
$translation = app(ReasonTranslator::class)->translate($reasonCode, surface: 'summary_line');
if ($translation !== null) {
return 'Reason: '.$translation->operatorLabel;
}
}
return match ($key) {
'total' => 'Total',
'processed' => 'Processed',
'succeeded' => 'Completed successfully',
'failed' => 'Failed items',
'skipped' => 'Skipped items',
'items' => 'Affected items',
'tenants' => 'Tenants',
'created' => 'Created',
'updated' => 'Updated',
'deleted' => 'Deleted',
'finding_count' => 'Findings',
'report_count' => 'Reports',
'operation_count' => 'Operations',
default => ucfirst(str_replace('_', ' ', $key)),
};
}
}