TenantAtlas/specs/076-permissions-enterprise-ui/quickstart.md
ahmido 05a604cfb6 Spec 076: Tenant Required Permissions (enterprise remediation UX) (#92)
Implements Spec 076 enterprise remediation UX for tenant required permissions.

Highlights
- Above-the-fold overview (impact + counts) with missing-first experience
- Feature-based grouping, filters/search, copy-to-clipboard for missing app/delegated permissions
- Tenant-scoped deny-as-not-found semantics; DB-only viewing
- Centralized badge semantics (no ad-hoc status mapping)

Testing
- Feature tests for default filters, grouping, copy output, and non-member 404 behavior.

Integration
- Adds deep links from verification checks to the Required permissions page.

Co-authored-by: Ahmed Darrazi <ahmeddarrazi@MacBookPro.fritz.box>
Reviewed-on: #92
2026-02-05 22:08:51 +00:00

1.2 KiB

Quickstart — Spec 076 (Permissions Enterprise UI)

Local run (Sail)

  • Start: vendor/bin/sail up -d
  • App: vendor/bin/sail open

Where to click

  • In the Admin panel (/admin), choose a workspace + tenant.
  • Open the tenant-scoped “Required permissions” page (/admin/t/{tenant}/...).
  • In the Managed Tenant Onboarding Wizard → “Verify access”, start verification and review the clustered checks.

Expected UX

  • Overview above the fold:
    • Overall status badge (Ready / Needs attention / Blocked)
    • Impact summary by feature
    • Copy missing application / delegated actions
  • Details matrix:
    • Missing-first default
    • Status/type/feature filters + substring search

Tests (minimal, targeted)

Run only tests relevant to Spec 076 changes:

  • vendor/bin/sail artisan test --compact --filter=RequiredPermissions
  • If you add a dedicated test file, run it directly:
    • vendor/bin/sail artisan test --compact tests/Feature/RequiredPermissionsTest.php

Formatting

  • vendor/bin/sail bin pint --dirty

Deploy notes

  • No new assets expected (Blade/Livewire only).
  • If any Filament assets are registered later, ensure deployment runs php artisan filament:assets.