ahmido bd6df1f343 055-ops-ux-rollout (#64 )

Kurzbeschreibung

Implementiert Feature 055 — Ops‑UX Constitution Rollout v1.3.0.
Behebt: globales BulkOperationProgress-Widget benötigt keinen manuellen Refresh mehr; ETA/Elapsed aktualisieren korrekt; Widget verschwindet automatisch.
Verbesserungen: zuverlässiges polling (Alpine factory + Livewire fallback), sofortiger Enqueue‑Signal-Dispatch, Failure‑Message‑Sanitization, neue Guard‑ und Regressionstests, Specs/Tasks aktualisiert.
Was geändert wurde (Auszug)

InventoryLanding.php
bulk-operation-progress.blade.php
OperationUxPresenter.php
SyncRestoreRunToOperationRun.php
PolicyResource.php
PolicyVersionResource.php
RestoreRunResource.php
tests/Feature/OpsUx/* (PollerRegistration, TerminalNotificationFailureMessageTest, CanonicalViewRunLinksTest, OperationCatalogCoverageTest, UnknownOperationTypeLabelTest)
InventorySyncButtonTest.php
tasks.md
Tests

Neue Tests hinzugefügt; php artisan test --group=ops-ux lokal grün (alle relevanten Tests laufen).
How to verify manually

Auf Branch wechseln: 055-ops-ux-rollout
In Filament: Inventory → Sync (oder relevante Bulk‑Aktion) auslösen.
Beobachten: Progress‑Widget erscheint sofort, ETA/Elapsed aktualisiert, Widget verschwindet nach Fertigstellung ohne Browser‑Refresh.
Optional: ./vendor/bin/sail exec app php artisan test --filter=OpsUx oder php artisan test --group=ops-ux
Besonderheiten / Hinweise

Einzelne, synchrone Policy‑Actions (ignore/restore/PolicyVersion single archive/restore/forceDelete) sind absichtlich inline und erzeugen kein OperationRun. Bulk‑Aktionen und restore.execute werden als Runs modelliert. Wenn gewünscht, kann ich die inline‑Actions auf OperationRunService umstellen, damit sie in Monitoring → Operations sichtbar werden.
Remote: Branch ist bereits gepusht (origin/055-ops-ux-rollout). PR kann in Gitea erstellt werden.
Links

Specs & tasks: tasks.md
Monitoring page: Operations.php

Co-authored-by: Ahmed Darrazi <ahmeddarrazi@adsmac.local>
Reviewed-on: #64

2026-01-18 14:50:15 +00:00

1.3 KiB

Raw Blame History

Quickstart — Ops-UX Constitution Rollout (v1.3.0 Alignment) (055)

This feature is a repo-wide migration. It standardizes operation feedback across:

Toast (queued only)
Progress widget (queued/running only)
DB notification (terminal only)

Dev setup

Use Sail-first:

./vendor/bin/sail up -d
./vendor/bin/sail artisan migrate

Key places in the codebase

Operation runs table: operation_runs
Monitoring UI: Filament resources/pages for operation runs
Existing widget: Livewire BulkOperationProgress injected via Filament render hook
Canonical run links helper: App\Support\OperationRunLinks

What to change (high level)

Centralize operation label + UX copy

Create/update catalog/presenter so widget + notification + toast share strings.

Enforce queued vs terminal feedback split

Toast for queued
Widget for queued|running
DB notification for terminal states only

Enforce canonical “View run” link

All surfaces link to Monitoring → Operations → Run Detail.

Metrics normalization

Use summary_counts only.
Apply whitelist + integer normalization.

How to validate

Run targeted tests:

./vendor/bin/sail artisan test --group=ops-ux

Then run Pint:

./vendor/bin/pint --dirty

1.3 KiB Raw Blame History