Adivina la palabra
Juego web multijugador en tiempo real de adivinar palabras por definición, con salas configurables, comodines y un bot con IA.
Adivina la palabra es un juego web multijugador de adivinar palabras por definición, desarrollado como trabajo universitario en el que los jugadores crean salas configurables (idioma, cantidad de rondas, jugadores y comodines), entran a una sala de espera con estado 'listo' y en cada ronda de 60 segundos reciben una definición y deben escribir la palabra correcta. El juego es en tiempo real: los aciertos, el ranking y el chat se sincronizan entre todos los jugadores.
- Java
- Spring MVC
- Thymeleaf
- WebSocket + STOMP
- MySQL
- Google Gemini
- Bootstrap
- Docker
Imágenes del proyecto
Qué lo hace interesante
Multijugador en tiempo real
Chat, ranking en vivo, sala de espera sincronizada, expulsión de jugadores y cuenta regresiva entre rondas, todo con WebSockets/STOMP.
Bot con IA (Google Gemini)
El bot recibe la definición, la procesa con Gemini 2.5 y responde intentos como un jugador humano más dentro de la partida.
Palabras dinámicas reales
Las palabras y definiciones se obtienen de la API de la RAE (español) y Wikidata (inglés), no de listas estáticas.
Economía con pagos reales
Monedas que se gastan en comodines (75 revelar letra, 100 bloquear rival 10s), comprables con Mercado Pago en sandbox + webhook.
Arquitectura
Aplicación Java con patrón Spring MVC + Thymeleaf organizada en capas: config, presentación, dominio, infraestructura y helpers para integraciones externas. El flujo de rondas se controla con un scheduler (RondaTimerManager) que fuerza el fin de ronda a los 60s, y la sincronización en tiempo real usa Spring WebSocket + STOMP.
config/Configuración Spring: MVC + Thymeleaf, Hibernate (MySQL), WebSocket/STOMP, interceptores de sesión/auth y executor de rondas.
presentacion/Controllers MVC + handlers WebSocket (Login, Registro, Lobby, SalaDeEspera, Juego, Market, Perfil, Ranking, VistaFinal).
dominio/Núcleo de negocio: entidades JPA (Usuario, Partida, Ronda, Palabra, Acierto...), DTOs, enums de estados, excepciones, interfaces de servicio y repositorio, y el RondaTimerManager.
infraestructura/Implementaciones de repositorios (Hibernate DAOs).
helpers/Integraciones externas: API RAE, Wikidata y Mercado Pago.
Frontend
Bootstrap 5 (webjars) con CSS propio y JavaScript con cliente StompJs para la sala de espera y el juego. Vistas Thymeleaf (15 pantallas) en WEB-INF/views/thymeleaf y recursos estáticos en resources/core.
Características principales
- Lobby de partidas: crear sala configurable (idioma español/inglés, nº rondas, min/max jugadores, comodines, bot), unirse a sala o partida aleatoria.
- Sala de espera en tiempo real: estado 'listo', chat, expulsión por el creador y validación de mínimos para iniciar.
- Rondas multijugador en vivo: definición + temporizador de 60s, aciertos publicados en tiempo real, avance/cierres automáticos y puntaje por acierto.
- Comodines con costo de monedas: revelar letra (75) y bloquear a un oponente 10 segundos (100).
- Bot rival con IA Gemini que juega dentro de la partida.
- Monedas y tienda con pagos Mercado Pago (sandbox) y ranking global histórico.
Calidad y despliegue
- Testing multicapa: servicios (JUnit 5 + Mockito + Hamcrest), repositorios con HSQLDB/TestConfig (Hibernate real en memoria) y controllers.
- E2E WebSocket: SalaDeEsperaControllerE2ETest conecta clientes STOMP reales (Tyrus) contra ws://localhost:8080 verificando flujos de sala (listo, expulsión, inicio de partida).
- JavaScript con Jasmine (main.test.js, npm test); Playwright y Selenium declarados para E2E de vistas.
- CI/CD con GitHub Actions: ejecuta mvn clean test en cada push/PR a main.
- Deploy: WAR con Maven e imágenes Docker para Jetty y Tomcat + contenedor MySQL; dev local con mvn jetty:run → http://localhost:8080/spring.
¿Querés ver el resto?
Explorá otros proyectos donde aplico buenas prácticas de arquitectura, rendimiento y experiencia de usuario.
Ver todos los proyectos