Cliente registrado
Cuenta, billetera de tiempo, movimientos y sesiones asociadas al cliente.
Gaming Center
Management System
Un sistema para centralizar la administración de estaciones, clientes y sesiones de uso en gaming centers.
- Rol
- Análisis, diseño e implementación
- Áreas
- Backend, frontend y Station Agent
- Estado
- Desarrollo incremental
Visual del productoCaptura real pendiente
La demostración visual se incorporará cuando el flujo completo esté preparado con datos de prueba.
01
Contexto
El problema que organiza el proyecto
La operación de un gaming center reúne varias tareas que dependen unas de otras: conocer el estado de cada equipo, administrar clientes, asignar tiempo de uso y seguir sesiones activas.
GCMS nace para reunir esos flujos en un sistema con una fuente de información común, evitando que la operación dependa de acciones aisladas o de mantener el estado manualmente.
02
Producto
Una operación centralizada, con dos tipos de sesión
El sistema distingue entre clientes registrados, que mantienen tiempo disponible en una billetera, e invitados, que utilizan tiempo autorizado para una visita específica.
La sala administrativa permite revisar estaciones y realizar operaciones, mientras el backend conserva la autoridad sobre el estado real de las sesiones.
Sesión de invitado
Tiempo prepago para una visita, sin crear usuario, billetera ni movimientos de saldo.
03
Funcionamiento
Del panel administrativo a la estación
01SalaEl administrador inicia la operación
→02BackendValida y guarda el estado autoritativo
→03WebSocketPublica el evento a la estación
→04Station AgentSincroniza el estado local
→05UIMuestra la sesión y su tiempo
El contador continúa localmente, pero la sesión del backend sigue siendo la fuente de verdad. Al reconectarse, el agente puede reconstruir su estado desde el snapshot vigente.
04
Ingeniería
Decisiones que sostienen el comportamiento
El backend define el estado
La estación no decide por sí sola si una sesión existe. Recibe eventos y puede recuperar el estado vigente al volver a conectarse.
REGISTERED y GUEST son flujos distintos
Las reglas de la base de datos impiden combinaciones incoherentes entre el tipo de sesión, el cliente y su billetera.
Eventos repetidos no duplican acciones
El procesamiento idempotente permite ignorar eventos duplicados o antiguos sin alterar una sesión válida.
La conexión puede interrumpirse
La sincronización contempla reconexión y reconstrucción de estado, en lugar de asumir una conexión permanente.
05
Validación
Evidencia registrada durante el desarrollo
299 pruebas aprobadas
Suite completa ejecutada sin fallos en el checkpoint de certificación del Station Agent.
Tests y build Release
El servicio, sus contratos y la interfaz fueron comprobados mediante pruebas y compilación Release.
Certificación prolongada: PASS
Se verificó el funcionamiento sostenido del agente y su consumo de recursos durante juegos.
Comparación con CS2: PASS
Se comparó el comportamiento del equipo con y sin el agente activo en una estación de prueba.
Reconexión y reinicio
El diseño contempla recuperar la sesión activa desde el backend sin duplicar ni perder el estado.
Frontend lint y build
El panel administrativo completó sus validaciones estáticas y su compilación de producción.
Estos resultados corresponden a checkpoints técnicos del desarrollo. No representan métricas comerciales ni uso en producción.
06
Stack
Tecnologías elegidas para cada responsabilidad
Backend
Python · FastAPI · PostgreSQL · SQLAlchemy
Panel administrativo
React · TypeScript
Comunicación
REST · WebSockets · IPC
Station Agent
.NET 10 · servicio e interfaz para Windows
Calidad
Pytest · pruebas .NET · lint · builds Release
Proceso
Scrum · Jira · Git · GitHub · revisión por checkpoints
07
Estado actual
Lo construido y lo que todavía continúa
Disponible
- Administración de estaciones y clientes
- Sesiones registradas y de invitados
- Operaciones de inicio, extensión y cierre
- Comunicación en tiempo real con Station Agent
- Sincronización y recuperación de estado
- Sala operativa en el frontend
En desarrollo
- Integración completa de todos los flujos desde Sala
- Política al finalizar el tiempo autorizado
- Control del entorno de Windows
- Inicio autónomo para clientes registrados
- Preparación de una demo pública
Próximo paso