Hoseg Juegos — módulo de activación (QR + premios)
- Registrado: 2026-10-20 · Actualizado: 2026-10-21
- Cliente: Hoseg · Solicitante: Daniel Iturrizaga
- Estado: ✅ en producción, listo para evento (stock en 0 a la espera del conteo real)
- URL: https://hoseg-juegos.disoftx.solutions · panel
/admin· ayuda/ayuda· demo/demo - Código:
proyectos/hoseg-juegos(repodannyelito/Nexus) · documentación técnica en suREADME.md - Hosting: Zeta (
opsmgr@100.83.7.25), contenedorhoseg-juegos, redcaddy_net, puerto 3021, BDdata/juegos.db
1. Concepto
Activación de marca: la persona escanea un QR, deja celular + nombre + consentimiento, juega uno de
5 juegos y, si lo completa, recibe un premio con código (HG-XXXX) que el staff entrega en el módulo.
Al final se le invita a Hoseg Rewards.
2. Los 5 juegos (estado final)
| id | Nombre | Mecánica | Tiempo |
|---|---|---|---|
memoria |
Memoria textil | 5 pares con fotos reales (10 cartas) | 40 s |
puzzle |
Rompecabezas | 3×3 deslizante con el chaleco; mezcla validada con A* → mínimo 12 movimientos | 2:00 |
laberinto |
Laberinto | 17×17 DFS + pocos atajos; meta con un solo acceso garantizado | 90 s |
sopa |
Sopa de letras | 14×14 · SOSTENIBILIDAD, IMPACTO, PROPÓSITO, ALPAFILL, HOSEG; resalta la palabra encontrada | 110 s |
distinta |
Prenda distinta | 4×4, 6 rondas, 55% en modo espejo, −3 s por error | 45 s |
- Fotos reales del CDN de hosegstore.com en
public/img/. - Gorra excluida del modo espejo (es simétrica, el reflejo no se percibe).
- Descartado: juego tipo Fruit Ninja ("Corta lo insostenible") — no gustó.
3. Reglas del juego
- Una partida por celular, se gane o se pierda (
players.plays,/api/lose). - Ganar = completar el objetivo. Si se acaba el tiempo → pantalla “Tiempo agotado”, sin premio y sin reintento.
- Un premio por celular; el staff puede habilitar otra partida (Otra) o borrar el registro (Borrar, devuelve stock).
- Números de prueba (
UNLIMITED_PHONES): juegan ilimitado, no consumen stock y no cuentan en las columnas.
4. Panel de admin
- Sesión de 8 h (cookie
hadmincon expiración validada); auto-login si la cookie sigue vigente. - Personas que jugaron: filtro por nombre/celular/código, estado
Pendiente/Entregado/Sin premio,
acciones por fila y descarga en Excel real (.xlsxgenerado sin dependencias). - Stock: Stock · Reservado · Inicial · Entregado. El stock se descuenta al ganar (reserva).
- Auto-refresco cada 8 s + botón Actualizar; todo con
Cache-Control: no-store. - Ayuda (
/ayuda): guía para colaboradores, sin datos de prueba.
5. Incidentes y lecciones del 21/10
- Layout roto por el logo: el
bodycentraba con flex en fila; al añadir el logo quedaron dos hijos y se puso al costado. Fix:flex-direction: column. - Bug de reingreso: el cliente ignoraba
canPlay:falsecuando el jugador había perdido. Ahora muestra "Ya jugaste". - Stock inflado: las partidas de prueba contaban como reservadas. Ahora se excluyen por
UNLIMITED_PHONES. - Laberinto con dos accesos: el sellado con reversión dejaba dos entradas. Fix: sellar sin revertir + regenerar hasta validar (100/100 correctos sobre el HTML servido).
- Caché del navegador de WhatsApp: hizo creer que el fix del laberinto no había entrado; se verificó extrayendo el generador del HTML en producción.
6. Estado y pendientes
- Reset aplicado (21/10, 12:50): 0 jugadores, 0 premios ganados, stock e inicial en 0 en los 6 premios.
- Pendiente: cargar el stock real por premio (fijando
initialpara que la cuenta cuadre) y decidir
si el evento corre con tablet fija o QR impreso.