TenantAtlas/app/Support/OperationRunLinks.php

<?php

namespace App\Support;

use App\Filament\Pages\BaselineCompareLanding;
use App\Filament\Resources\BackupScheduleResource;
use App\Filament\Resources\BackupSetResource;
use App\Filament\Resources\BaselineSnapshotResource;
use App\Filament\Resources\EntraGroupResource;
use App\Filament\Resources\EvidenceSnapshotResource;
use App\Filament\Resources\InventoryItemResource;
use App\Filament\Resources\PolicyResource;
use App\Filament\Resources\ProviderConnectionResource;
use App\Filament\Resources\RestoreRunResource;
use App\Filament\Resources\ReviewPackResource;
use App\Filament\Resources\TenantReviewResource;
use App\Models\EvidenceSnapshot;
use App\Models\OperationRun;
use App\Models\ReviewPack;
use App\Models\Tenant;
use App\Models\TenantReview;
use App\Support\Navigation\CanonicalNavigationContext;

final class OperationRunLinks
{
    public static function collectionLabel(): string
    {
        return 'Operations';
    }

    public static function openCollectionLabel(): string
    {
        return 'Open operations';
    }

    public static function collectionScopeDescription(): string
    {
        return 'Broader admin view across recent and historical operations.';
    }

    public static function viewInCollectionLabel(): string
    {
        return 'View in Operations';
    }

    public static function singularLabel(): string
    {
        return 'Operation';
    }

    public static function openLabel(): string
    {
        return 'Open operation';
    }

    public static function advancedMonitoringLabel(): string
    {
        return 'Open operation in Monitoring (advanced)';
    }

    public static function advancedMonitoringDescription(): string
    {
        return 'Diagnostics-only link to the canonical admin operation viewer.';
    }

    public static function identifierLabel(): string
    {
        return 'Operation ID';
    }

    public static function identifier(OperationRun|int $run): string
    {
        $runId = $run instanceof OperationRun ? (int) $run->getKey() : (int) $run;

        return 'Operation #'.$runId;
    }

    public static function index(
        ?Tenant $tenant = null,
        ?CanonicalNavigationContext $context = null,
        ?string $activeTab = null,
        bool $allTenants = false,
    ): string {
        $parameters = $context?->toQuery() ?? [];

        if ($tenant instanceof Tenant) {
            $parameters['tenant_id'] = (int) $tenant->getKey();
        } elseif ($allTenants) {
            $parameters['tenant_scope'] = 'all';
        }

        if (is_string($activeTab) && $activeTab !== '') {
            $parameters['activeTab'] = $activeTab;
        }

        return route('admin.operations.index', $parameters);
    }

    public static function tenantlessView(OperationRun|int $run, ?CanonicalNavigationContext $context = null): string
    {
        $runId = $run instanceof OperationRun ? (int) $run->getKey() : (int) $run;

        return route('admin.operations.view', array_merge(
            ['run' => $runId],
            $context?->toQuery() ?? [],
        ));
    }

    public static function view(OperationRun|int $run, Tenant $tenant, ?CanonicalNavigationContext $context = null): string
    {
        return self::tenantlessView($run, $context);
    }

    /**
     * @return array<string, string>
     */
    public static function related(OperationRun $run, ?Tenant $tenant): array
    {
        $context = is_array($run->context) ? $run->context : [];

        $links = [];

        $links[self::collectionLabel()] = self::index($tenant);

        if (! $tenant instanceof Tenant) {
            return $links;
        }

        $providerConnectionId = $context['provider_connection_id'] ?? null;

        if (is_numeric($providerConnectionId) && class_exists(ProviderConnectionResource::class)) {
            $links['Provider Connections'] = ProviderConnectionResource::getUrl('index', ['tenant' => $tenant], panel: 'admin');
            $links['Provider Connection'] = ProviderConnectionResource::getUrl('edit', ['tenant' => $tenant, 'record' => (int) $providerConnectionId], panel: 'admin');
        }

        if ($run->type === 'inventory_sync') {
            $links['Inventory'] = InventoryItemResource::getUrl('index', panel: 'tenant', tenant: $tenant);
        }

        if (in_array($run->type, ['policy.sync', 'policy.sync_one'], true)) {
            $links['Policies'] = PolicyResource::getUrl('index', panel: 'tenant', tenant: $tenant);

            $policyId = $context['policy_id'] ?? null;
            if (is_numeric($policyId)) {
                $links['Policy'] = PolicyResource::getUrl('view', ['record' => (int) $policyId], panel: 'tenant', tenant: $tenant);
            }
        }

        if ($run->type === 'entra_group_sync') {
            $links['Directory Groups'] = EntraGroupResource::scopedUrl('index', tenant: $tenant);
        }

        if ($run->type === 'baseline_compare') {
            $links['Drift'] = BaselineCompareLanding::getUrl(panel: 'tenant', tenant: $tenant);
        }

        if ($run->type === 'baseline_capture') {
            $snapshotId = data_get($context, 'result.snapshot_id');

            if (is_numeric($snapshotId)) {
                $links['Baseline Snapshot'] = BaselineSnapshotResource::getUrl('view', ['record' => (int) $snapshotId], panel: 'admin');
            }
        }

        if (in_array($run->type, ['backup_set.add_policies', 'backup_set.remove_policies'], true)) {
            $links['Backup Sets'] = BackupSetResource::getUrl('index', panel: 'tenant', tenant: $tenant);

            $backupSetId = $context['backup_set_id'] ?? null;
            if (is_numeric($backupSetId)) {
                $links['Backup Set'] = BackupSetResource::getUrl('view', ['record' => (int) $backupSetId], panel: 'tenant', tenant: $tenant);
            }
        }

        if (in_array($run->type, ['backup_schedule_run', 'backup_schedule_retention', 'backup_schedule_purge'], true)) {
            $links['Backup Schedules'] = BackupScheduleResource::getUrl('index', panel: 'tenant', tenant: $tenant);
        }

        if ($run->type === 'restore.execute') {
            $links['Restore Runs'] = RestoreRunResource::getUrl('index', panel: 'tenant', tenant: $tenant);

            $restoreRunId = $context['restore_run_id'] ?? null;
            if (is_numeric($restoreRunId)) {
                $links['Restore Run'] = RestoreRunResource::getUrl('view', ['record' => (int) $restoreRunId], panel: 'tenant', tenant: $tenant);
            }
        }

        if ($run->type === 'tenant.evidence.snapshot.generate') {
            $snapshot = EvidenceSnapshot::query()
                ->where('operation_run_id', (int) $run->getKey())
                ->latest('id')
                ->first();

            if ($snapshot instanceof EvidenceSnapshot) {
                $links['Evidence Snapshot'] = EvidenceSnapshotResource::getUrl('view', ['record' => $snapshot], tenant: $tenant);
            }
        }

        if ($run->type === 'tenant.review.compose') {
            $review = TenantReview::query()
                ->where('operation_run_id', (int) $run->getKey())
                ->latest('id')
                ->first();

            if ($review instanceof TenantReview) {
                $links['Tenant Review'] = TenantReviewResource::tenantScopedUrl('view', ['record' => $review], $tenant);
            }
        }

        if ($run->type === 'tenant.review_pack.generate') {
            $pack = ReviewPack::query()
                ->where('operation_run_id', (int) $run->getKey())
                ->latest('id')
                ->first();

            if ($pack instanceof ReviewPack) {
                $links['Review Pack'] = ReviewPackResource::getUrl('view', ['record' => $pack], tenant: $tenant);
            }
        }

        return array_filter($links, static fn (?string $url): bool => is_string($url) && $url !== '');
    }
}