Competición: grupos, eliminatorias y resultados en directo

Esta guía explica cómo funciona el módulo de competición paso a paso.

Introducción

El sistema de competición te permite gestionar torneos con fase de grupos y fase eliminatoria. Puedes crear grupos, asignar equipos, registrar resultados, y las clasificaciones se calculan automáticamente. Cuando la fase de grupos termina, los clasificados pasan a un cuadro eliminatorio que se genera y conecta solo. También puedes compartir los resultados en directo con un enlace público que se actualiza automáticamente.

Crear una competición

1. Entra en la ficha del torneo.
2. Busca la sección Competición y pulsa Crear competición.
3. Pon el nombre y elige la categoría.
4. Guarda.

Una vez creada, verás la pantalla principal de la competición con las pestañas de fases.

La URL pública se genera automáticamente a partir del nombre. Si más adelante necesitas cambiarla, puedes hacerlo desde la pantalla Editar de la competición.

Estado de la competición

El estado que ves en el listado de competiciones (Pendiente, En curso, Finalizada) se calcula solo a partir de las fechas del torneo y de los partidos. No hay que tocar nada.

Antes existía un selector de estado en el formulario de edición. Se ha eliminado: el estado refleja lo que realmente está ocurriendo y no requiere mantenimiento manual.

Columna Visibilidad

En el listado de competiciones, junto al estado, verás un chip con la visibilidad pública de cada competición:

• Pública (verde): la competición aparece en /live/{slug} y en la página pública del torneo. Cualquiera con el enlace puede consultarla.
• Privada (gris): la competición no es accesible públicamente. Sigue existiendo internamente para administrar resultados, pero el público no la ve.

Para cambiarlo, entra en Editar la competición y marca o desmarca la casilla Visible públicamente.

Crear desde una plantilla

Si ya has guardado una plantilla de fase de grupos en otra competición (ver más abajo), puedes reutilizarla:

1. En la pantalla de la competición, debajo de Anadir fase, encontrarás el bloque Crear fase de grupos desde plantilla.
2. Selecciona la plantilla y opcionalmente cambia el nombre de la fase.
3. Pulsa Crear desde plantilla.

La plantilla copia la configuración (nombres de grupos, criterios de desempate). Los equipos y horarios los asignas después como siempre.

Fase de grupos

Crear grupos y asignar equipos

1. En la fase de grupos, pulsa Añadir grupo.
2. Dale un nombre al grupo (por ejemplo, "Grupo A").
3. Asigna los equipos que participarán en ese grupo seleccionándolos de la lista de equipos del torneo.
4. Repite para cada grupo.

Partidos generados automáticamente

Al asignar los equipos a un grupo, el sistema genera automáticamente todos los partidos de ida (round-robin) para que cada equipo juegue contra todos los demás del grupo.

No necesitas crear los partidos a mano. Se generan solos al guardar el grupo con sus equipos.

Equidad local/visitante: el sistema reparte automáticamente las veces que cada equipo juega como local y como visitante. La diferencia entre partidos como local y como visitante para cada equipo nunca será mayor de uno.

Eliminar partidos

A veces no juegan todos contra todos (por ejemplo, dos equipos del mismo club que no se enfrentan). Para eliminar un partido individual:

1. En la lista de partidos del grupo, busca el partido que quieres quitar.
2. Pulsa el botón rojo × al final de la fila.
3. Confirma.

Solo se pueden eliminar partidos que no tengan resultado registrado. Para eliminar uno con resultado, primero corrige o anula el resultado.

Edición masiva de fecha, hora y sede

Cuando varios partidos comparten fecha o sede (típico en cuartos: todos el mismo día en sedes alternas), puedes aplicar los valores en bloque:

1. Encima de cada tabla de partidos verás una fila con Fecha, Hora y Sede.
2. Marca con el checkbox los partidos a los que quieres aplicar los valores.
3. Rellena los campos arriba (puedes dejar alguno vacío para no tocarlo).
4. Pulsa Aplicar a seleccionados: se rellenan las casillas de las filas marcadas.
5. Revisa los valores y pulsa Guardar fase como siempre para confirmar.

El checkbox del encabezado selecciona o deselecciona todos los partidos de la tabla a la vez.

Conflictos de horario: si intentas guardar dos partidos en la misma sede a la misma fecha y hora, el sistema lo bloquea con un mensaje de error indicando con qué partido choca. La validación se aplica a toda la competición, no solo a la fase actual.

Orden de los partidos

Los partidos del grupo se muestran ordenados por fecha y hora ascendente. Los que todavía no tienen horario asignado aparecen al final, en el orden en que se generaron.

Guardar una fase de grupos como plantilla

Si la configuración de una fase de grupos (número de grupos, criterios de desempate, nombres) se repite entre competiciones, puedes guardarla para reutilizarla:

1. En la cabecera de la fase de grupos, pulsa Guardar como plantilla.
2. Ponle un nombre (por ejemplo, "Liga regular 4 grupos") y opcionalmente una descripción.
3. Guarda.

A partir de ahí, cualquier nueva competición del mismo cliente puede crearse a partir de esa plantilla (ver "Crear desde una plantilla" arriba). La plantilla no copia equipos, horarios ni partidos: solo la estructura.

Para gestionar tus plantillas (renombrar, borrar) accede a Plantillas de fase de grupos desde el menú.

Introducir resultados

1. En la lista de partidos del grupo, busca el partido que quieres registrar.
2. Introduce el resultado (goles, sets, puntos... según el deporte configurado).
3. Guarda.

Al guardar un resultado, la clasificación del grupo se recalcula automáticamente teniendo en cuenta puntos, diferencia de goles y demás criterios configurados.

Confirmar clasificación

Cuando todos los partidos de un grupo se han jugado, el siguiente paso es confirmar la clasificación.

Revisar y reordenar

1. Revisa la tabla de clasificación del grupo.
2. Si hay empates que el sistema no puede resolver automáticamente (por ejemplo, fair play o sorteo), puedes reordenar manualmente las posiciones arrastrando los equipos.
3. Una vez que la clasificación es correcta, pulsa Confirmar clasificación.

Cadena de desempates automática: puntos → diferencia de goles general → goles a favor → diferencia de goles particular (head-to-head) → goles en contra → jugador más joven del equipo (fecha de nacimiento más reciente). El último criterio (jugador más joven) cubre el caso real de "todos los parámetros empatados"; antes se decidía por orden de inserción en la base de datos, que era arbitrario. Se compara solo a personas con rol jugador (no entrenadores ni acompañantes). Si las fechas también coinciden, se compara con el segundo más joven, el tercero, etc.

Qué ocurre al confirmar

• El grupo queda bloqueado: no se pueden modificar resultados directamente (hay que usar la corrección).
• Los equipos clasificados se asignan automáticamente a los slots correspondientes de la fase eliminatoria.
• Aparece un indicador visual de "Clasificación confirmada" con la fecha y hora.

Desconfirmar

Si te has equivocado, puedes pulsar Desconfirmar para volver a editar. Esto solo es posible si no se han jugado partidos en la fase eliminatoria que dependan de esa clasificación.

Mejores clasificados

Si la competición está configurada con mejores clasificados (por ejemplo, "los 4 mejores terceros pasan a octavos"), hay un paso adicional después de confirmar todos los grupos.

1. Espera a que todos los grupos estén confirmados.
2. En la sección de Mejores clasificados, verás una tabla con los equipos elegibles ordenados por sus estadísticas.
3. Si necesitas ajustar el orden, puedes hacerlo manualmente.
4. Pulsa Confirmar mejores clasificados para asignarlos a los slots de la fase eliminatoria.

Los mejores clasificados se comparan entre grupos usando los mismos criterios: puntos, diferencia de goles, goles a favor, goles en contra y, como último desempate, el jugador más joven del equipo.

Fase eliminatoria

Generar el cuadro

1. Ve a la pestaña de la fase eliminatoria.
2. Pulsa Generar cuadro.
3. El sistema crea automáticamente los partidos (octavos, cuartos, semifinales, final...) y conecta los slots.

Cómo funcionan los slots

Cada partido del cuadro tiene dos slots que indican de dónde viene cada equipo. Por ejemplo:

Los slots se rellenan automáticamente cuando confirmas clasificaciones. Si necesitas asignar un slot manualmente, puedes usar el desplegable de cada slot.

Ver el equipo real debajo del slot

Justo debajo de cada desplegable, cuando ya se puede determinar el equipo concreto que ocupará el slot, aparece una línea verde con su nombre, por ejemplo → FC Barcelona.

Esto pasa en estos casos:

• Has confirmado el grupo y el slot apunta a una posición de ese grupo (1º Grupo A, etc.).
• El partido origen (un cuarto, un partido de acceso) ya está finalizado y el slot apunta a su ganador o perdedor.
• Aunque todavía no hayas confirmado el grupo, si todos sus partidos están jugados ya se previsualiza la posición.

Si no aparece nada bajo el dropdown es porque aún no se puede saber qué equipo ocupará ese slot.

Añadir partidos extra (acceso o partidos opcionales)

Una vez generado el cuadro, debajo aparece un único formulario para añadir partidos extra al final o al inicio de la fase. Tiene tres campos:

Partido de acceso (play-in)

Pensado para rondas previas al cuadro principal: por ejemplo, dos terceros de grupo que se enfrentan por la última plaza de cuartos.

• El partido aparece al inicio de la fase final (antes de cuartos/octavos).
• Tiene los mismos dropdowns de local/visitante que cualquier otro partido, así que puedes asignar "3º Grupo A" vs "3º Grupo B" (o lo que toque).
• Su ganador queda disponible en los desplegables de los demás partidos del cuadro como "Ganador Partido de acceso 1".
• Puedes añadir tantos como necesites: el sistema autonumera "Partido de acceso 1", "2", "3"…

Partido opcional

Pensado para partidos que no son parte del cuadro principal pero quieres calendarizar dentro de la fase final: tercer puesto, quinto puesto, finales de consolación, etc.

• Cada partido opcional aparece en su propia sección al final de la fase, con el nombre que le hayas puesto como cabecera.
• Lo configuras igual que cualquier otro partido del cuadro: eliges local y visitante de los dropdowns (por ejemplo, "Perdedor Semifinales 1" vs "Perdedor Semifinales 2" para un tercer puesto).
• Si dejas el nombre por defecto, se autonumera "Partido opcional 1", "2"…

Tanto los partidos de acceso como los opcionales son partidos eliminatorios normales: una vez jugados, su resultado se propaga automáticamente al resto del cuadro como cualquier otro partido.

Registrar resultados eliminatorios

Funciona igual que en la fase de grupos: introduce el resultado y guarda. El ganador avanza automáticamente al siguiente partido del cuadro.

Corregir resultados

Si te equivocas al introducir un resultado (ya sea en grupos o eliminatoria), puedes corregirlo:

1. Busca el partido con el resultado incorrecto.
2. Pulsa el botón Corregir (solo visible para administradores y directores de torneo).
3. Introduce el resultado correcto.
4. Confirma la corrección.

Efecto cascada

Si corriges un resultado en un partido cuyo ganador ya jugó en la siguiente ronda:

• El resultado de la siguiente ronda se borra automáticamente.
• Y si esa ronda alimentaba otra posterior, también se borra.
• El proceso continúa hasta el final del cuadro.

Esto es necesario para evitar inconsistencias. Después de corregir, tendrás que volver a introducir los resultados de las rondas afectadas.

La corrección es una operación importante. El sistema te mostrará un aviso antes de confirmar, indicando cuántos partidos se verán afectados.

Los delegados de campo (match managers) no pueden corregir resultados. Solo pueden introducir resultados nuevos.

Publicar resultados

Puedes compartir los resultados de la competición en directo con cualquier persona, sin que necesite cuenta en la plataforma.

Activar la vista pública

1. Ve a la pantalla de edición de la competición.
2. En la sección Enlace público, verás la URL pública del torneo.
3. Copia el enlace y compártelo.

Vistas disponibles

Cada vista tiene su propia URL. La página de cada competición lleva arriba una barra de pestañas para navegar entre ellas, con la activa marcada en naranja.

Si una competición no tiene fase de grupos, las pestañas "Clasificación" y "Partidos" no aparecen. Si no tiene cuadro eliminatorio, no aparece "Eliminatoria". El visitante solo ve las pestañas con contenido real.

Plegar y desplegar secciones

Dentro de cada pestaña, las secciones (grupos en clasificación/partidos, fases en eliminatoria) empiezan plegadas. Cada cabecera muestra un resumen útil para escanear sin abrir:

• Clasificación: número de equipos.
• Partidos: contador "X / Y jugados".
• Eliminatoria: contador "X / Y jugados" por fase.

Pulsa la cabecera para desplegar. El visitante solo carga visualmente lo que le interesa, lo cual es mucho más rápido en pantallas grandes con muchos grupos o fases.

Insertar en una web externa (iframe)

En la pantalla de edición de la competición encontrarás un bloque con el código iframe listo para copiar. Selecciona la vista que quieres (clasificación, partidos o cuadro) y pega el código en tu web.

Ejemplo de código:

<iframe src="https://tudominio.com/live/mi-torneo/standings" width="100%" height="800" frameborder="0"></iframe>

Auto-refresco

Las vistas públicas se actualizan automáticamente cada 60-120 segundos. No hace falta que el visitante recargue la página: los resultados aparecen solos conforme se van introduciendo.

Roles de usuario

El módulo de competición distingue tres niveles de acceso:

El rol de delegado de campo

Este rol está pensado para personas que están en el campo y necesitan introducir resultados desde el móvil:

• Solo ven los partidos de los torneos que tienen asignados.
• Pueden introducir resultados nuevos.
• No pueden corregir resultados, confirmar clasificaciones ni modificar la configuración.

Para asignar este rol:

1. Ve a la gestión de usuarios.
2. Crea o edita un usuario.
3. Selecciona el rol Delegado de campo (match manager).
4. Asigna los torneos a los que tendrá acceso.
5. Guarda.

Panel de resultados

Los delegados de campo (y también los administradores y directores de torneo) tienen un acceso directo desde el menú principal llamado Panel de resultados. Está pensado para usarlo desde el móvil al pie del campo, pero también funciona como segundo "centro de control" para los admins.

Navegación

El panel está organizado en tres niveles:

1. Torneos: al entrar, ves la lista de torneos a los que tienes acceso, con el número de sedes y partidos pendientes de cada uno.
2. Sedes del torneo: al pulsar un torneo, ves las sedes con partidos asignados, con un contador de partidos pendientes.
3. Partidos de la sede: al pulsar una sede, ves los partidos pendientes primero (ordenados por fecha y hora ascendente) y los finalizados colapsados al final.

Para que un partido aparezca en este panel, debe tener una sede asignada. Los partidos sin sede no se muestran aquí.

Página del partido: guardar y finalizar

Cuando pulsas un partido pendiente, se abre la página individual del partido (ya no es un modal). Tienes dos botones distintos:

Si el partido es eliminatorio y el resultado queda en empate, aparece automáticamente un bloque adicional para introducir el resultado de penaltis.

Aviso al delegado de campo: una vez marcas un partido como finalizado, ya no podrás editarlo. Solo un administrador o director de torneo podrá corregirlo. Asegúrate del resultado antes de pulsar.

Pestaña "Partidos finalizados" (admin / director)

Dentro de un torneo, los administradores y directores ven una pestaña adicional Partidos finalizados con un buscador potente para localizar y corregir resultados ya registrados. Puedes filtrar por:

• Fecha (desde / hasta).
• Categoría del torneo.
• Sede.
• Equipo (vía búsqueda libre).
• Texto libre: busca en el nombre del partido, código, nombre del equipo o del club.

Cada partido finalizado lleva un botón Corregir que abre el mismo flujo de corrección que en la pantalla de competición, con preview de qué partidos de fases finales se verán afectados.

Pestaña "Clasificaciones" (admin / director)

La tercera pestaña, Clasificaciones, replica la funcionalidad de confirmación de clasificaciones de la pantalla de competición pero desde el panel: para cada competición del torneo, muestra:

• Cada grupo con su tabla de clasificación calculada.
• Estado: Pendiente (con contador de partidos jugados), Listo para confirmar, Confirmado.
• Cuando están todos los partidos jugados, lista con drag-and-drop para reordenar empates a mano y botones Guardar orden y Confirmar clasificación.
• Si el grupo está confirmado, botón Deshacer confirmación (solo administrador).
• Sección Mejores rankings cuando la fase final tiene plazas para "mejores 1.os/2.os/3.os/…": una tabla por bucket con todos los candidatos ordenados, y botón Confirmar mejores clasificados una vez todos los grupos están confirmados.

Hay dos vías equivalentes para corregir partidos y gestionar clasificaciones: la pantalla clásica de competición (/competitions/{id}) y este Panel de resultados. Por dentro usan los mismos servicios, así que cualquiera de las dos rutas produce el mismo resultado. Usa la que te resulte más cómoda según el momento.

Errores habituales

• Confirmar la clasificación de un grupo sin revisar los empates.
• Intentar corregir un resultado siendo delegado de campo (no tiene permiso).
• Olvidar confirmar los mejores clasificados antes de empezar la fase eliminatoria.
• Generar el cuadro eliminatorio antes de confirmar todos los grupos.
• Compartir el enlace público equivocado (por ejemplo, el de clasificaciones cuando querías el combinado).