TenantAtlas/docs/ui-ux-enterprise-audit/page-reports/ui-004-governance-inbox.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

1.9 KiB

UI-004 Governance Inbox

Field Value
Route /admin/governance/inbox
Source GovernanceInbox
Area / scope Governance / workspace
Archetype Findings / Inbox
Design depth Strategic Surface
Repo truth repo-verified
Screenshot ../screenshots/desktop/ui-004-governance-inbox.png
Browser status Reached through local workspace route.

First Five Seconds

The page is positioned as a decision queue. It needs to make the human-in-the-loop moment unmistakable: what is pending, why it matters, who owns it, and what should be done next.

Productization Review

  • Decision-first: strong concept, needs sharper first action.
  • Evidence-first: should link to finding, review, run, and proof artifacts.
  • Context: workspace hub.
  • Customer/auditor safety: operator-facing, but outputs may feed customer review.
  • Diagnostics: should remain lower than recommendation and evidence basis.

Information Inventory

Default content should include pending decision type, impact, environment scope, evidence basis, owner, age/SLA, and recommended next action. Any raw reason ownership or payload data should be hidden.

Dangerous Actions

Potential approve, reject, accept risk, close, assign, or escalate actions. Target handling requires explicit confirmation and audit posture per action family.

Scores

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

Top Issues

  1. Needs one dominant queue-clearing action model.
  2. Decision evidence and status dimensions must be separated.
  3. Customer-safe downstream wording needs review.

Target Direction

P0 individual target mockup. This should become the central operator decision surface rather than another technical list.