133 lines
4.2 KiB
PHP
133 lines
4.2 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace App\Support\OpsUx;
|
|
|
|
use App\Models\OperationRun;
|
|
use App\Models\Tenant;
|
|
use App\Support\OperationCatalog;
|
|
use App\Support\RedactionIntegrity;
|
|
use Filament\Notifications\Notification as FilamentNotification;
|
|
|
|
final class OperationUxPresenter
|
|
{
|
|
public const int QUEUED_TOAST_DURATION_MS = 4000;
|
|
|
|
public const int FAILURE_MESSAGE_MAX_CHARS = 140;
|
|
|
|
/**
|
|
* Queued intent feedback toast (ephemeral, not persisted).
|
|
*/
|
|
public static function queuedToast(string $operationType): FilamentNotification
|
|
{
|
|
$operationLabel = OperationCatalog::label($operationType);
|
|
|
|
return FilamentNotification::make()
|
|
->title("{$operationLabel} queued")
|
|
->body('Running in the background.')
|
|
->warning()
|
|
->duration(self::QUEUED_TOAST_DURATION_MS);
|
|
}
|
|
|
|
/**
|
|
* Canonical dedupe feedback when a matching run is already active.
|
|
*/
|
|
public static function alreadyQueuedToast(string $operationType): FilamentNotification
|
|
{
|
|
$operationLabel = OperationCatalog::label($operationType);
|
|
|
|
return FilamentNotification::make()
|
|
->title("{$operationLabel} already queued")
|
|
->body('A matching run is already queued or running.')
|
|
->info()
|
|
->duration(self::QUEUED_TOAST_DURATION_MS);
|
|
}
|
|
|
|
/**
|
|
* Terminal DB notification payload.
|
|
*
|
|
* Note: We intentionally return the built Filament notification builder to
|
|
* keep DB formatting consistent with existing Notification classes.
|
|
*/
|
|
public static function terminalDatabaseNotification(OperationRun $run, ?Tenant $tenant = null): FilamentNotification
|
|
{
|
|
$operationLabel = OperationCatalog::label((string) $run->type);
|
|
|
|
$uxStatus = OperationStatusNormalizer::toUxStatus($run->status, $run->outcome);
|
|
|
|
$titleSuffix = match ($uxStatus) {
|
|
'succeeded' => 'completed',
|
|
'partial' => 'completed with warnings',
|
|
'blocked' => 'blocked',
|
|
default => 'failed',
|
|
};
|
|
|
|
$body = match ($uxStatus) {
|
|
'succeeded' => 'Completed successfully.',
|
|
'partial' => 'Completed with warnings.',
|
|
'blocked' => 'Execution was blocked.',
|
|
default => 'Failed.',
|
|
};
|
|
|
|
if (in_array($uxStatus, ['failed', 'blocked'], true)) {
|
|
$failureMessage = (string) (($run->failure_summary[0]['message'] ?? '') ?? '');
|
|
|
|
$failureMessage = self::sanitizeFailureMessage($failureMessage);
|
|
|
|
if ($failureMessage !== null) {
|
|
$body = $body.' '.$failureMessage;
|
|
}
|
|
}
|
|
|
|
$summary = SummaryCountsNormalizer::renderSummaryLine(is_array($run->summary_counts) ? $run->summary_counts : []);
|
|
if ($summary !== null) {
|
|
$body = $body."\n".$summary;
|
|
}
|
|
|
|
$integritySummary = RedactionIntegrity::noteForRun($run);
|
|
if (is_string($integritySummary) && trim($integritySummary) !== '') {
|
|
$body = $body."\n".trim($integritySummary);
|
|
}
|
|
|
|
$status = match ($uxStatus) {
|
|
'succeeded' => 'success',
|
|
'partial' => 'warning',
|
|
'blocked' => 'warning',
|
|
default => 'danger',
|
|
};
|
|
|
|
$notification = FilamentNotification::make()
|
|
->title("{$operationLabel} {$titleSuffix}")
|
|
->body($body)
|
|
->status($status);
|
|
|
|
if ($tenant instanceof Tenant) {
|
|
$notification->actions([
|
|
\Filament\Actions\Action::make('view')
|
|
->label('View run')
|
|
->url(OperationRunUrl::view($run, $tenant)),
|
|
]);
|
|
}
|
|
|
|
return $notification;
|
|
}
|
|
|
|
private static function sanitizeFailureMessage(string $failureMessage): ?string
|
|
{
|
|
$failureMessage = trim($failureMessage);
|
|
|
|
if ($failureMessage === '') {
|
|
return null;
|
|
}
|
|
|
|
$failureMessage = RunFailureSanitizer::sanitizeMessage($failureMessage);
|
|
|
|
if (mb_strlen($failureMessage) > self::FAILURE_MESSAGE_MAX_CHARS) {
|
|
$failureMessage = mb_substr($failureMessage, 0, self::FAILURE_MESSAGE_MAX_CHARS - 1).'…';
|
|
}
|
|
|
|
return $failureMessage !== '' ? $failureMessage : null;
|
|
}
|
|
}
|