Arquitectura¶
platform-backoffice es el panel de administración de la plataforma. Está construido con Laravel
12 y Filament 5 y comparte la base PostgreSQL con platform-api.
Vista general¶
Navegador
-> Cloudflare + ALB
-> FrankenPHP / Octane
-> Laravel 12
-> Filament (Admin y BackOffice)
-> Policies + Spatie Permission
-> Modelos propios + vortexplay/platform-utils
-> PostgreSQL, Redis, Athena, S3, SQS
Stack¶
- PHP 8.2+ / Laravel 12.
- Filament 5 en modo SPA.
- PostgreSQL, esquema
site. - Redis para sesiones y caché.
- Octane sobre FrankenPHP.
- AWS Athena para reportes.
- SQS para actualizaciones de saldo y alertas.
- S3 para assets.
vortexplay/platform-utilspara modelos, wallets, tickets y contexto de plataforma.
Dos paneles¶
| Panel | URL | Alcance |
|---|---|---|
| Admin | https://admin.vortexplay.dev | Cliente, agentes y operadores; multi-tenant |
| Backoffice | https://backoffice.vortexplay.dev | Administración interna; global |
Comparten código y base de datos, pero tienen rutas, permisos, middleware y alcance diferentes. Ver Paneles.
Ciclo de una petición¶
- El dominio resuelve la plataforma (
bo_domain) o el panel Backoffice. - Los middleware globales aplican locale, sesión, CSRF y cabeceras de seguridad.
- Filament resuelve el resource/page y valida acceso con la policy.
- La lógica delegada vive en
Actions,Services,SchemasyTables. - Los efectos secundarios se publican como eventos (
UserCreated,UserUpdated,TransactionPerformed) después del commit. - Las alertas se encolan y los cambios de caché se invalidan por observers/servicios.
Organización del código¶
app/
├── Filament/
│ ├── Admin/ # Panel para clientes y agentes
│ ├── BackOffice/ # Panel interno
│ ├── Forms/ # Componentes reutilizables
│ └── Concerns/ # Traits compartidos de Filament
├── Models/ # Modelos propios del BackOffice
├── Policies/ # Permisos por recurso
├── Services/ # Athena, caché, alertas, IP, niveles
├── Livewire/ # Componentes Livewire
├── Events/ # Eventos de dominio
├── Listeners/ # Auditoría, sesión y alertas
├── Jobs/ # Colas
├── Observers/ # Invalidación de caché y alertas
├── Enums/ # Tipos y estados
├── Rules/ # Validaciones propias
├── Resolvers/ # Datos de auditoría
└── Providers/ # Service providers y paneles
Los recursos Filament delegan en Schemas y Tables. La lógica de acciones vive en clases con
AsAction. El detalle está en Mapa del código.
Acceso a datos¶
El BackOffice no consume platform-api. Cada acción va directamente al servicio que
corresponde:
- PostgreSQL para CRUD, usuarios, wallets y transacciones.
- Athena para reportes.
- Redis para sesiones y caché.
- SQS para publicar actualizaciones de saldo y alertas.
- S3 para imágenes y assets.
Ver Fuentes de datos.
Modelos importantes¶
Platform: tenant, dominio del BackOffice y configuración.User: mismo modelo para agentes y jugadores.Agent: comparteidconUser; jerarquía conparent/children.Provider,Game,GameCategory,Credential,Banner,Menu,LobbyCategory.Wallet,Transaction,Ticketvienen devortexplay/platform-utils.
Seguridad, auditoría y alertas¶
- Cabeceras HTTP y CSP en modo report-only: Seguridad.
- Auditoría con OwenIt Auditing y resolvers de IP, URL y plataforma.
- Policies por recurso y permisos por panel/plataforma: Policies y permisos.
- Alertas operativas por Telegram: Alertas.