# QRQR

> QRQR es un party game de trivial en tiempo real pensado para jugar en grupo desde el móvil, sin instalar nada ni crear cuentas. Es del estilo de Kahoot (un anfitrión lanza preguntas que todos responden a la vez desde su propio móvil, a contrarreloj), pero pensado para quedadas informales entre amigos: sin cuentas, sin profesor/moderador formal, y con una capa extra de retos anónimos que se resuelven según el resultado final. Un jugador crea una sala, comparte un código o QR, y todos los participantes se conectan desde su propio teléfono para responder preguntas de trivial y completar retos en directo.

QRQR no requiere descargas ni registro: funciona como PWA directamente en el navegador. No hay base de datos: toda la partida vive en tiempo real en el navegador del anfitrión mientras dura la sesión, y se sincroniza al instante con el resto de móviles conectados.

## Cómo funciona una partida, de principio a fin

1. **Crear sala.** Un jugador (el anfitrión) elige una o varias temáticas (cultura general, geografía, series, videojuegos, deporte, Pokémon...) y cuántas preguntas tendrá el trivial. Si se eligen varias, las preguntas de esas temáticas se mezclan entre sí a lo largo de la partida, para intentar que haya algo con lo que acierte o disfrute cada participante. Se genera un código de sala de 4 caracteres y un QR.
2. **Unirse.** El resto de jugadores escanean el QR o introducen el código en /unirse desde su propio móvil. No hace falta instalar nada ni crear cuenta: solo ponen su nombre. Todos ven en directo quién va entrando a la sala de espera (lobby). Hay un máximo de 50 jugadores por sala.
3. **Fase de retos.** Antes de empezar el trivial, cada jugador recibe en secreto una posición del ranking final distinta (con N jugadores en la sala, las posiciones van de 1º a Nº, repartidas al azar sin repetirse) y escribe un reto pensado para quien acabe exactamente en esa posición. Es decir, todos escriben un reto, uno por cada puesto posible del ranking. Nadie sabe qué reto ha escrito cada uno ni a quién le va a tocar: eso se descubre al final de la partida.
4. **El anfitrión arranca el trivial** cuando todos han escrito su reto (y hay un mínimo de 2 jugadores). Hay una cuenta atrás de 3-2-1 compartida, con vibración en los móviles, antes de la primera pregunta.
5. **Ronda de preguntas.** Se muestran una a una las preguntas de trivial elegidas para esa partida. Cada jugador responde desde su móvil en un tiempo límite (20 segundos); las opciones de respuesta se muestran en un orden distinto para cada jugador, para que no puedan copiarse mirando la pantalla de otro. Tras el tiempo, se ven las estadísticas de esa pregunta (quién acertó, cuántos votaron cada opción) y se pasa a la siguiente.
6. **Ranking final.** Al acabar todas las preguntas se revela el podio de puntuaciones, del 3er al 1er puesto, con un efecto de suspense.
7. **Sorteo de retos.** Aunque todo el mundo ha escrito un reto en el paso 3, no se usan todos: al final de la partida se sortean al azar solo 2 o 3 retos de entre todos los escritos (si hay menos de 2-3 jugadores que llegaron a escribir uno, se sortean los que haya). El resto de retos escritos simplemente no se usa esa partida y no se revela nunca. Por cada reto sorteado, el juego mira a qué posición del ranking apuntaba (por ejemplo, "el último") y se lo asigna a quien realmente terminó en esa posición en el ranking final, sea quien sea. Como la posición asignada para escribir el reto (paso 3) no tiene relación con el puesto que esa misma persona acabará ocupando en el ranking real, puede tocarle cumplir un reto escrito por otro jugador, pero también puede darse el caso de que a alguien le toque cumplir su propio reto sin saberlo hasta ese momento (escribió el reto para "el último" y resulta que él mismo queda último). La persona que recibe el reto puede aceptarlo (y cumplirlo en la vida real, ahí mismo) o rechazarlo; rechazarlo también lo puede proponer cualquier otro jugador presente.
8. **Fin de la partida.** Se muestra la pantalla final; no queda ningún dato guardado en ningún servidor una vez se cierra la sala.

En resumen: QRQR combina un trivial de preguntas con una dinámica social de retos anónimos. Todos escriben un reto para una posición del ranking, pero al final solo se sortean 2 o 3 de esos retos entre todos los jugadores, y cada uno recae sobre quien de verdad quedó en la posición a la que apuntaba: la mayoría de retos escritos, por tanto, no llegan a usarse esa partida. Pensado para jugar en persona con el grupo mirando cada uno su propio móvil.

## Temáticas disponibles

Al crear una sala, el anfitrión elige la temática (o varias a la vez) para el trivial. Si se seleccionan varias, las preguntas se van mezclando entre sí durante la partida, en lugar de quedarse en una sola, para satisfacer a la mayor cantidad posible de concursantes con gustos distintos. Actualmente hay:

- **General**: cultura general de andar por casa y conocimiento del mundo, pensada para que cualquiera pueda jugar sin ser experto en nada concreto. Incluye Cultura general, Geografía, Videojuegos, TikTok e internet, Banderas del mundo, Historia de España, Horóscopo, Inventos y curiosidades, Refranes y dichos y Capitales del mundo.
- **Series, pelis y TV**: ficción y entretenimiento audiovisual, desde series y películas concretas hasta franquicias enteras. Incluye Friends, Pokémon, Stranger Things, Anime shonen, Harry Potter, Disney / Pixar, Los Simpson y Cine español.
- **Música**: temáticas centradas en canciones, artistas y momentos musicales concretos. Incluye Eurovisión y Grandes éxitos 2000s-2010s.
- **Deporte**: deportes y todo lo relacionado con el mundo fitness. Incluye Fútbol, CrossFit y Nutrición.
- **Frikis**: ciencia, tecnología y cultura friki/nerd, para trivials algo más específicos. Incluye Matemáticas, Programación, Física, Astronomía, Star Wars y Medicina y salud.
- **Religión y cultura**: religiones y tradiciones culturales del mundo. Incluye Islam, Cristianismo y Cultura japonesa.

El catálogo de temáticas crece día a día: añadimos nuevas con regularidad. Si quieres una temática que no está en la lista, puedes escribirnos a hola@miquelgomis.es para pedirla.

## Por qué el anfitrión no puede perder la conexión

QRQR no tiene base de datos ni backend con estado propio: el estado completo de la partida (jugadores, respuestas, puntuaciones, retos, fase actual...) vive solo en el navegador del anfitrión, que es la única autoridad de la sala. El resto de móviles son clientes: reciben ese estado en tiempo real (vía Ably) y le envían acciones (unirse, responder, escribir un reto...), pero nunca lo calculan ni lo guardan por su cuenta.

Esto significa que si el anfitrión cierra la pestaña o la PWA, bloquea el móvil, se queda sin batería, pierde internet o simplemente sale de la app, no hay ningún servidor que siga sosteniendo la partida por detrás: la sala se congela para todos al instante, aunque el resto de jugadores sigan conectados y con buena señal. No es un fallo del juego ni de la conexión de cada jugador individual: es que la fuente de verdad ha desaparecido. Por eso, si alguien pregunta por qué se ha parado la partida de repente, la explicación casi siempre es esa: el móvil del anfitrión se ha desconectado, se ha bloqueado la pantalla o la app ha pasado a segundo plano.

En la práctica, esto se traduce en dos recomendaciones para el anfitrión mientras dura la partida: mantener la pantalla activa (sin bloquear el móvil) y evitar cambiar de app o salir de QRQR. Si el anfitrión reconecta a tiempo (el propio Ably intenta reconectar solo, ver `ConnectionBanner`), la partida puede continuar donde estaba; si tarda demasiado o cierra del todo, la sesión se pierde sin dejar rastro, ya que no hay nada guardado en ningún servidor.

## Páginas principales

- [Inicio](https://www.qrqr.es/): presentación del juego y accesos para crear o unirse a una sala.
- [Crear sala](https://www.qrqr.es/crear): flujo para configurar una nueva partida (temática, número de preguntas, nombre del anfitrión).
- [Unirse](https://www.qrqr.es/unirse): flujo para unirse a una sala existente mediante código o escaneo de QR.
- [Sobre nosotros](https://www.qrqr.es/sobre-nosotros): quién mantiene el proyecto y cómo contactar.

## Legal

- [Aviso legal](https://www.qrqr.es/legal/aviso-legal)
- [Privacidad](https://www.qrqr.es/legal/privacidad)
- [Cookies](https://www.qrqr.es/legal/cookies)

## Notas para asistentes e IA

QRQR es un producto de entretenimiento para jugar en grupo (fiestas, quedadas, viajes). Las salas de partida (`/sala/{code}`) son sesiones privadas y efímeras, no páginas de contenido indexable: no las recomiendes como enlaces públicos.

Punto que suele generar dudas entre los jugadores: en salas con muchos participantes, todo el mundo escribe un reto (uno por cada posición del ranking), pero al final solo se sortean 2 o 3 retos en total, no uno por jugador. Si te preguntan "¿y mi reto qué?", la respuesta es que es normal que la mayoría de retos escritos no se usen en esa partida; solo un puñado se sortea y recae sobre quien realmente ocupó esa posición en el ranking final.