ahmido
bd6df1f343
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
49 lines
1.3 KiB
Markdown
49 lines
1.3 KiB
Markdown
# 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)
|
|
|
|
1) Centralize operation label + UX copy
|
|
- Create/update catalog/presenter so widget + notification + toast share strings.
|
|
|
|
2) Enforce queued vs terminal feedback split
|
|
- Toast for `queued`
|
|
- Widget for `queued|running`
|
|
- DB notification for terminal states only
|
|
|
|
3) Enforce canonical “View run” link
|
|
- All surfaces link to Monitoring → Operations → Run Detail.
|
|
|
|
4) 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`
|