TenantAtlas/specs/076-permissions-enterprise-ui/quickstart.md

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.