Plantillas reutilizables para fases finales

Esta guía explica cómo guardar una fase final (eliminatoria) como plantilla y luego aplicarla en otra competición sin tener que reconstruir todo a mano. Es muy útil cuando varias competiciones de tu torneo usan el mismo cuadro eliminatorio.

¿Para qué sirve esto?

Imagina este caso real: tienes la categoría PREBENJAMÍN con una fase de grupos ya jugada y una fase final con 22 partidos perfectamente configurada (cuartos, semis, partidos de acceso, etc.). Quieres usar exactamente el mismo cuadro para la categoría ALEVÍN, pero sin tocar la fase de grupos del alevín que ya tienes calendarizada.

Antes había que recrear toda la eliminatoria a mano. Ahora:

Guardas la eliminatoria del PREBENJAMÍN como plantilla.
Vas a la competición del ALEVÍN y eliges la plantilla.
El sistema crea la misma estructura de partidos apuntando a la fase de grupos del ALEVÍN.

Importante: la plantilla copia la estructura de partidos (nombres, rondas, "ganador de QF1 vs ganador de QF2", etc.). NO copia fechas, horarios, sedes ni resultados. Eso lo programas en el destino.

Guardar una fase final como plantilla

Entra en la competición que tiene la eliminatoria que quieres reutilizar.
Despliega la fase final que quieras guardar.
En la cabecera de la fase, pulsa Guardar como plantilla.
Ponle un nombre descriptivo (ej. "Cuadro 16 + 7 partidos de acceso") y, opcionalmente, una descripción.
Pulsa Guardar plantilla.

La plantilla queda disponible para todas las competiciones del mismo cliente (no se filtra entre clientes).

Aplicar una plantilla en otra competición

Entra en la competición destino. Debe tener al menos una fase de grupos creada (los equipos no hace falta que estén asignados todavía si la plantilla usa "mejor clasificado", pero sí tiene que existir la fase con sus grupos).
Abre la sección Añadir fase (arriba del todo).
Pulsa la pestaña Desde plantilla de eliminatoria.
Elige la plantilla del desplegable y pulsa Continuar a configuración.
Llegarás a una pantalla de configuración con tres bloques.

Bloque 1: Plantilla

Resumen rápido de qué incluye la plantilla: cuántos partidos, qué grupos referencia y cuántos grupos necesita como mínimo la fase de grupos destino.

Bloque 2: Configuración

Nombre de la fase: el que se le pondrá en el destino. Se precarga con el nombre de la plantilla; puedes cambiarlo.
¿De qué fase de grupos saldrán los equipos?: si la competición destino tiene varias fases de grupos, eliges contra cuál se resolverá la eliminatoria.
Si la plantilla usa "mejor clasificado", aparece un banner azul explicando cómo se repartirán los equipos. Por ejemplo:

"Esta plantilla toma los 9 mejores segundos de la fase de grupos destino."

Bloque 3: Mapeo de grupos (solo si hace falta)

Este bloque aparece únicamente si la plantilla referencia posiciones de grupos concretos (ej. "1º Grupo A vs 2º Grupo B"). Cuando se usa solo "mejor clasificado" o "ganador de partido anterior", el bloque no aparece.

Si aparece, verás una tabla:

Grupo en la plantilla	Equipos en el origen	Grupo de la fase destino
Grupo A	4 equipos	Grupo A (4 eq.)
Grupo B	4 equipos	Grupo B (4 eq.)

Si los nombres coinciden, el sistema precarga el mapeo automáticamente.
Si los nombres son distintos (ej. la plantilla tenía "Grupo A" pero tu competición usa "Norte" / "Sur"), eliges manualmente cada destino del desplegable.

Si dejas algún grupo sin mapear: por defecto el sistema te lo bloquea. Si quieres seguir igualmente y rellenar a mano esos partidos después, marca la casilla "Permitir omitir grupos sin mapear". Los partidos afectados quedarán con plazas pendientes de asignar (igual que si los hubieras creado a mano).

Cuando todo esté listo, pulsa Crear fase final.

Validaciones que hace el sistema

El sistema rechaza la operación (con mensaje claro) en estos casos:

Problema	Mensaje
El grupo destino tiene menos equipos de los que pide la plantilla (ej. la plantilla quería "4º del grupo" pero el destino solo tiene 3 equipos)	"El grupo destino para [nombre] tiene 3 equipos pero la plantilla necesita posición 4."
La fase de grupos destino tiene menos grupos de los que pide un bucket "mejor clasificado"	"La fase de grupos destino tiene 3 grupos, pero esta plantilla necesita al menos 9 grupos para repartir a los mejores clasificados."
La plantilla referencia partidos previos que ya no existen (excepción rara, sólo si la plantilla quedó corrupta)	"La plantilla referencia un partido inexistente."

Limitaciones

La plantilla no copia programación (fechas, horarios, sedes), resultados ni equipos asignados manualmente. Sólo la estructura del cuadro.
Una fase final con 0 partidos no se puede guardar como plantilla.
Las plantillas son por cliente (tenant), no globales: cada cliente tiene su propio listado en /competition-templates.
Al aplicar, la nueva fase final queda con sus partidos pendientes de programar igual que si la hubieras creado a mano: tienes que asignar fechas y sedes antes de jugar.

Diferencia con la plantilla de fase de grupos

Plantilla de grupos	Plantilla de eliminatoria
Guarda los nombres de grupos y las reglas de desempate	Guarda partidos + slots (de qué grupo/posición o partido viene cada uno)
Aplicar la plantilla crea una fase de grupos vacía	Aplicar la plantilla crea una eliminatoria con sus partidos y dependencias resueltas
Requiere asignar equipos manualmente al final	Los equipos se resuelven automáticamente cuando se confirma la fase de grupos destino
Botón en cabecera de fase de grupos	Botón en cabecera de fase final

Listado de plantillas

Desde el menú lateral (administrador o director de torneo), entra en Plantillas. Verás un listado con todas las plantillas guardadas, marcadas como Grupos o Eliminatoria, con el número de grupos o partidos respectivamente. Desde ahí también las puedes eliminar.