Platform BackOffice¶
Documentación técnica del BackOffice de VortexPlay. Está pensada para que cualquier programador pueda responder: qué es cada pieza, para qué sirve, quién la usa y qué reglas de negocio no debe romper.
Qué es¶
Aplicación Laravel 12 + Filament 5 que sirve dos paneles sobre la misma base de datos:
| Panel | Audiencia | Alcance |
|---|---|---|
| Admin | Cliente, agentes y operadores | Multi-tenant por Platform |
| Backoffice | Administración interna | Global, sin tenant |
Comparten código, modelos, policies, despliegue y base PostgreSQL. Las diferencias están en Paneles.
Stack¶
- PHP 8.2+ / Laravel 12.
- Filament 5 en modo SPA.
- PostgreSQL, esquema
site. - Redis para sesiones y caché.
- Octane sobre FrankenPHP.
- Athena para reportes, S3 para assets y SQS para colas.
vortexplay/platform-utilspara modelos, wallets, tickets y contexto de plataforma.
Cómo leer esta documentación¶
- Empieza por Arquitectura y Paneles.
- Para ubicar una clase, usa el Mapa del código o el Inventario.
- Para saber qué hace cada recurso, página, acción o servicio, entra en Referencia.
- Para flujos de negocio, entra en Funcionalidades.
- Para desplegar o diagnosticar, entra en Operación.
Reglas que no se deben romper¶
- Las wallets y transacciones se operan con
Platform\Utils\Wallets; nunca se modifican saldos a mano fuera de los flujos permitidos. - El filtrado por moneda (
session('currency')) y por red de agentes es parte del contrato. - Los recursos validan acceso con policies y permisos por panel/plataforma.
- No ejecutar
cache:clearniCache::flush()contra Redis: borra sesiones activas. - Las alertas se emiten después del commit y un fallo de Telegram no debe romper la operación.
Enlaces¶
- Repositorio:
VortexPlayDev/platform-backoffice. - Hub de documentación: VortexPlay Docs.
- Convenciones comunes: Convenciones.