TenantAtlas/docs/ui-ux-enterprise-audit/page-reports/ui-007-alerts.md
ahmido 8a889a863e Spec 323: add tenantial enterprise UI audit foundation (#383)
## Summary
- add the Spec 323 Tenantial enterprise UI audit foundation package
- add the UI/UX audit registry artifacts, templates, and supporting brand context placeholder
- update Spec Kit prompts/templates plus PR fast-feedback guardrails for ongoing UI productization coverage

## Scope
- docs-first audit foundation only
- no runtime Laravel, Filament, Livewire, route, auth, or database behavior changes intended

## Validation
- [x] `git diff --check`
- [ ] application test suite run

## Notes
- primary spec: `specs/323-tenantial-enterprise-ui-audit-foundation/`
- this branch also updates `.gitea/pull_request_template.md`, `.gitea/workflows/test-pr-fast-feedback.yml`, and `scripts/check-ui-productization-coverage` to make the coverage gate durable for future UI work

Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de>
Reviewed-on: #383
2026-05-17 17:49:54 +00:00

2.1 KiB

UI-007 Alerts / Alert Deliveries

Field Value
Route /admin/alerts and /admin/alerts/alert-deliveries
Source AlertsCluster, AlertDeliveryResource
Area / scope Monitoring / workspace
Archetype Operations / Monitoring
Design depth Strategic Surface
Repo truth repo-verified
Screenshot ../screenshots/desktop/ui-007-alerts.png
Browser status Opening /admin/alerts landed on Alert Deliveries.

First Five Seconds

The surface currently reads more like a table-backed delivery register than a decision-first alert center. That may be correct for deliveries, but the broader alert center needs a clearer overview/state pattern.

Productization Review

  • Decision-first: weak for alert overview, acceptable for delivery history.
  • Evidence-first: delivery records are explicit.
  • Context: workspace hub; environment filter should be visible when used.
  • Customer/auditor safety: not customer-facing by default.
  • Diagnostics: delivery failure detail should not dominate alert outcome.

Information Inventory

Default content should distinguish alert rules, destinations, deliveries, failures, and required follow-up. Alert delivery rows should show delivery outcome, target, event type, environment attribution, and retry/diagnostic state.

Dangerous Actions

Alert destination enable/disable, destination delete, and test-send actions are high-impact enough to require confirmation/audit review in later specs.

Scores

IA Density User Clarity Sellability Disclosure Hierarchy DS Fit A11y Responsive Components UX Writing Perf
3 4 3 3 3 3 4 3 3 4 3 4

Top Issues

  1. /admin/alerts needs an explicit alert-center decision model.
  2. Delivery table and configuration surfaces should not share the same design priority.
  3. Environment filtering should stay clear and chip-backed.

Target Direction

P1 strategic target for Alert Center, domain pattern for deliveries/rules/destinations.