Saltar a contenido

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-utils para modelos, wallets, tickets y contexto de plataforma.

Cómo leer esta documentación

  1. Empieza por Arquitectura y Paneles.
  2. Para ubicar una clase, usa el Mapa del código o el Inventario.
  3. Para saber qué hace cada recurso, página, acción o servicio, entra en Referencia.
  4. Para flujos de negocio, entra en Funcionalidades.
  5. 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:clear ni Cache::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