ahmido/TenantAtlas
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects 1 Releases Wiki Activity
55aef627aa
TenantAtlas/docs/product/standards
History
ahmido 55aef627aa feat: harden finding governance health surfaces (#197) 
## Summary
- harden findings and finding-exception Filament surfaces so workflow state, governance validity, overdue urgency, and next action are operator-first
- add tenant stats widgets, segmented tabs, richer governance warnings, and baseline/dashboard attention propagation for overdue and lapsed governance states
- add Spec 166 artifacts plus regression coverage for findings, badges, baseline summaries, tenantless operation viewer behavior, and critical table standards

## Verification
- `vendor/bin/sail bin pint --dirty --format agent`
- `vendor/bin/sail artisan test --compact`

## Filament Notes
- Livewire v4.0+ compliance: yes, implementation stays on Filament v5 / Livewire v4 APIs only
- Provider registration: unchanged, Laravel 12 panel/provider registration remains in `bootstrap/providers.php`
- Global search: unchanged in this slice; `FindingExceptionResource` stays not globally searchable, no new globally searchable resource was introduced
- Destructive actions: existing revoke/reject/approve/renew/workflow mutations remain capability-gated and confirmation-gated where already defined
- Asset strategy: no new assets added; existing deploy process remains unchanged, including `php artisan filament:assets` when registered assets are used
- Testing plan delivered: findings list/detail, exception register, dashboard attention, baseline summary, badge semantics, and tenantless operation viewer coverage

Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de>
Reviewed-on: #197
2026-03-28 10:11:12 +00:00
..
filament-actions-ux.md docs: add canonical filament UI standards (#153) 2026-03-08 23:17:37 +00:00
filament-filter-ux.md docs: add canonical filament UI standards (#153) 2026-03-08 23:17:37 +00:00
filament-table-ux.md docs: add canonical filament UI standards (#153) 2026-03-08 23:17:37 +00:00
list-surface-review-checklist.md docs: add canonical filament UI standards (#153) 2026-03-08 23:17:37 +00:00
README.md feat: harden finding governance health surfaces (#197) 2026-03-28 10:11:12 +00:00

README.md

Product Standards

Canonical, living standards that govern all new and modified Filament UI surfaces. Specs reference these standards; they do not redefine them. Guard tests enforce critical constraints automatically.

Last reviewed: 2026-03-27

Standards Index

Standard File Governs
Table UX filament-table-ux.md Column tiers, sort, search, toggle, pagination, persistence, empty states, timestamps, IDs
Filter UX filament-filter-ux.md Filter patterns, persistence, soft-delete, date range, enum sourcing, defaults
Actions UX filament-actions-ux.md Row/bulk/header actions, grouping, destructive safety, inspect affordance
Review Checklist list-surface-review-checklist.md PR/spec checklist for any new or modified list surface

How Standards Are Enforced

  1. Constitution — Principles in .specify/memory/constitution.md govern why we build this way and whether new persistence, abstractions, or semantic frameworks are justified at all.
  2. Standards (this directory) — Concrete rules for how every surface must behave.
  3. Guard tests — Automated Pest tests that fail CI when critical standards are violated.
  4. PR review — The review checklist is checked for every spec or PR that touches a list surface.

When to Update Standards

  • When a spec introduces a new surface type or pattern not yet covered.
  • When a standard proves too rigid or too loose after real usage.
  • When Filament version changes invalidate or enable new native features.

Update the standard first, then adjust implementation to match.

Related Docs

Document Location Purpose
Constitution .specify/memory/constitution.md Permanent principles (PROP-001, BLOAT-001, OPSURF-001, UI-FIL-001, UX-001, Action Surface Contract, RBAC-UX)
Product Principles docs/product/principles.md High-level product decisions
Table Rollout Audit docs/ui/filament-table-standard.md Rollout inventory and implementation state from Spec 125
Action Surface Contract docs/ui/action-surface-contract.md Original action surface reference (now governed by this standard)