superadmin-tenant-onboarding

name	superadmin-tenant-onboarding
description	Use when implementing or changing superadmin flows for tenant creation, owner assignment, tenant lifecycle, status changes, and initial customer onboarding.

Superadmin Tenant Onboarding

Use this skill for the first lifecycle of a salon inside the platform.

Read first

1. docs/memory/active-context.md
2. docs/blueprints/development-roadmap.md
3. docs/decisions/ADR-0002-multi-tenancy-and-panels.md
4. docs/engineering/commit-and-github-workflow.md

Workflow

1. Confirm the workflow belongs to superadmin.
2. Treat tenant creation as a cross-model operation, not a simple CRUD callback.
3. Create or update explicit action classes for:
   • tenant creation
   • initial owner creation
   • role assignment
   • tenant suspension/reactivation if applicable
4. Keep the UI in Filament and the business rule in Laravel actions.
5. Add tests for:
   • superadmin access
   • tenant user denied access
   • owner role assignment
   • correct tenant ownership on created records

Rules

• do not trust tenant ids from forms
• do not create owner users without role assignment
• do not couple onboarding logic to table/resource classes more than necessary
• keep onboarding auditable and easy to extend later with plans or billing