Saltar a contenido

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-utils para 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

  1. El dominio resuelve la plataforma (bo_domain) o el panel Backoffice.
  2. Los middleware globales aplican locale, sesión, CSRF y cabeceras de seguridad.
  3. Filament resuelve el resource/page y valida acceso con la policy.
  4. La lógica delegada vive en Actions, Services, Schemas y Tables.
  5. Los efectos secundarios se publican como eventos (UserCreated, UserUpdated, TransactionPerformed) después del commit.
  6. 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: comparte id con User; jerarquía con parent/children.
  • Provider, Game, GameCategory, Credential, Banner, Menu, LobbyCategory.
  • Wallet, Transaction, Ticket vienen de vortexplay/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.

Documentación relacionada