ahmido
5bcb4f6ab8
## Summary
- add a canonical queued execution legitimacy contract for actor-bound and system-authority operation runs
- enforce legitimacy before queued jobs transition runs to running across provider, inventory, restore, bulk, sync, and scheduled backup flows
- surface blocked execution outcomes consistently in Monitoring, notifications, audit data, and the tenantless operation viewer
- add Spec 149 artifacts and focused Pest coverage for legitimacy decisions, middleware ordering, blocked presentation, retry behavior, and cross-family adoption
## Testing
- vendor/bin/sail artisan test --compact tests/Unit/Operations/QueuedExecutionLegitimacyGateTest.php
- vendor/bin/sail artisan test --compact tests/Feature/Operations/QueuedExecutionMiddlewareOrderingTest.php
- vendor/bin/sail artisan test --compact tests/Feature/Verification/ProviderExecutionReauthorizationTest.php
- vendor/bin/sail artisan test --compact tests/Feature/Operations/RunInventorySyncExecutionReauthorizationTest.php
- vendor/bin/sail artisan test --compact tests/Feature/Operations/ExecuteRestoreRunExecutionReauthorizationTest.php
- vendor/bin/sail artisan test --compact tests/Feature/Operations/SystemRunBlockedExecutionNotificationTest.php
- vendor/bin/sail artisan test --compact tests/Feature/Operations/BulkOperationExecutionReauthorizationTest.php
- vendor/bin/sail artisan test --compact tests/Feature/Operations/QueuedExecutionRetryReauthorizationTest.php
- vendor/bin/sail artisan test --compact tests/Feature/Operations/QueuedExecutionContractMatrixTest.php
- vendor/bin/sail artisan test --compact tests/Feature/Operations/OperationRunBlockedExecutionPresentationTest.php
- vendor/bin/sail artisan test --compact tests/Feature/Operations/QueuedExecutionAuditTrailTest.php
- vendor/bin/sail artisan test --compact tests/Feature/Operations/TenantlessOperationRunViewerTest.php
- vendor/bin/sail bin pint --dirty --format agent
## Manual validation
- validated queued provider execution blocking for tenant operability drift in the integrated browser on /admin/operations and /admin/operations/{run}
- validated 404 vs 403 route behavior for non-membership vs in-scope capability denial
- validated initiator-null blocked system-run behavior without creating a user terminal notification
Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de>
Reviewed-on: #179
55 lines
1.4 KiB
PHP
55 lines
1.4 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace App\Support\OpsUx;
|
|
|
|
/**
|
|
* Normalize OperationRun legacy storage fields into Ops-UX canonical statuses.
|
|
*/
|
|
final class OperationStatusNormalizer
|
|
{
|
|
/**
|
|
* Returns one of: queued|running|succeeded|partial|blocked|failed.
|
|
*/
|
|
public static function toUxStatus(?string $status, ?string $outcome): string
|
|
{
|
|
$status = strtolower(trim((string) $status));
|
|
$outcome = strtolower(trim((string) $outcome));
|
|
|
|
if ($status === 'queued') {
|
|
return 'queued';
|
|
}
|
|
|
|
if ($status === 'running') {
|
|
return 'running';
|
|
}
|
|
|
|
if ($status === 'completed' && $outcome === 'blocked') {
|
|
return 'blocked';
|
|
}
|
|
|
|
// Terminal normalization (compatibility)
|
|
if ($status === 'failed' || $outcome === 'failed') {
|
|
return 'failed';
|
|
}
|
|
|
|
if ($status === 'completed' && $outcome === 'partially_succeeded') {
|
|
return 'partial';
|
|
}
|
|
|
|
if ($status === 'completed' && $outcome === 'succeeded') {
|
|
return 'succeeded';
|
|
}
|
|
|
|
// Best-effort fallback.
|
|
return match ($outcome) {
|
|
'partially_succeeded' => 'partial',
|
|
'succeeded' => 'succeeded',
|
|
'blocked' => 'blocked',
|
|
'failed' => 'failed',
|
|
default => 'failed',
|
|
};
|
|
}
|
|
}
|