ahmido
3c3daae405
## Summary - introduce a shared operator outcome taxonomy with semantic axes, severity bands, and next-action policy - apply the taxonomy to operations, evidence/review completeness, baseline semantics, and restore semantics - harden badge rendering, tenant-safe filtering/search behavior, and operator-facing summary/notification wording - add the spec kit artifacts, reference documentation, and regression coverage for diagnostic-vs-primary state handling ## Testing - focused Pest coverage for taxonomy registry and badge guardrails - operations presentation and notification tests - evidence, baseline, restore, and tenant-scope regression tests ## Notes - Livewire v4.0+ compliance is preserved in the existing Filament v5 stack - panel provider registration remains unchanged in bootstrap/providers.php - no new globally searchable resource was added; adopted resources remain tenant-safe and out of global search where required - no new destructive action family was introduced; existing actions keep their current authorization and confirmation behavior - no new frontend asset strategy was introduced; existing deploy flow with filament:assets remains unchanged Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de> Reviewed-on: #186
88 lines
3.7 KiB
PHP
88 lines
3.7 KiB
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 => ($tenant instanceof Tenant) && ActiveRuns::existForTenant($tenant) ? '10s' : null)
|
|
->defaultSort('created_at', 'desc')
|
|
->paginated(\App\Support\Filament\TablePaginationProfiles::widget())
|
|
->columns([
|
|
TextColumn::make('short_id')
|
|
->label('Run')
|
|
->state(fn (OperationRun $record): string => '#'.$record->getKey())
|
|
->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)
|
|
->tooltip(fn (OperationRun $record): string => OperationCatalog::label((string) $record->type)),
|
|
TextColumn::make('status')
|
|
->badge()
|
|
->sortable()
|
|
->toggleable(isToggledHiddenByDefault: true)
|
|
->formatStateUsing(BadgeRenderer::label(BadgeDomain::OperationRunStatus))
|
|
->color(BadgeRenderer::color(BadgeDomain::OperationRunStatus))
|
|
->icon(BadgeRenderer::icon(BadgeDomain::OperationRunStatus))
|
|
->iconColor(BadgeRenderer::iconColor(BadgeDomain::OperationRunStatus)),
|
|
TextColumn::make('outcome')
|
|
->badge()
|
|
->sortable()
|
|
->formatStateUsing(BadgeRenderer::label(BadgeDomain::OperationRunOutcome))
|
|
->color(BadgeRenderer::color(BadgeDomain::OperationRunOutcome))
|
|
->icon(BadgeRenderer::icon(BadgeDomain::OperationRunOutcome))
|
|
->iconColor(BadgeRenderer::iconColor(BadgeDomain::OperationRunOutcome))
|
|
->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');
|
|
}
|
|
}
|