❓ Ayuda — cómo funciona la app

Esta app guarda el mejor puntaje de cada jugador en cada mesa de tu cabina de pinball virtual y te ayuda a organizar competencias entre varios jugadores.

1. Conceptos básicos

• Mesa: una máquina de pinball, con Nombre, Marca y Año.
• Jugador: se identifica con Iniciales de 3 letras (siempre mayúsculas), más Nombre y Email (opcional).
• Puntaje: el resultado de un jugador en una mesa.

2. Administrar: Jugadores, Mesas y Puntajes

En la botonera principal, entrá a Administrar. Sus pestañas internas, en orden, son Jugadores, Mesas y Puntajes. Puntajes se abre por defecto; al cambiar de pestaña principal y volver, se recuerda la última subpestaña usada durante la sesión.

• Mesas: cargá el nombre, la marca y el año. Al escribir la marca aparecen sugerencias con las marcas conocidas; tocá una (o usá ↑ ↓ y Enter) para completarla. También podés escribir una marca nueva. Si no existe en la lista, aparece Agregar marca «…» al sistema.
• Jugadores: cargá las iniciales, el nombre y, si querés, el email.
  ⚠️ Las iniciales no se pueden repetir. Si escribís unas que ya están en uso, el propio casillero te lo avisa (en rojo) y el botón Agregar jugador queda deshabilitado hasta que elijas unas iniciales libres.
• Puntajes: buscá la mesa y el jugador, y escribí el puntaje. Mesa y Jugador tienen sugerencias; si no hay coincidencia exacta, podés crear el registro desde el mismo buscador. El puntaje solo acepta números y se muestra con separador de miles mientras escribís. Si es tu primer puntaje, tu primera vez en esa mesa o un nuevo récord personal, se abre el modal Logros (sin el paso de confirmación).

2.1 Buscadores de Puntajes y alta rápida

• Mesa y Jugador se buscan como en Competencia: escribí parte del nombre (o las iniciales) y aparecen sugerencias. Usá el mouse, ↑ ↓ + Enter, o Escape para cerrar. La × limpia el casillero.
• Si no hay una coincidencia exacta, la última sugerencia es Crear mesa «…» o Crear jugador «…». Al elegirla se abre un formulario con el texto ya cargado. Cancelar vuelve al buscador sin perder lo escrito.
• Al guardar aparece una confirmación. Al cerrarla, el registro nuevo queda seleccionado en el buscador original.
• Si el texto del jugador tiene exactamente 3 letras, se usan como iniciales; si no, se usa como nombre. Podés completar o corregir los datos en el formulario.
• Después de guardar un puntaje, la mesa y el jugador elegidos se conservan para la próxima carga.
• Marcas personalizadas: se agregan desde Administrar → Mesas o desde el alta rápida de una mesa, con una confirmación. Se guardan en este navegador, viajan en el respaldo JSON, no se pueden duplicar (sin distinguir mayúsculas ni acentos) y no tienen borrado individual por ahora. Si cancelás, la marca queda como texto libre y la mesa se puede guardar igual.

3. Las listas y el historial

La app mantiene dos listas de puntajes separadas y un historial de competencias:

• 🏅 Marcador (pestaña Marcador): el mejor puntaje histórico de cada jugador en cada mesa. Se muestra al lado del nombre de cada mesa. Hay un solo registro por jugador y por mesa. No tiene botones para editar ni borrar: se actualiza automáticamente al cargar puntajes desde Administrar → Puntajes, desde el buscador del Marcador o desde una competencia.
• Historial de cargas (Administrar → Puntajes): el total de las cargas manuales. Es el registro de todo lo que fuiste cargando desde Puntajes o desde el buscador del Marcador (una fila por carga).
• Historial de competencias (sección Competencias): las competencias cerradas, con su número, fecha y hora de inicio y cierre, duración y el resumen completo. Se explica en el punto 7.

4. Competencia, paso a paso

1. Iniciar competencia: se abre la pantalla de jugadores. Buscá por nombre o iniciales y tocá una sugerencia para agregar (si ya está elegido, aparece grisado con ✓). Abajo podés ordenar los turnos con ↑ / ↓ o Quitar, usar 🎲 Orden aleatorio y tocar Confirmar selección y orden. Participan dos o más jugadores y el orden queda fijo durante toda la competencia.
2. Elegir mesa: al confirmar los jugadores, el cursor queda en el buscador de mesas. Buscá y tocá una mesa; el modal muestra su nombre en grande. Confirmá para iniciar los turnos (el cursor queda en la casilla de puntaje del primer jugador) o volvé al buscador. Al volver, el buscador se limpia y queda listo para otra búsqueda.
3. Turnos por ronda: la app muestra en grande a quién le toca y el formulario solo pide el puntaje de ese jugador (solo números, con separador de miles). Al enviarlo aparece una confirmación con Jugador, Puntaje y Mesa. Si guardás, se abre la Confirmación de guardado durante 4 segundos, con una X y un botón Cerrar; no muestra felicitaciones. Al cerrarla, si hay algún logro se abre el modal Logros; si no hay logros, el turno pasa al siguiente. El turno avanza recién al cerrar el último logro (o la confirmación, si no hubo logros) y el cursor queda listo en la casilla del siguiente jugador.
4. Pasar turno: si un jugador no puede o no quiere cargar puntaje, usá Pasar turno. Al terminar la ronda, cada jugador que pasó tiene una repesca (última oportunidad). Si en la repesca vuelve a pasar, queda con 0 en esa ronda.
5. Fin de la ronda: cuando todos anotaron o pasaron, la app pregunta si empieza una Nueva ronda (mismos jugadores y orden) o si se Cierra la mesa.
6. Cerrar la mesa: se toma el mejor puntaje de cada jugador entre todas las rondas de esa mesa y se reparten los puntos de podio. Debajo aparece el resumen con la Tabla de posiciones y los Resultados por mesa; cada mesa indica su marca, su año y cuántas rondas se jugaron (o la ronda en curso si sigue abierta). Ahí elegís si la competencia sigue con otra mesa o finaliza.
7. Finalizar competencia: al terminar se abre una ventana con el resumen final. Podés cerrarla con el botón Cerrar de abajo o con la X de arriba a la derecha. Al cerrarla, la sección Competencias queda limpia: solo la tarjeta para iniciar otra competencia y el historial actualizado, con la competencia recién terminada cerrada (colapsada).

Si un participante no anotó ningún puntaje en una mesa, aparece igual en los resultados con 0 puntos y sin puesto. Las competencias guardadas antes de esta versión piden elegir jugadores y orden antes de continuar; sus puntajes se conservan.

5. Los puntajes de competencia y el Marcador

Los puntajes de la competencia se cuentan solo dentro de la competencia (no entran al historial de cargas). Pero al cargarlos, la app los coteja con el Marcador de ese jugador en esa mesa:

• Si el jugador no tenía registro en esa mesa → se agrega al Marcador.
• Si el puntaje de la competencia es mayor que el registrado → se sobrescribe en el Marcador.
• Si es menor o igual → queda solo en la competencia, el Marcador no cambia.

Si el puntaje guardado supera tu mejor registro en el Marcador, la Confirmación de guardado no muestra la felicitación. Al cerrarla se abre el modal Logros con el texto “Felicitaciones, superaste tu mejor puntaje en esta mesa!”.

El modal Logros también aparece en estos casos:

• Primer puntaje histórico: es tu primera carga en la app, dentro o fuera de una competencia. Incluye una bienvenida.
• Primera vez en una mesa: ya tenías puntajes en otras mesas, pero es tu primer registro en esa mesa.
• Nuevo récord personal: superaste tu mejor puntaje en esa mesa.
• Podio o 1º de la mesa: cuando el puntaje es nuevo récord o tu primera vez en esa mesa y te deja en el podio provisional (2º/3º) o en el 1º puesto. Si ya estabas 1º y volvés a anotar sin superar tu récord, no se repite.

Cada logro se muestra en su propio modal de 4 segundos, con la misma X y un botón Siguiente o Cerrar. Si un logro implica otro, no se duplica: el primer puntaje reemplaza a “primera vez en la mesa” y el 1º reemplaza al podio. El orden es: logros personales, récord y posición.

6. Puntos y ganador

Cada mesa otorga puntos según el mejor puntaje de cada jugador entre todas las rondas de esa mesa:

• 1º = 3 puntos · 2º = 2 puntos · 3º = 1 punto.
• El resto de los jugadores no suma puntos.
• Los participantes que no anotaron ningún puntaje aparecen con 0 puntos (y “Sin puntaje” en los resultados de mesa); no reciben puntos de podio.
• Empates: comparten puesto y puntos, y se salta el puesto siguiente. Si dos jugadores empatan el 1º, ambos reciben 3 puntos y el siguiente es 3º (1 punto). Si empatan el 2º, ambos reciben 2 y no se otorga el 3º.

Gana quien suma más puntos. Si hay empate en el 1º puesto, se anuncia como empate entre todos los que compartan ese puesto. La tabla incluye a todos los participantes, incluso los que tienen 0 puntos. El podio final siempre muestra 1º, 2º y 3º: si no hay jugador para un puesto (por ejemplo, con 2 participantes), esa tarjeta queda en gris.

En las tablas, Puntaje es el puntaje de pinball y Puntos son los de competencia (3/2/1).

7. Historial de competencias

Cuando termina una competencia, el resultado final se muestra en el modal de cierre y la misma competencia se agrega inmediatamente abajo, en el Historial, como entrada cerrada. Al cerrar el modal, la sección Competencias no muestra carteles ni fechas: queda solo la tarjeta para iniciar otra competencia y el historial. Tocá esa entrada para expandir el resumen completo.

• Cada competencia tiene un número único y ascendente (“Competencia Nº 1”, “Competencia Nº 2”, etc.).
• Se guardan la fecha y hora de inicio y la fecha y hora de cierre, y se muestra la duración de la competencia, además de todos los datos del resumen: participantes, tabla de posiciones, puntos, podios, mesas, marca, año, rondas y puntajes por jugador.
• La lista es compacta: muestra número, ganador, fecha de cierre, duración, participantes y mesas. Tocá una competencia para expandir el resumen completo.
• El resumen es una copia guardada: aunque después borres un jugador o una mesa, la competencia histórica conserva sus iniciales, nombres, marcas, años y puntajes.
• La competencia recién terminada aparece cerrada (colapsada) en el historial; el modal de cierre y esa entrada muestran el mismo resumen, guardado una sola vez.

8. Guardar y respaldar

• Los datos se guardan solos en el navegador (no hace falta guardar).
• Exportar datos: genera un respaldo .json, intenta descargarlo y, si tu navegador no lo descarga solo, te muestra el contenido para copiarlo y guardarlo a mano.
• Importar datos: restaura desde un respaldo, eligiendo un archivo o pegando el contenido (reemplaza lo actual, incluidas las marcas personalizadas).
• Borrar todo: elimina todo, incluidas las marcas personalizadas. No se puede deshacer.

9. Buscar y cargar desde el Marcador

En la pestaña Marcador hay un casillero de búsqueda. Al escribir el nombre de una mesa, el listado se filtra al instante: solo quedan las mesas que coinciden. No hace falta presionar ningún botón y no aparecen sugerencias normales.

• Mesa sin puntajes: si escribís el nombre exacto de una mesa que existe en el sistema pero todavía no tiene puntajes, aparece Cargar puntaje en «…». Al tocarla se abre el modal Nuevo puntaje con la mesa completa y el foco en Jugador. Podés buscar o crear un jugador y guardar el puntaje; la mesa pasa a aparecer en el Marcador.
• Mesa inexistente: si el nombre no coincide con ninguna mesa del sistema, aparece Agregar mesa «…». Al tocarla se abre el formulario de Nueva mesa con el nombre cargado y el foco en Marca. Al guardarla se abre el modal Nuevo puntaje con esa mesa.
• Borrar el filtro: cuando el casillero tiene texto aparece una ✕ a la derecha. Al tocarla se borra el texto y vuelve la lista completa.
• La búsqueda no distingue mayúsculas ni acentos, y el texto se mantiene si cambiás de pestaña y volvés.

10. Instalar la app y actualizaciones

• Instalar: la app se puede instalar desde el navegador. En Android, Chrome o Edge, usá el botón Instalar app si aparece, o el menú del navegador → Instalar aplicación.
• iPhone/iPad: abrí la URL publicada en Safari, tocá Compartir y elegí Añadir a pantalla de inicio.
• La instalación necesita la URL publicada (HTTPS). Abrir index.html con doble clic sigue funcionando, pero no permite instalar.
• Versión nueva: cuando hay una actualización, aparece un aviso con el botón Actualizar. También se aplica al cerrar y volver a abrir la app.
• Los datos son locales de cada navegador o app instalada. Si la app instalada arranca vacía, usá Exportar datos en el navegador e Importar datos en la app instalada.