volley-overlay-control
Aplicación auto-alojable para control de marcadores de voleibol con frontend React y backend FastAPI, incluyendo 27 plantillas listas para OBS, soporte indoor/beach y gestión multiusuario.
Ficha actualizada 24 sept 2026, 13:39 · upstream 24 sept 2026, 13:16 · release v7.2.1
Qué es volley-overlay-control
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Volley Overlay Control es una aplicación completa para gestionar partidos de voleibol, ofreciendo un motor de superposiciones integrado que sirve directamente a OBS sin necesidad de servidores externos. El sistema incluye 27 estilos de plantilla listos para usar, con soporte tanto para voleibol indoor (25 puntos, 5 sets) como beach (21 puntos, 3 sets). La arquitectura combina React para el frontend táctil y FastAPI para el backend, con persistencia en PostgreSQL.
La plataforma soporta múltiples usuarios con roles diferenciados (admin/user), permitiendo gestión aislada de tableros, superposiciones y reportes por cuenta. Incluye funcionalidades avanzadas como historial automático de partidos, webhooks configurables para eventos del juego, stack de deshacer lado servidor y control simultáneo desde múltiples dispositivos sin conflictos. El sistema está internacionalizado con soporte para seis idiomas.
Destaca por su capacidad de generar superposiciones en tiempo real vía WebSocket, gestión de identidades de equipos con logos y colores personalizados, y generación automática de reportes impresos o PDFs. La aplicación incluye un panel de administración global para curar catálogos compartidos de equipos y plantillas, manteniendo la privacidad de los datos de cada usuario.
- Control táctil de partidos de voleibol desde tablets o móviles durante transmisiones en vivo
- Integración con OBS mediante superposiciones listas para usar sin configuración externa compleja
- Gestión multiusuario de marcadores en instalaciones deportivas con roles admin y operador
- Generación automática de reportes post-partido con estadísticas y gráficos por set
- Motor de superposiciones integrado con 27 estilos compatibles directamente con OBS Browser Source
- Soporte nativo para modos indoor y beach con reglas de puntuación y cambio de lado automático
- Gestión multiusuario con roles admin/user, sesiones HttpOnly y aislamiento de datos por cuenta
- Stack de deshacer lado servidor (LIFO) compartido entre clientes concurrentes sin pérdida de estado
- Dependencia obligatoria de PostgreSQL para persistencia de datos y reportes históricos
- Configuración manual requerida de variables de entorno para webhooks y secretos de firma
- No incluye autenticación OAuth o SSO, solo credenciales básicas con cookies HttpOnly
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Desplegar usando Docker Compose con al menos 2 núcleos CPU, 2GB RAM y 20GB disco. Asegurar que el puerto 8080 esté disponible para la API y 80 para el frontend. Configurar variables de entorno MATCH_REPORT_SIGNING_SECRET si se requiere protección de reportes, o establecer MATCH_REPORT_PUBLIC=true para acceso abierto. Para webhooks, definir WEBHOOKS_URL o WEBHOOKS_JSON con endpoints válidos.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.