ahmido/TenantAtlas
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects 1 Releases Wiki Activity
807d574d31
TenantAtlas/docs/product/standards/README.md
ahmido 807d574d31 feat: add tenant governance aggregate contract and action surface follow-ups (#199) 
## Summary
- amend the operator UI constitution and related SpecKit templates for the new UI/UX governance rules
- add Spec 168 artifacts plus the tenant governance aggregate implementation used by the tenant dashboard, banner, and baseline compare landing surfaces
- normalize Filament action surfaces around clickable-row inspection, grouped secondary actions, and explicit action-surface declarations across enrolled resources and pages
- fix post-suite regressions in membership cache priming, finding workflow state refresh, tenant review derived-state invalidation, and tenant-bound backup-set related navigation

## Commit Series
- `docs: amend operator UI constitution`
- `spec: add tenant governance aggregate contract`
- `feat: add tenant governance aggregate contract`
- `refactor: normalize filament action surfaces`
- `fix: resolve post-suite state regressions`

## Testing
- `vendor/bin/sail artisan test --compact`
- Result: `3176 passed, 8 skipped (17384 assertions)`

## Notes
- Livewire v4 / Filament v5 stack remains unchanged
- no provider registration changes; `bootstrap/providers.php` remains the relevant location
- no new global-search resources or asset-registration changes in this branch

Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de>
Reviewed-on: #199
2026-03-29 21:14:17 +00:00

2.3 KiB
Raw Blame History

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-28

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, UI-CONST-001, UI-SURF-001, UI-HARD-001, UI-EX-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)