ahmido
3c3daae405
## Summary - introduce a shared operator outcome taxonomy with semantic axes, severity bands, and next-action policy - apply the taxonomy to operations, evidence/review completeness, baseline semantics, and restore semantics - harden badge rendering, tenant-safe filtering/search behavior, and operator-facing summary/notification wording - add the spec kit artifacts, reference documentation, and regression coverage for diagnostic-vs-primary state handling ## Testing - focused Pest coverage for taxonomy registry and badge guardrails - operations presentation and notification tests - evidence, baseline, restore, and tenant-scope regression tests ## Notes - Livewire v4.0+ compliance is preserved in the existing Filament v5 stack - panel provider registration remains unchanged in bootstrap/providers.php - no new globally searchable resource was added; adopted resources remain tenant-safe and out of global search where required - no new destructive action family was introduced; existing actions keep their current authorization and confirmation behavior - no new frontend asset strategy was introduced; existing deploy flow with filament:assets remains unchanged Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de> Reviewed-on: #186
105 lines
2.5 KiB
PHP
105 lines
2.5 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace App\Support\OpsUx;
|
|
|
|
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
|
|
{
|
|
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)),
|
|
};
|
|
}
|
|
}
|