Skip to main content

Multi-Tenancy Architecture

Understanding how tenant scoping works in the ClubVIP platform.

Overview​

Multi-tenancy allows multiple independent organizations (tenants) to use the same platform while keeping their data completely separate.

Key Concepts​

Tenant: The top-level organizational entity representing a single club operator.

Tenant Scoping: All data is automatically filtered by tenant - users can only see data from their own tenant.

Cross-Tenant Access: Only PLATFORM_ADMIN can access multiple tenants using the tenant selector.

How It Works​

Backend Enforcement:

  • All API requests include tenant context
  • TenantGuard middleware enforces scoping
  • No way for users to access other tenants' data

Location Scoping:

  • LOCATION_ADMIN users see only their assigned locations
  • TENANT_ADMIN sees all locations in their tenant
  • Customer visibility based on location visit history