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:
- Contexto explícito (
Platform\Utils\Support\PlatformContext). - Tenant de Filament.
- Dominio (
bo_domain), cacheado. 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
currencyen sesión. Usertiene un global scopecurrencyque filtra porregistration_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.