Saltar a contenido

Multi-tenant

Qué es un tenant aquí

El tenant es Platform. Cada plataforma tiene su dominio de BackOffice (bo_domain), sus usuarios, sus monedas, sus proveedores, sus juegos y su configuración.

El panel Admin es multi-tenant. El panel Backoffice es global.

Resolución del tenant

PlatformContext::id() resuelve la plataforma en este orden:

  1. Contexto explícito (Platform\Utils\Support\PlatformContext).
  2. Tenant de Filament.
  3. Dominio (bo_domain), cacheado.
  4. auth()->user()->platform_id.

El dominio se registra en AppServiceProvider:

PlatformContext::resolveDomainUsing(
    fn (string $domain) => Platform::where('bo_domain', $domain)->value('id')
);

Si el dominio no coincide con una plataforma, el contexto queda null y las consultas que dependen de plataforma deben fallar o filtrar explícitamente.

Filament

  • tenant(Platform::class, ownershipRelationship: 'platform').
  • tenantDomain('{tenant}').
  • tenantRoutePrefix(false).
  • Los resources del Admin quedan automáticamente limitados al tenant.
  • Los resources del Backoffice usan $isScopedToTenant = false.

Permisos por plataforma

Spatie Permission usa teams con team_foreign_key = platform_id.

  • Admin: setPermissionsTeamId(PlatformContext::id()).
  • Backoffice: setPermissionsTeamId(null).

Esto permite que el mismo usuario tenga permisos distintos según la plataforma y el panel.

Moneda

El BackOffice trabaja por moneda:

  • En login se guarda currency en sesión.
  • User tiene un global scope currency que filtra por registration_currency, excepto el propio usuario autenticado y las rutas de autenticación.
  • Reportes, wallets y consultas usan session('currency').
  • La moneda se cambia desde el selector de cabecera.

No rompas este filtrado: es parte del contrato de datos.

Reglas prácticas

  • Toda consulta de dominio debe filtrar por plataforma y, cuando aplique, por moneda y red de agentes.
  • No uses ::all() sin scope.
  • Un cambio en el panel Admin debe probarse con al menos dos plataformas o con un usuario sin tenant.