# Quickstart: Filament v5.2.1 Upgrade Verification

## Preconditions

- Baseline on `dev` is green (tests passing) before applying the upgrade.
- Local environment uses Sail.

## Local verification (early signal)

1. Bring up services: `vendor/bin/sail up -d`
2. Install dependencies from lock: `vendor/bin/sail composer install`
3. Run automated gate:
   - Full suite: `vendor/bin/sail artisan test --compact`
   - Frontend build: `vendor/bin/sail npm run build`

## Staging verification (required gate)

Run the UI smoke on staging after deploying the upgrade artifact.

Must-pass smoke (time-box ≤ 10 minutes):

- Auth: login/logout for Admin panel; verify System panel access if present
- Navigation: load key sections in `/admin` and `/system` without errors
- Tenancy behavior: verify no unexpected tenant scoping/registration in `/system`; verify tenant context works as expected in `/admin`
- Tables:
  - search + filters
  - bulk actions
  - “Select all” (including correctness with any non-selectable rows)
- Modals: create/edit, confirmation dialogs

## Rollback

Primary rollback mechanism:

- Revert `composer.lock` (and any Filament constraint change in `composer.json`) to the last known-good state.
- Redeploy the prior known-good artifact.

Success criteria:

- Tests + build return to green
- Staging UI smoke passes again
