TenantAtlas/app/Filament/Widgets/Dashboard/RecentOperations.php

<?php

declare(strict_types=1);

namespace App\Filament\Widgets\Dashboard;

use App\Models\OperationRun;
use App\Models\Tenant;
use App\Support\Badges\BadgeDomain;
use App\Support\Badges\BadgeRenderer;
use App\Support\OperationCatalog;
use App\Support\OperationRunLinks;
use App\Support\OpsUx\ActiveRuns;
use App\Support\OpsUx\OperationUxPresenter;
use Filament\Facades\Filament;
use Filament\Tables\Columns\TextColumn;
use Filament\Tables\Table;
use Filament\Widgets\TableWidget;
use Illuminate\Database\Eloquent\Builder;

class RecentOperations extends TableWidget
{
    protected int|string|array $columnSpan = 'full';

    public function table(Table $table): Table
    {
        $tenant = Filament::getTenant();

        return $table
            ->heading('Recent Operations')
            ->query($this->getQuery())
            ->poll(fn (): ?string => ActiveRuns::pollingIntervalForTenant($tenant instanceof Tenant ? $tenant : null))
            ->defaultSort('created_at', 'desc')
            ->paginated(\App\Support\Filament\TablePaginationProfiles::widget())
            ->columns([
                TextColumn::make('short_id')
                    ->label(OperationRunLinks::identifierLabel())
                    ->state(fn (OperationRun $record): string => OperationRunLinks::identifier($record))
                    ->copyable()
                    ->copyableState(fn (OperationRun $record): string => (string) $record->getKey()),
                TextColumn::make('type')
                    ->label('Operation')
                    ->sortable()
                    ->formatStateUsing(fn (?string $state): string => OperationCatalog::label((string) $state))
                    ->limit(40)
                    ->description(fn (OperationRun $record): ?string => OperationUxPresenter::lifecycleAttentionSummary($record))
                    ->tooltip(fn (OperationRun $record): string => OperationCatalog::label((string) $record->type)),
                TextColumn::make('status')
                    ->badge()
                    ->sortable()
                    ->toggleable(isToggledHiddenByDefault: true)
                    ->formatStateUsing(fn (mixed $state, OperationRun $record): string => BadgeRenderer::spec(BadgeDomain::OperationRunStatus, [
                        'status' => (string) $record->status,
                        'freshness_state' => $record->freshnessState()->value,
                    ])->label)
                    ->color(fn (mixed $state, OperationRun $record): string => BadgeRenderer::spec(BadgeDomain::OperationRunStatus, [
                        'status' => (string) $record->status,
                        'freshness_state' => $record->freshnessState()->value,
                    ])->color)
                    ->icon(fn (mixed $state, OperationRun $record): ?string => BadgeRenderer::spec(BadgeDomain::OperationRunStatus, [
                        'status' => (string) $record->status,
                        'freshness_state' => $record->freshnessState()->value,
                    ])->icon)
                    ->iconColor(fn (mixed $state, OperationRun $record): ?string => BadgeRenderer::spec(BadgeDomain::OperationRunStatus, [
                        'status' => (string) $record->status,
                        'freshness_state' => $record->freshnessState()->value,
                    ])->iconColor)
                    ->description(null),
                TextColumn::make('outcome')
                    ->badge()
                    ->sortable()
                    ->formatStateUsing(fn (mixed $state, OperationRun $record): string => BadgeRenderer::spec(BadgeDomain::OperationRunOutcome, [
                        'outcome' => (string) $record->outcome,
                        'status' => (string) $record->status,
                        'freshness_state' => $record->freshnessState()->value,
                    ])->label)
                    ->color(fn (mixed $state, OperationRun $record): string => BadgeRenderer::spec(BadgeDomain::OperationRunOutcome, [
                        'outcome' => (string) $record->outcome,
                        'status' => (string) $record->status,
                        'freshness_state' => $record->freshnessState()->value,
                    ])->color)
                    ->icon(fn (mixed $state, OperationRun $record): ?string => BadgeRenderer::spec(BadgeDomain::OperationRunOutcome, [
                        'outcome' => (string) $record->outcome,
                        'status' => (string) $record->status,
                        'freshness_state' => $record->freshnessState()->value,
                    ])->icon)
                    ->iconColor(fn (mixed $state, OperationRun $record): ?string => BadgeRenderer::spec(BadgeDomain::OperationRunOutcome, [
                        'outcome' => (string) $record->outcome,
                        'status' => (string) $record->status,
                        'freshness_state' => $record->freshnessState()->value,
                    ])->iconColor)
                    ->description(fn (OperationRun $record): ?string => OperationUxPresenter::surfaceGuidance($record)),
                TextColumn::make('created_at')
                    ->label('Started')
                    ->sortable()
                    ->since(),
            ])
            ->recordUrl(fn (OperationRun $record): ?string => $tenant instanceof Tenant
                ? OperationRunLinks::view($record, $tenant)
                : null)
            ->emptyStateHeading('No operations yet')
            ->emptyStateDescription('Once you run inventory sync, drift generation, or restores, they\'ll show up here.');
    }

    /**
     * @return Builder<OperationRun>
     */
    private function getQuery(): Builder
    {
        $tenant = Filament::getTenant();
        $tenantId = $tenant instanceof Tenant ? $tenant->getKey() : null;

        return OperationRun::query()
            ->when($tenantId, fn (Builder $query) => $query->where('tenant_id', $tenantId))
            ->latest('created_at');
    }
}