Psicología

TL;DR

Módulo del psicólogo del club: registro de sesiones con scores de ánimo, motivación y ansiedad (1-10), tendencia semanal del equipo, grilla por jugador ordenada por riesgo psicológico y detección de jugadores sin sesión en los últimos 14 días. Las notas clínicas están protegidas por rol (sólo psi y hop las ven).

Para comercial

• Problema que resuelve: la salud mental del plantel históricamente no tiene un registro sistemático. CÉNIT le da al psicólogo un tracker simple (3 scores + notas) que se conecta al perfil del jugador y al panel de riesgo del HoP.
• Casos de uso típicos: seguimiento semanal de la plantilla, identificación de jugadores en riesgo (mood < 4, motivation < 4, anxiety > 3.5), señal temprana antes de que el problema escale al cuerpo técnico.
• Planes: gated por feature flag module_psychology.
• Diferenciador: privacidad de notas por rol (el director deportivo ve scores agregados pero no las notas clínicas — sólo psi y hop), tendencias semanales del equipo (get_mental_weekly_trends) y card de “psych risk” calculado en el cliente con thresholds explícitos.

Cómo lo usa el staff

Acceso y permisos

• Roles con acceso: psi, hop, dir, coord_form (shell nav).
• Notas clínicas: visibles sólo para psi y hop. El dir y el coord_form ven scores y agregados pero los notes se devuelven como null (filtro server-side en psicologia/page.tsx).

Flujos paso a paso

• Registrar sesión: jugador, fecha, tipo de sesión, scores 1-10 de ánimo / motivación / ansiedad, notas. Guarda en mental_records.
• Mirar tendencia semanal: línea de avg mood / motivation / anxiety del equipo por semana (RPC get_mental_weekly_trends).
• Grilla por jugador: ordenada por riesgo psicológico descendente (alto: anxiety > 3.5 || mood < 4 || motivation < 4 ; medio: anxiety > 2 || mood < 7 || motivation < 7 ; sin datos en 14 días: medio-bajo).
• Inactivos: lista de jugadores sin sesión en >14 días (o nunca registrada).
• Borrar registro: deleteMentalRecord(id).

Configuración relacionada

• Plan debe incluir module_psychology.

FAQ / casos límite

• Si un jugador está en RTP (tiene fila en rtp_phases), aparece marcado en la grilla — útil para priorizar atención en lesionados.
• Las notas no se borran al ocultarlas por rol: se filtran en server (canSeeNotes en psicologia/page.tsx) antes de mandarlas al cliente.

Cómo lo ve el jugador

Player surface: N/A. El jugador no ve sus scores ni notas. Es información clínica del staff. Si en el futuro se decide darle al jugador un autorreporte simple, sería un formulario nuevo en /player.

Datos y métricas

Thresholds de riesgo psicológico (hardcoded en psicologia/page.tsx)

• Alto: anxiety > 3.5 || mood < 4 || motivation < 4.
• Medio: anxiety > 2 || mood < 7 || motivation < 7.
• Sin datos en 14 días: medio-bajo (score 2).
• Resto: bajo (score 0).

Tablas DB / RPCs

• mental_records — sesiones (player_id, record_date, session_type, mood_score, motivation_score, anxiety_score, notes).
• rtp_phases — para marcar jugadores en retorno al juego.
• RPC get_mental_weekly_trends(p_player_ids) — tendencia semanal agregada del equipo.

Integraciones

• Plantel: revalida /dashboard/plantel cuando hay un registro nuevo.
• Risk Advisor: no entra al score de riesgo combinado hoy, pero los datos están listos por si se decide sumarlo.

Limitaciones / roadmap

• Los thresholds están hardcoded — no configurables por org todavía.
• No hay export ni informe específico de psicología (se cubre desde el informe HoP semanal cuando aplica).
• ai_natural_language_insights está prometido en planes Pro/Enterprise pero no implementado (ver PROJECT_STATE.md).