Summary Kurz: Implementiert Feature 054 — canonical OperationRun-flow, Monitoring UI, dispatch-safety, notifications, dedupe, plus small UX safety clarifications (RBAC group search delegated; Restore group mapping DB-only). What Changed Core service: OperationRun lifecycle, dedupe and dispatch helpers — OperationRunService.php. Model + migration: OperationRun model and migration — OperationRun.php, 2026_01_16_180642_create_operation_runs_table.php. Notifications: queued + terminal DB notifications (initiator-only) — OperationRunQueued.php, OperationRunCompleted.php. Monitoring UI: Filament list/detail + Livewire pieces (DB-only render) — OperationRunResource.php and related pages/views. Start surfaces / Jobs: instrumented start surfaces, job middleware, and job updates to use canonical runs — multiple app/Jobs/* and app/Filament/* updates (see tests for full coverage). RBAC + Restore UX clarifications: RBAC group search is delegated-Graph-based and disabled without delegated token; Restore group mapping remains DB-only (directory cache) and helper text always visible — TenantResource.php, RestoreRunResource.php. Specs / Constitution: updated spec & quickstart and added one-line constitution guideline about Graph usage: spec.md quickstart.md constitution.md Tests & Verification Unit / Feature tests added/updated for run lifecycle, notifications, idempotency, and UI guards: see tests/Feature/* (notably OperationRunServiceTest, MonitoringOperationsTest, OperationRunNotificationTest, and various Filament feature tests). Full test run locally: ./vendor/bin/sail artisan test → 587 passed, 5 skipped. Migrations Adds create_operation_runs_table migration; run php artisan migrate in staging after review. Notes / Rationale Monitoring pages are explicitly DB-only at render time (no Graph calls). Start surfaces enqueue work only and return a “View run” link. Delegated Graph access is used only for explicit user actions (RBAC group search); restore mapping intentionally uses cached DB data only to avoid render-time Graph calls. Dispatch wrapper marks runs failed immediately if background dispatch throws synchronously to avoid misleading “queued” states. Upgrade / Deploy Considerations Run migrations: ./vendor/bin/sail artisan migrate. Background workers should be running to process queued jobs (recommended to monitor queue health during rollout). No secret or token persistence changes. PR checklist Tests updated/added for changed behavior Specs updated: 054-unify-runs-suitewide docs + quickstart Constitution note added (.specify) Pint formatting applied Co-authored-by: Ahmed Darrazi <ahmeddarrazi@adsmac.local> Reviewed-on: #63
126 lines
4.3 KiB
PHP
126 lines
4.3 KiB
PHP
<?php
|
|
|
|
namespace App\Filament\Pages\Monitoring;
|
|
|
|
use App\Models\OperationRun;
|
|
use BackedEnum;
|
|
use Filament\Facades\Filament;
|
|
use Filament\Forms\Components\DatePicker;
|
|
use Filament\Forms\Concerns\InteractsWithForms;
|
|
use Filament\Forms\Contracts\HasForms;
|
|
use Filament\Pages\Page;
|
|
use Filament\Tables\Columns\TextColumn;
|
|
use Filament\Tables\Concerns\InteractsWithTable;
|
|
use Filament\Tables\Contracts\HasTable;
|
|
use Filament\Tables\Filters\Filter;
|
|
use Filament\Tables\Filters\SelectFilter;
|
|
use Filament\Tables\Table;
|
|
use Illuminate\Database\Eloquent\Builder;
|
|
use UnitEnum;
|
|
|
|
class Operations extends Page implements HasForms, HasTable
|
|
{
|
|
use InteractsWithForms;
|
|
use InteractsWithTable;
|
|
|
|
protected static bool $isDiscovered = false;
|
|
|
|
protected static string|BackedEnum|null $navigationIcon = 'heroicon-o-queue-list';
|
|
|
|
protected static string|UnitEnum|null $navigationGroup = 'Monitoring';
|
|
|
|
protected static ?string $title = 'Operations';
|
|
|
|
// Must be non-static
|
|
protected string $view = 'filament.pages.monitoring.operations';
|
|
|
|
public function table(Table $table): Table
|
|
{
|
|
return $table
|
|
->query(
|
|
OperationRun::query()
|
|
->where('tenant_id', Filament::getTenant()->id)
|
|
->latest('created_at')
|
|
)
|
|
->columns([
|
|
TextColumn::make('type')
|
|
->searchable()
|
|
->sortable(),
|
|
|
|
TextColumn::make('status')
|
|
->badge()
|
|
->colors([
|
|
'secondary' => 'queued',
|
|
'warning' => 'running',
|
|
'success' => 'completed',
|
|
]),
|
|
|
|
TextColumn::make('outcome')
|
|
->badge()
|
|
->colors([
|
|
'gray' => 'pending',
|
|
'success' => 'succeeded',
|
|
'warning' => 'partially_succeeded',
|
|
'danger' => 'failed',
|
|
'secondary' => 'cancelled',
|
|
]),
|
|
|
|
TextColumn::make('initiator_name')
|
|
->label('Initiator')
|
|
->searchable(),
|
|
|
|
TextColumn::make('created_at')
|
|
->dateTime()
|
|
->sortable()
|
|
->label('Started'),
|
|
|
|
TextColumn::make('duration')
|
|
->getStateUsing(function (OperationRun $record) {
|
|
if ($record->started_at && $record->completed_at) {
|
|
return $record->completed_at->diffForHumans($record->started_at, true);
|
|
}
|
|
|
|
return '-';
|
|
}),
|
|
])
|
|
->filters([
|
|
SelectFilter::make('outcome')
|
|
->options([
|
|
'succeeded' => 'Succeeded',
|
|
'partially_succeeded' => 'Partially Succeeded',
|
|
'failed' => 'Failed',
|
|
'cancelled' => 'Cancelled',
|
|
'pending' => 'Pending',
|
|
]),
|
|
|
|
SelectFilter::make('type')
|
|
->options(
|
|
fn () => OperationRun::where('tenant_id', Filament::getTenant()->id)
|
|
->distinct()
|
|
->pluck('type', 'type')
|
|
->toArray()
|
|
),
|
|
|
|
Filter::make('created_at')
|
|
->form([
|
|
DatePicker::make('created_from'),
|
|
DatePicker::make('created_until'),
|
|
])
|
|
->query(function (Builder $query, array $data): Builder {
|
|
return $query
|
|
->when(
|
|
$data['created_from'],
|
|
fn (Builder $query, $date) => $query->whereDate('created_at', '>=', $date),
|
|
)
|
|
->when(
|
|
$data['created_until'],
|
|
fn (Builder $query, $date) => $query->whereDate('created_at', '<=', $date),
|
|
);
|
|
}),
|
|
])
|
|
->actions([
|
|
// View action handled by opening a modal or side-peek
|
|
]);
|
|
}
|
|
}
|