Ir al contenido

Glosario

Este glosario reúne las siglas y términos que aparecen en CÉNIT y en los módulos de carga, wellness, riesgo, fisio y rendimiento. Es la fuente de verdad terminológica: cuando otra página use un término distinto, el canon es esta. Si te falta uno, agregalo acá y abrí PR.

Cociente entre la carga aguda (últimos 7 días) y la carga crónica (últimos 28 días). Se interpreta como una “preparación relativa”: un ACWR cercano a 1.0 indica que la semana actual está en línea con el historial reciente; valores por debajo de 0.8 (undertraining) o por encima de 1.5 (spike) se asocian con mayor riesgo de lesión. En CÉNIT se calcula por jugador y por métrica (distancia, HSR, sprint, HMLD), siempre en m/día desde migration-095.

Cada organización elige el método de cálculo vía organizations.acwr_method:

  • rma (default): rolling-mean. Numerador y denominador son promedios simples sobre la ventana.
  • ewma: exponentially-weighted moving average (Williams 2017), con λ_acute = 0.25 y λ_chronic ≈ 0.069. Da más peso a los días recientes.

Los thresholds de alerta (risk_acwr_* en organizations) son configurables por org y los consume compute_daily_risk_snapshots.

Carga acumulada en los últimos 7 días, expresada en m/día (es decir, total de la métrica dividido entre los 7 días de la ventana). Es el numerador del ACWR.

Carga acumulada en los últimos 28 días, también en m/día. Representa la base de adaptación reciente del jugador y es el denominador del ACWR.

EWMA — Exponentially Weighted Moving Average

Sección titulada «EWMA — Exponentially Weighted Moving Average»

Método alternativo al rolling-mean para calcular ACWR (Williams 2017). En CÉNIT está implementado en get_acwr_ewma y get_acwr_ewma_batch y se activa por organización con acwr_method = 'ewma'. Constantes: λ_acute = 0.25, λ_chronic ≈ 0.069.

Método clásico (default) para ACWR: promedios simples sobre los últimos 7 y 28 días. Es lo que produce get_acwr / get_acwr_batch.

Carga interna percibida de una sesión: minutos de sesión × RPE (1-10). Se usa como proxy de carga cuando no hay GPS disponible.

Escala 1-10 que el jugador completa al final de la sesión para indicar cuán exigente la percibió. Es uno de los componentes del sRPE y entra en el cuestionario diario de wellness.

GPS — Global Positioning System (carga externa)

Sección titulada «GPS — Global Positioning System (carga externa)»

Datos de carga externa capturados por dispositivos GPS (Catapult, StatSports, etc.) e importados a CÉNIT vía CSV o Excel. Se persisten en gps_sessions (sesiones) y gps_player_data (métricas por jugador).

Distancia recorrida por encima de un umbral de velocidad alta (default >19,8 km/h, configurable por club). Métrica clave de intensidad acumulada.

Distancia recorrida por encima del umbral de sprint (default >25,2 km/h, configurable). Se reporta separada del HSR para detectar acciones explosivas.

Distancia recorrida en momentos de alta demanda metabólica (potencia metabólica ≥25,5 W/kg, Osgnach 2010). Combina aceleraciones, desaceleraciones y velocidad. En CÉNIT, HMLD reemplazó a player_load en la UI de Carga; la columna player_load se dropeó en migration-105.

Métrica de sesión expresada como porcentaje respecto a la referencia partido del jugador (la “demanda partido” o match demand). La referencia se calcula con get_md_reference_per_player usando mean(top_3) con sistema de tiers y cascada de fallback (ver T1/T2/T3 abajo), sobre una ventana configurable por organización (organizations.md_max_window_days, default 90 días, rango 90-360). La RPC legacy get_md_max_per_player fue dropeada en migration-100.

Clasificación de las apariciones de un jugador en partido para construir su referencia (get_md_reference_per_player):

  • T1 — titular pleno: ≥ 75 minutos jugados.
  • T2 — jugó parcial: 45-74 minutos.
  • T3 — entró desde el banco: 15-44 minutos.
  • Excluido — menos de 15 minutos (ruido, no se considera).

La cascada de fallback evalúa primero T1, si no hay datos suficientes baja a “rotativo” (T1+T2), luego “suplente” (T1+T2+T3), luego “limited” y finalmente null. Esto evita que un jugador sin titularidades nunca tenga referencia.

Velocidad máxima alcanzada por el jugador en una ventana temporal (función get_vmax_per_player). Se usa como referencia individual para umbrales relativos de HSR/Sprint si el club los adopta.

Porcentaje de la Vmax alcanzada en una sesión sobre el peak all-time del jugador. Calculada por get_vmax_pct_batch. Tiene dos guardrails:

  • Gate de baja exposición: jugadores con menos de 5 sesiones registradas devuelven NULL (no hay base estadística confiable).
  • Decay para veteranos: jugadores con edad ≥ 30 años usan como peak el MAX de los últimos 12 meses (no el histórico completo).

Métrica acumulada de carga calculada por el GPS sobre aceleraciones en los tres ejes. CÉNIT la dejó de mostrar en favor de HMLD y la columna fue eliminada de gps_player_data en migration-105.

Formato de import principal de carga GPS. Cada proveedor (Catapult, StatSports, Tachira/Excel custom) tiene un parser dedicado en /dashboard/carga.

Cuestionario diario de cuatro ítems (1-7 cada uno): calidad de sueño, fatiga, estrés y dolor muscular. La suma da el índice de Hooper (rango 4-28, donde mayor = peor). Se persiste en wellness_entries y es la base del módulo Wellness y un input del Risk Advisor.

Mapa corporal donde el jugador marca zonas de dolor con intensidad. Cada zona se guarda en body_pain_entries ligada al registro diario de wellness.

La semana de entrenamiento entre partidos. CÉNIT calcula el microciclo a partir de los partidos del calendario y expone get_microcycle_day para etiquetar cada día con su MD-N.

Convención para nombrar los días del microciclo respecto al próximo partido. MD es el día del partido, MD-1 el día previo, MD+1 el día posterior, etc. La agenda del jugador (/player/agenda) usa esta nomenclatura simplificada en vez de tipos de evento concretos (training/match/recovery).

Lista de jugadores convocados a un partido o evento. En CÉNIT se marca desde el calendario, multi-jugador, y queda registrada en calendar_events + relaciones por jugador.

Proceso por fases para devolver a un jugador lesionado al juego competitivo. Cada fase queda en rtp_phases y la pestaña Fisio permite armarlas con plantillas (fisio_protocol_templates, fisio_protocol_instances).

Cada lesión en injuries registra dónde ocurrió: match, training u other. Esto alimenta el cálculo de tasa de lesiones y el informe HoP.

Una ausencia a una sesión queda con uno de estos motivos: injury, illness, personal, load_management, tactical, national_team, other. La razón impacta el cálculo de carga y los reportes.

Rol con acceso total a la organización (hop). Es típicamente quien firma el informe semanal y configura settings. Ver Roles del staff.

Rol sc: preparador físico. Tiene acceso al condicional, dashboard y calendario (con permisos de creación/edición/copia de sesiones).

Modo de instalación de CÉNIT en el dispositivo del jugador o staff. Habilita push notifications y modo offline básico vía service worker. Ver PWA & Push.

Mecanismo de Supabase/Postgres para aislar filas por organización. CÉNIT depende 100% de RLS para el aislamiento multi-tenant. Ver Multi-tenant.

Función SQL en Supabase que se invoca desde TS con supabase.rpc('nombre', { params }). CÉNIT tiene RPCs para ACWR, %MD, Vmax%, agregación semanal y microciclo. Casi todas son SECURITY DEFINER con search_path acotado y RLS hardening por p_organization_id.

IA — Inteligencia Artificial (Anthropic SDK)

Sección titulada «IA — Inteligencia Artificial (Anthropic SDK)»

Se usa en tres lugares con @anthropic-ai/sdk (modelo claude-haiku-4-5-20251001): parser de PDFs de partidos, Risk Advisor (recomendación solo pro/enterprise) y predicción de carga multi-métrica. Ver IA & Anthropic.