TenantAtlas/app/Support/References/Resolvers/OperationRunReferenceResolver.php
ahmido 1b88d28739 feat: consolidate operation naming surfaces (#202)
## Summary
- align operator-visible OperationRun terminology to canonical `Operations` / `Operation` labels across shared links, notifications, verification/onboarding surfaces, summary widgets, and monitoring/detail pages
- add the Spec 171 planning artifacts under `specs/171-operations-naming-consolidation/`
- close the remaining tenant dashboard and admin copy drift found during browser smoke validation

## Validation
- `export PATH="/bin:/usr/bin:/usr/local/bin:$PATH" && vendor/bin/sail artisan test --compact tests/Unit/Support/RelatedNavigationResolverTest.php tests/Unit/Support/References/RelatedContextReferenceAdapterTest.php tests/Feature/OpsUx/NotificationViewRunLinkTest.php tests/Feature/Guards/ActionSurfaceContractTest.php tests/Feature/Operations/TenantlessOperationRunViewerTest.php tests/Feature/Filament/BackupSetResolvedReferencePresentationTest.php tests/Feature/Filament/TenantVerificationReportWidgetTest.php tests/Feature/Onboarding/OnboardingVerificationTest.php tests/Feature/Onboarding/OnboardingVerificationClustersTest.php tests/Feature/Onboarding/OnboardingVerificationV1_5UxTest.php tests/Feature/Filament/BaselineCompareSummaryConsistencyTest.php tests/Feature/Filament/WorkspaceOverviewContentTest.php tests/Feature/Filament/RecentOperationsSummaryWidgetTest.php tests/Feature/Monitoring/OperationLifecycleAggregateVisibilityTest.php tests/Feature/System/Spec114/OpsTriageActionsTest.php tests/Feature/System/Spec114/OpsFailuresViewTest.php tests/Feature/System/Spec114/OpsStuckViewTest.php`
- `export PATH="/bin:/usr/bin:/usr/local/bin:$PATH" && vendor/bin/sail artisan test --compact tests/Browser/OnboardingDraftRefreshTest.php`
- `export PATH="/bin:/usr/bin:/usr/local/bin:$PATH" && vendor/bin/sail bin pint --dirty --format agent`

## Notes
- no schema or route renames
- Filament / Livewire surface behavior stays within the existing admin and tenant panels
- OperationRunResource remains excluded from global search

Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de>
Reviewed-on: #202
2026-03-30 22:51:06 +00:00

75 lines
2.3 KiB
PHP

<?php
declare(strict_types=1);
namespace App\Support\References\Resolvers;
use App\Models\OperationRun;
use App\Models\User;
use App\Support\Navigation\CanonicalNavigationContext;
use App\Support\OperationCatalog;
use App\Support\OperationRunLinks;
use App\Support\References\ReferenceClass;
use App\Support\References\ReferenceDescriptor;
use App\Support\References\ReferenceLinkTarget;
use App\Support\References\ResolvedReference;
final class OperationRunReferenceResolver extends BaseReferenceResolver
{
public function __construct(
\App\Support\References\ReferenceTypeLabelCatalog $typeLabels,
) {
parent::__construct($typeLabels);
}
public function referenceClass(): ReferenceClass
{
return ReferenceClass::OperationRun;
}
public function resolve(ReferenceDescriptor $descriptor): ResolvedReference
{
$runId = $this->linkedModelId($descriptor);
$workspaceId = $descriptor->workspaceId;
if ($runId === null || $workspaceId === null || $workspaceId <= 0) {
return $this->unresolved($descriptor);
}
$run = OperationRun::query()
->whereKey($runId)
->where('workspace_id', $workspaceId)
->first();
if (! $run instanceof OperationRun) {
return $this->missing($descriptor);
}
if (! $this->canOpenOperationRun($run)) {
return $this->inaccessible($descriptor);
}
$context = $descriptor->contextValue('navigation_context');
$navigationContext = $context instanceof CanonicalNavigationContext ? $context : null;
return $this->resolved(
descriptor: $descriptor,
primaryLabel: OperationCatalog::label((string) $run->type),
secondaryLabel: OperationRunLinks::identifier($run),
linkTarget: new ReferenceLinkTarget(
targetKind: ReferenceClass::OperationRun->value,
url: OperationRunLinks::tenantlessView($run, $navigationContext),
actionLabel: OperationRunLinks::openLabel(),
contextBadge: $run->tenant_id ? 'Tenant context' : 'Workspace',
),
);
}
private function canOpenOperationRun(OperationRun $run): bool
{
$user = auth()->user();
return $user instanceof User && $user->can('view', $run);
}
}