TenantAtlas/specs/067-rbac-troubleshooting/quickstart.md

Quickstart — RBAC Troubleshooting & Tenant UI Bugfix Pack v1

Prereqs

• Docker running
• Laravel Sail dependencies installed

Run locally

• Start containers: vendor/bin/sail up -d
• Run targeted tests (after implementation):
  • vendor/bin/sail artisan test --compact tests/Feature/Rbac/
  • (guard) vendor/bin/sail artisan test --compact tests/Feature/Guards/NoAdHocFilamentAuthPatternsTest.php
• Format: vendor/bin/sail bin pint --dirty

Manual smoke (after implementation)

1. Sign in to /admin.
2. Pick a tenant scope via the tenant menu.
3. As a read-only member:
   • Tenant view page shows Edit/Deactivate disabled with tooltip.
   • Attempting to force-execute mutations still fails server-side.
4. Archive a tenant, then:
   • Member can still open tenant view and sees an Archived banner.
   • Non-member gets 404 for tenant scope URLs.

Notes

• Filament v5 requires Livewire v4.0+ (this repo is already on Livewire v4).
• Panel providers in Laravel 11+ are registered in bootstrap/providers.php (this repo follows that convention).