quiz-dock
Plataforma de cuestionarios en vivo auto-alojada estilo Kahoot, basada en NestJS/Next.js con PostgreSQL y Redis. Soporta autenticación local u OIDC, rebranding sin rebuilds y exportación CSV.
Ficha actualizada 22 sept 2026, 14:50 · upstream 22 sept 2026, 14:39 · release v0.5.1
Qué es quiz-dock
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
QuizDock es una plataforma de cuestionarios en tiempo real diseñada para ser auto-alojada, funcionando como alternativa a servicios SaaS como Kahoot. Utiliza una arquitectura monolítica simplificada empaquetada en una única imagen Docker que incluye NestJS para el backend, Next.js para el frontend y las bases de datos PostgreSQL y Redis. Esto permite desplegar la aplicación completa sin necesidad de orquestar múltiples contenedores manualmente.
La plataforma está diseñada específicamente para proyección en pantallas grandes, con interfaces optimizadas para presentadores y participantes que se unen mediante PIN o QR code sin necesidad de crear cuentas. Soporta siete tipos de preguntas distintos, incluyendo texto, numérico, ordenación y encuestas, además de permitir contenido multimedia y diapositivas entre preguntas. El sistema de puntuación premia la velocidad y la precisión, generando tablas de clasificación en tiempo real.
QuizDock ofrece dos modos de autenticación: local (sin login) para entornos cerrados como aulas o salas de reuniones, y OIDC para organizaciones con proveedores de identidad existentes. Incluye capacidades de white-label mediante variables de entorno y archivos montados, permitiendo cambiar nombre, logo y estilos CSS sin recompilar la aplicación.
- Clases educativas en tiempo real donde el profesor presenta cuestionarios interactivos a estudiantes que se unen desde móviles o tablets.
- Sesiones de formación corporativa con autenticación OIDC para garantizar la identidad de los participantes y auditoría de resultados.
- Eventos públicos o conferencias utilizando el modo demo público con limpieza automática de datos cada hora.
- Evaluaciones formativas en entornos seguros donde se requiere exportar CSV de respuestas individuales para análisis posterior.
- Arquitectura simplificada en una sola imagen Docker que incluye backend, frontend y bases de datos.
- Soporte nativo para autenticación OIDC con proveedores como Keycloak, Authentik o Entra ID.
- Capacidad de white-label mediante variables de entorno y archivos montados sin necesidad de rebuilds.
- Sistema de puntuación en tiempo real que premia la velocidad y precisión de las respuestas.
- Exportación de resultados en CSV y capacidad de importar/exportar cuestionarios completos como bundles portables.
- La base de datos PostgreSQL requiere backup manual antes de cada actualización para evitar pérdida de datos.
- El modo demo público borra todos los datos cada hora, no apto para sesiones largas o datos persistentes.
- No soporta autenticación OAuth2 tradicional fuera del protocolo OIDC.
- La imagen Docker es distroless sin shell, lo que dificulta el debugging directo en producción.
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.
Para producción, usar docker-compose.prod.yml y no el modo standalone. Configurar APP_PUBLIC_URL correctamente para generar QR codes válidos. Realizar backup de PostgreSQL antes de cada upgrade. No usar DEMO_MODE=true en entornos privados con datos sensibles. Asegurar que los puertos 18080 (app) y 6379 (Redis) estén abiertos.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
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.