Medium: Edición Digital

Una versión digital del juego de mesa Medium - un juego social de lectura mental y adivinanza de palabras.

📋 Estado del Proyecto

• ✅ Versión Local: Funcional y optimizada
• ✅ Multiplayer Online: ✨ 100% FUNCIONAL
• ✅ Optimizaciones Móviles: Implementadas
• ✅ ESP Cards: ✨ 100% FUNCIONALES (Good Fortune, Clairvoyance, Incantation)
• ✅ Sistema de Bots: Mejorado con asociaciones semánticas
• ✅ Backend: ✨ 100% Integrado y desplegado
• ✅ PWA: Manifest configurado
• ✅ Socket.IO: Sincronización perfecta en tiempo real
• ✅ Valores Variables: Tokens con valores 7-6-5, 4-3, 2-1
• ✅ Reconexión: Sistema robusto implementado

🎯 COMPLETITUD: 100%

🎮 Ejecutar Localmente

Prerequisitos: Node.js 18+

1. Instalar dependencias:

   npm install

2. Iniciar servidor de desarrollo:

   npm run dev

3. Abrir en navegador:

   http://localhost:5173
   

📚 Documentación

• 🎉 100% COMPLETADO - ¡Implementación completa!
• 📖 Manual del Juego - Reglas oficiales del juego de mesa
• ✨ Implementación Completa - Estado y funcionalidades
• 🔧 Configuración de Variables - Guía de variables de entorno
• 🏗️ Arquitectura Multiplayer - Documentación técnica
• 🔙 Backend README - Documentación del servidor

🚀 Deploy

Desarrollo Local

npm run dev
# Abre http://localhost:5173

Producción

Guía Rápida (30 min): DEPLOY_QUICK.md
Guía Completa: DEPLOY.md

Stack de Deploy:

• Frontend: Netlify (gratis)
• Backend: Render (gratis)
• Base de datos: MongoDB Atlas (gratis)

Scripts útiles:

# Verificar configuración
./scripts/check-deploy.sh

# Configurar variables locales
./scripts/setup-env.sh

🎯 Características Implementadas (100%)

Mecánicas Core

• ✅ Juego de 3 intentos (Mind Meld, Telepathy, Psychic Link)
• ✅ Sistema de puntuación con valores variables (7-6-5, 4-3, 2-1)
• ✅ 3 Lightning Bolts que terminan el juego
• ✅ Mazos del Sampler Pack (6 decks × 18 palabras)
• ✅ Robo automático de cartas al finalizar turno

Multiplayer Online

• ✅ Sistema de salas con código (4 dígitos)
• ✅ 2-6 jugadores en tiempo real
• ✅ Sincronización perfecta del estado del juego vía Socket.IO
• ✅ Ambos jugadores deben jugar cartas antes de continuar
• ✅ Sala de espera con lista de jugadores
• ✅ Sistema de reconexión robusto (5 min de gracia)
• ✅ Host puede iniciar el juego

ESP Cards (100% Funcionales)

• ✅ 🍀 Buena Fortuna: Duplica tokens del turno (FUNCIONAL)
• ✅ 🔮 Clarividencia: Predice palabra del rival - gana Mind Meld si aciertas (FUNCIONAL)
• ✅ ✨ Invocación: Prohibe una palabra al rival (FUNCIONAL)
• ✅ Bonus +3 pts por cada carta ESP no usada
• ✅ Sincronización completa con otros jugadores

UI/UX & Animaciones

• ✅ Interfaz con temática neón (Cyan/Pink/Yellow)
• ✅ Animaciones mejoradas:
  • Efecto de ping y estrella en éxitos ✨
  • Corazón roto en fallos 💔
  • Indicador animado de espera 🕓
  • Slide-in de palabras
  • Efectos de brillo neón
  • Transiciones suaves
• ✅ Optimizaciones móviles:
  • Cartas más grandes (+20%)
  • Inputs sin zoom automático
  • Scroll snap suave
  • Modal fullscreen
  • Feedback táctil
• ✅ PWA (Progressive Web App):
  • Instalable en móviles
  • Manifest configurado
  • Meta tags optimizados
• ✅ Manual de reglas integrado

⏭️ Próximas Características

• Conectar frontend con backend
• Sistema de lobby con códigos
• Multiplayer online sincronizado
• ESP Cards en modo multiplayer (Clarividencia, Invocación)
• Variantes de 2, 3 y 5 jugadores
• Chat en sala
• Ranking global
• Service Worker para modo offline
• Íconos personalizados (192px, 512px)

🛠️ Stack Tecnológico

• Frontend: React 19 + TypeScript + Vite
• Estilos: Tailwind CSS
• Build: Vite
• Deploy: Netlify (frontend)

📝 Cambios Recientes

v0.3.0 (Enero 2026) - Mejoras Implementadas

• ✅ Optimizaciones móviles completas
  • Cartas 20% más grandes para mejor touch
  • Inputs optimizados (sin zoom en iOS)
  • Scroll snap suave
  • Modal fullscreen en móvil
• ✅ ESP Cards funcionales
  • Good Fortune duplica puntos
  • Bonus +3 pts por ESP no usada
  • UI interactiva en header
• ✅ Sistema de bots mejorado
  • 50+ asociaciones semánticas
  • Algoritmo inteligente de intersección
• ✅ PWA implementado
  • Manifest.json configurado
  • Instalable en dispositivos
• ✅ Backend base creado
  • Node.js + Express + Socket.io
  • MongoDB con modelo Room
  • Sistema de lobbies con códigos
  • Listo para integración

v0.2.0 (Enero 2026)

• ✅ Eliminado servicio de Gemini AI
• ✅ Implementado sistema de bots local
• ✅ Evaluación completa de cumplimiento del manual
• ✅ Documentación de arquitectura multiplayer
• ✅ Análisis de UX/UI para móviles

🎲 Cómo Jugar

1. Ingresa tu nombre y crea una partida
2. Juega una carta de tu mano
3. Tu compañero bot jugará otra carta
4. Piensa en la palabra que conecta ambas cartas
5. Escribe tu palabra y presiona "¡MEDIUM!"
6. Si ambos coinciden, ¡ganan puntos!
7. Tienen 3 intentos para coincidir
8. El juego termina cuando se roban 3 cartas de rayo

📄 Licencia

Este es un proyecto educativo basado en el juego Medium de Storm Chaser Games.

🤝 Contribuir

Ver ARQUITECTURA_MULTIPLAYER.md para guías de implementación.