Clubes
Los clubes representan las organizaciones deportivas dentro de tu cuenta. Jugadores, entrenadores, árbitros, parejas de dobles y equipos pueden estar asociados a un club. La pertenencia al club se muestra en rankings, directorios de jugadores y resultados de partidos.
Los clubes soportan una estructura jerárquica mediante tipos de club, permitiendo modelar relaciones como Federación → Asociación → Club → Sub-sede.
Conceptos clave
Estructura de un club
Cada club tiene los siguientes atributos:
| Campo | Requerido | Descripción |
|---|---|---|
| Nombre | Sí | El nombre completo del club (p. ej., "Club Deportivo San Martín") |
| Código | Sí | Un identificador corto mostrado en rankings y listas (p. ej., "CDSM") |
| Descripción | No | Una breve descripción del club |
| Deporte | Sí | El deporte principal asociado al club |
| Logo (Avatar) | No | El escudo o logo del club |
| Tipo de club | No | El tipo jerárquico al que pertenece (ver sección Tipos de Club) |
| Club padre | No | Referencia a un club superior en la jerarquía |
Roles de personas en un club
Un club puede tener personas asociadas en 5 roles diferentes:
| Rol | Descripción |
|---|---|
| Jugador | Jugadores individuales afiliados al club |
| Entrenador | Entrenadores que trabajan con el club |
| Árbitro | Árbitros asociados al club |
| Doble | Parejas de dobles que representan al club |
| Equipo | Equipos que compiten bajo el nombre del club |
Cada asociación persona-club incluye opcionalmente un vínculo a un ranking específico.
Tipos de club (Jerarquías)
Los tipos de club definen la estructura organizacional de tu organización deportiva. Permiten clasificar clubes en niveles jerárquicos.
Concepto de jerarquía
Los tipos de club forman un árbol jerárquico donde:
- Cada tipo tiene un nivel numérico (1 = nivel más alto)
- Cada tipo puede tener un tipo padre (debe ser de un nivel inferior numéricamente, es decir, más alto en la jerarquía)
- Los clubes asignados a un tipo solo pueden tener como club padre a un club cuyo tipo sea el tipo padre del suyo
Ejemplo de jerarquía:
Nivel 1: Federación
└── Nivel 2: Asociación Regional
└── Nivel 3: Club
└── Nivel 4: Sub-sede
Crear un tipo de club
- Ve a Dashboard → Clubes → Tipos.
- Haz clic en Agregar tipo.
- Completa:
| Campo | Requerido | Descripción |
|---|---|---|
| Nombre | Sí | Nombre del tipo (p. ej., "Federación", "Club", "Sub-sede") |
| Código | Sí | Identificador corto (p. ej., "FED", "CLUB", "SUB") |
| Nivel | Sí | Número que indica la posición en la jerarquía (mín. 1) |
| Tipo padre | No | El tipo inmediatamente superior (solo tipos con nivel menor) |
- Haz clic en Guardar.
Reglas de la jerarquía
- Un tipo padre solo puede ser un tipo con nivel menor (más alto en la jerarquía).
- Si un tipo está en uso por algún club, no puede eliminarse (error:
CLUB_TYPE_IN_USE). - No se permiten jerarquías inválidas (error:
INVALID_CLUB_TYPE_HIERARCHY).
Editar o eliminar un tipo de club
- Ve a Dashboard → Clubes → Tipos.
- Los tipos se muestran ordenados por nivel.
- Haz clic en el ícono de edición para modificar o en eliminar para borrar.
Importante: No se puede eliminar un tipo que está siendo utilizado por al menos un club.
Crear un club
- Ve a Dashboard → Clubes.
- Haz clic en Crear club o el botón +.
- Completa los campos:
| Campo | Requerido | Descripción |
|---|---|---|
| Logo | No | Imagen del escudo o logo del club |
| Nombre | Sí | El nombre completo del club |
| Código | Sí | Identificador corto (se muestra en rankings y tablas) |
| Descripción | No | Descripción breve del club |
| Deporte | Sí | Seleccionar el deporte principal |
| Tipo de club | No | Seleccionar el tipo jerárquico |
| Club padre | No | Seleccionar el club padre (solo disponible si el tipo tiene padre) |
- Haz clic en Guardar.
Lógica del club padre
El campo Club padre solo aparece cuando:
- Se selecciona un tipo de club que tiene un
parentTypeIddefinido. - La lista de clubes padre se filtra mostrando solo clubes cuyo tipo coincida con el
parentTypeIddel tipo seleccionado.
Ejemplo: Si seleccionas el tipo "Club" (nivel 3, padre: "Asociación Regional"), solo se mostrarán como opciones de club padre aquellos clubes que tengan el tipo "Asociación Regional".
Editar un club
- Ve a Dashboard → Clubes.
- Haz clic en el ícono de edición (lápiz) en la fila del club.
- Modifica los campos necesarios.
- Haz clic en Guardar.
Se pueden actualizar todos los campos, incluyendo cambiar el tipo de club y el club padre.
Eliminar un club
- Ve a Dashboard → Clubes.
- Haz clic en el ícono de eliminar (papelera) en la fila del club.
- Escribe "delete" en el diálogo de confirmación.
- Confirma la eliminación.
Nota: Las personas asociadas al club eliminado tendrán su campo de club limpiado.
Filtros y búsqueda
La lista de clubes incluye las siguientes herramientas de filtrado:
| Filtro | Descripción |
|---|---|
| Búsqueda | Filtra por nombre del club |
| Deporte | Filtra clubes por deporte asociado |
| Ordenar por | Ordena por nombre (ascendente o descendente) |
La tabla de clubes muestra las columnas: Logo, Nombre, Código, Descripción, Tipo de club, Club padre y Acciones.
Asignar personas a un club
La asignación de club se hace desde el perfil de la persona:
- Ve a Dashboard → Personas.
- Abre el perfil del jugador, entrenador o árbitro.
- Encuentra el campo Club.
- Selecciona el club usando el selector (incluye búsqueda por nombre o código).
- Guarda.
El selector de club permite buscar por nombre o código y muestra un popover con la lista filtrada.
Cómo aparecen los clubes en la plataforma
- En rankings: Los códigos de club de los jugadores aparecen junto a sus nombres en las posiciones.
- En directorios de jugadores: La afiliación de club es visible en el perfil de cada persona.
- En filtros de ranking: Los visitantes pueden filtrar el ranking por club para ver solo los jugadores de un equipo específico.
- En resultados de partidos: La afiliación de club puede aparecer en los displays de marcador.
- En la tabla de clubes del dashboard: Se muestra la relación jerárquica (tipo y club padre).
Límites y notas
- Los clubes están limitados a tu cuenta. Si tu federación tiene clubes afiliados que también son cuentas separadas en la plataforma, las entradas de club en cada cuenta son independientes.
- Existe un límite de clubes por cuenta según el plan contratado. Si se excede el límite, se mostrará un error al intentar crear un nuevo club.
- La paginación de la lista soporta hasta 50 clubes por página.