## Summary
Implements and polishes the Platform Ops Runbooks feature (Spec 113) — the operator control plane for safe backfills and data repair from `/system`.
## Changes
### UX Polish (Phase 7 — US4)
- **Filament-native components**: Rewrote `runbooks.blade.php` and `view-run.blade.php` using `<x-filament::section>` instead of raw Tailwind div cards. Cards now render correctly with Filament's built-in borders, shadows and dark mode.
- **System panel theme**: Created `resources/css/filament/system/theme.css` and registered `->viteTheme()` on `SystemPanelProvider`. The system panel previously had no theme CSS registered — Tailwind utility classes weren't compiled for its views, causing the warning icon SVG to expand to full container size.
- **Live scope selector**: Added `->live()` to the scope `Radio` field so "Single tenant" immediately reveals the tenant search dropdown without requiring a Submit first.
### Core Feature (Phases 1–6, previously shipped)
- `/system/ops/runbooks` — runbook catalog, preflight, run with typed confirmation + reason
- `/system/ops/runs` — run history table with status/outcome badges
- `/system/ops/runs/{id}` — run detail view with summary counts, failures, collapsible context
- `FindingsLifecycleBackfillRunbookService` — preflight + execution logic
- AllowedTenantUniverse — scopes tenant picker to non-platform tenants only
- RBAC: `platform.ops.view`, `platform.runbooks.view`, `platform.runbooks.run`, `platform.runbooks.findings.lifecycle_backfill`
- Rate-limited `/system/login` (10/min per IP+username)
- Distinct session cookie for `/system` isolation
## Test Coverage
- 16 tests / 141 assertions — all passing
- Covers: page access, RBAC, preflight, run dispatch, scope selector, run detail, run list
## Checklist
- [x] Filament v5 / Livewire v4 compliant
- [x] Provider registered in `bootstrap/providers.php`
- [x] Destructive actions require confirmation (`->requiresConfirmation()`)
- [x] System panel theme registered (`viteTheme`)
- [x] Pint clean
- [x] Tests pass
Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de>
Reviewed-on: #137
96 lines
2.7 KiB
PHP
96 lines
2.7 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace App\Jobs;
|
|
|
|
use App\Models\OperationRun;
|
|
use App\Services\OperationRunService;
|
|
use App\Services\Runbooks\FindingsLifecycleBackfillRunbookService;
|
|
use App\Services\System\AllowedTenantUniverse;
|
|
use App\Support\OperationRunOutcome;
|
|
use App\Support\OperationRunStatus;
|
|
use Illuminate\Bus\Queueable;
|
|
use Illuminate\Contracts\Queue\ShouldQueue;
|
|
use Illuminate\Foundation\Bus\Dispatchable;
|
|
use Illuminate\Queue\InteractsWithQueue;
|
|
use Illuminate\Queue\SerializesModels;
|
|
|
|
class BackfillFindingLifecycleWorkspaceJob implements ShouldQueue
|
|
{
|
|
use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;
|
|
|
|
public function __construct(
|
|
public readonly int $operationRunId,
|
|
public readonly int $workspaceId,
|
|
) {}
|
|
|
|
public function handle(
|
|
OperationRunService $operationRunService,
|
|
AllowedTenantUniverse $allowedTenantUniverse,
|
|
FindingsLifecycleBackfillRunbookService $runbookService,
|
|
): void {
|
|
$run = OperationRun::query()->find($this->operationRunId);
|
|
|
|
if (! $run instanceof OperationRun) {
|
|
return;
|
|
}
|
|
|
|
if ((int) $run->workspace_id !== $this->workspaceId) {
|
|
return;
|
|
}
|
|
|
|
if ($run->tenant_id !== null) {
|
|
return;
|
|
}
|
|
|
|
$tenantIds = $allowedTenantUniverse
|
|
->query()
|
|
->where('workspace_id', $this->workspaceId)
|
|
->orderBy('id')
|
|
->pluck('id')
|
|
->map(static fn (mixed $id): int => (int) $id)
|
|
->all();
|
|
|
|
$tenantCount = count($tenantIds);
|
|
|
|
$operationRunService->updateRun(
|
|
$run,
|
|
status: OperationRunStatus::Running->value,
|
|
outcome: OperationRunOutcome::Pending->value,
|
|
summaryCounts: [
|
|
'tenants' => $tenantCount,
|
|
'total' => $tenantCount,
|
|
'processed' => 0,
|
|
'updated' => 0,
|
|
'skipped' => 0,
|
|
'failed' => 0,
|
|
],
|
|
);
|
|
|
|
if ($tenantCount === 0) {
|
|
$operationRunService->updateRun(
|
|
$run,
|
|
status: OperationRunStatus::Completed->value,
|
|
outcome: OperationRunOutcome::Succeeded->value,
|
|
);
|
|
|
|
$runbookService->maybeFinalize($run);
|
|
|
|
return;
|
|
}
|
|
|
|
foreach ($tenantIds as $tenantId) {
|
|
if ($tenantId <= 0) {
|
|
continue;
|
|
}
|
|
|
|
BackfillFindingLifecycleTenantIntoWorkspaceRunJob::dispatch(
|
|
operationRunId: (int) $run->getKey(),
|
|
workspaceId: $this->workspaceId,
|
|
tenantId: $tenantId,
|
|
);
|
|
}
|
|
}
|
|
}
|