ahmido
a107e7e41b
## Summary - add the Spec 181 restore-safety layer with scope fingerprinting, preview/check integrity states, execution safety snapshots, result attention, and operator-facing copy across the wizard, restore detail, and canonical operation detail - add focused unit and feature coverage for restore-safety assessment, result attention, and restore-linked operation detail - switch the finding exceptions queue `Inspect exception` action to a native Filament slide-over while preserving query-param-backed inline summary behavior ## Testing - `vendor/bin/sail artisan test --compact tests/Feature/Monitoring/FindingExceptionsQueueTest.php tests/Feature/Filament/RestoreSafetyIntegrityWizardTest.php tests/Feature/Filament/RestoreResultAttentionSurfaceTest.php tests/Feature/Operations/RestoreLinkedOperationDetailTest.php tests/Unit/Support/RestoreSafety` ## Notes - Spec 181 checklist is complete (`specs/181-restore-safety-integrity/checklists/requirements.md`) - the branch still has unchecked follow-up tasks in `specs/181-restore-safety-integrity/tasks.md`: `T012`, `T018`, `T019`, `T023`, `T025`, `T029`, `T032`, `T033`, `T041`, `T042`, `T043`, `T044` - Filament v5 / Livewire v4 compliance is preserved, no panel provider registration changes were made, no global-search behavior was added, destructive actions remain confirmation-gated, and no new Filament assets were introduced Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de> Reviewed-on: #210
72 lines
1.9 KiB
PHP
72 lines
1.9 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace App\Support\RestoreSafety;
|
|
|
|
use InvalidArgumentException;
|
|
|
|
final readonly class PreviewIntegrityState
|
|
{
|
|
public const string STATE_NOT_GENERATED = 'not_generated';
|
|
|
|
public const string STATE_CURRENT = 'current';
|
|
|
|
public const string STATE_STALE = 'stale';
|
|
|
|
public const string STATE_INVALIDATED = 'invalidated';
|
|
|
|
public const string FRESHNESS_POLICY = 'invalidate_after_mutation';
|
|
|
|
/**
|
|
* @param list<string> $invalidationReasons
|
|
*/
|
|
public function __construct(
|
|
public string $state,
|
|
public string $freshnessPolicy,
|
|
public ?string $fingerprint,
|
|
public ?string $generatedAt,
|
|
public array $invalidationReasons,
|
|
public bool $rerunRequired,
|
|
public string $displaySummary,
|
|
) {
|
|
if (! in_array($this->state, [
|
|
self::STATE_NOT_GENERATED,
|
|
self::STATE_CURRENT,
|
|
self::STATE_STALE,
|
|
self::STATE_INVALIDATED,
|
|
], true)) {
|
|
throw new InvalidArgumentException('Unsupported preview integrity state.');
|
|
}
|
|
}
|
|
|
|
public function isCurrent(): bool
|
|
{
|
|
return $this->state === self::STATE_CURRENT;
|
|
}
|
|
|
|
/**
|
|
* @return array{
|
|
* state: string,
|
|
* freshness_policy: string,
|
|
* fingerprint: ?string,
|
|
* generated_at: ?string,
|
|
* invalidation_reasons: list<string>,
|
|
* rerun_required: bool,
|
|
* display_summary: string
|
|
* }
|
|
*/
|
|
public function toArray(): array
|
|
{
|
|
return [
|
|
'state' => $this->state,
|
|
'freshness_policy' => $this->freshnessPolicy,
|
|
'fingerprint' => $this->fingerprint,
|
|
'generated_at' => $this->generatedAt,
|
|
'invalidation_reasons' => $this->invalidationReasons,
|
|
'rerun_required' => $this->rerunRequired,
|
|
'display_summary' => $this->displaySummary,
|
|
];
|
|
}
|
|
}
|