TrainerStudio Docs

Sistema de Métricas

El Sistema de Métricas te permite realizar un seguimiento detallado de diferentes mediciones corporales y de rendimiento de tus clientes a lo largo del tiempo, con gráficos de evolución y comparaciones temporales.

Video Demostrativo

Conceptos Básicos

Conjunto de Métricas

Agrupación lógica de métricas relacionadas que se asignan juntas. Ejemplos:

  • "Composición Corporal": Peso, Grasa Corporal, Masa Muscular
  • "Medidas Corporales": Cintura, Cadera, Brazo

Cada conjunto pertenece a tu compañía y puede asignarse automáticamente a nuevos clientes.

Métrica Individual

Medición específica dentro de un conjunto (ej: "Peso" en kg, "Grasa Corporal" en %). Cada métrica tiene un histórico de valores registrados por fecha.


Crear y Gestionar Conjuntos

Crear un Conjunto

  1. Ve a BibliotecaConjuntos de MétricasCrear Nuevo Conjunto
  2. Ingresa el nombre del conjunto
  3. Activa "Asignar automáticamente a nuevos clientes" si lo deseas
  4. Añade métricas (nombre + unidad de medida)
  5. Guarda

Asignar a Clientes

  • Manual: Perfil del cliente → Sección MétricasAsignar Conjunto
  • Automática: Se activa si el conjunto tiene auto-asignación habilitada

Comportamiento al asignar:

  • Si el cliente nunca tuvo el conjunto: se crea con historiales vacíos
  • Si el cliente tenía el conjunto previamente desasignado: se restaura con todo su histórico preservado

Comportamiento al desasignar:

  • El histórico del cliente se preserva completamente
  • El cliente puede seguir viendo su histórico completo
  • No puede registrar nuevos valores hasta que se reasigne el conjunto
  • Si vuelves a asignar el mismo conjunto, recupera todo su histórico anterior

Editar Conjuntos

  • Puedes cambiar el nombre del conjunto en cualquier momento
  • Añadir nuevas métricas: se añaden automáticamente a todos los clientes con ese conjunto
  • Editar nombre/unidad de métricas: los cambios se reflejan inmediatamente
  • Eliminar métricas: se archivan (ver sección de archivado)

Registro de Valores

Por el Cliente

Los clientes pueden registrar valores de dos formas:

  1. Desde Progreso: Selecciona conjunto → métrica → Añadir Registro → ingresa fecha y valor
  2. Desde Rutina: Si incluyes métricas en la rutina del día, aparece un formulario con todas las métricas del conjunto

Nota: Si el cliente completa todas las métricas del conjunto en el mismo día, el item se marca automáticamente como completado.

Por el Entrenador

También puedes registrar valores en nombre de tus clientes:

  1. Perfil del cliente → Sección Métricas → Selecciona métrica → Añadir Valor
  2. Ingresa fecha y valor → Guarda

Visualización

  • Vista de Conjunto: Lista todas las métricas con valor inicial y actual
  • Vista de Métrica Individual: Gráfico de evolución temporal + lista de valores + estadísticas (inicial, actual, máximo, mínimo)
  • Filtros: Últimos 7 días, 3 meses, año, o todo el histórico

Archivado de Métricas

El archivado permite "ocultar" métricas sin perder los datos históricos.

Comportamiento

Métricas archivadas:

  • ❌ Los clientes pierden acceso completamente a la métrica
  • ❌ No pueden ver ni registrar valores
  • ✅ Puedes restaurar la métrica cuando quieras

Conjuntos archivados:

  • ❌ Los clientes pierden acceso completamente al conjunto
  • ❌ No pueden ver ni registrar valores
  • ❌ No se asignan automáticamente a nuevos clientes

Proceso

Al eliminar una métrica o conjunto, el sistema muestra una advertencia con el impacto (cuántos clientes afectados, rutinas usadas, etc.). Al confirmar, se archiva pero el histórico se preserva.


Preguntas Frecuentes

¿Puedo eliminar permanentemente una métrica?

No directamente. El sistema usa archivado para preservar los datos históricos. Si necesitas eliminación permanente, contacta con soporte.

¿Qué pasa si archivo un conjunto usado en rutinas activas?

El conjunto se archiva, pero las rutinas siguen existiendo. Los items de métricas mostrarán que el conjunto está archivado. Puedes reasignar otro conjunto o restaurar el original.

¿Los clientes ven métricas archivadas?

No. Cuando un conjunto está archivado, los clientes pierden acceso completamente y no pueden ver ni registrar valores. Si restauras el conjunto más adelante, los clientes recuperarán el acceso y todo su histórico se mantendrá intacto.

¿Qué pasa con los datos si desasigno un conjunto?

El histórico del cliente se preserva completamente. El cliente puede seguir viendo todos sus registros históricos, pero no puede añadir nuevos valores. Si vuelves a asignar el mismo conjunto más adelante, el cliente recupera automáticamente todo su histórico anterior.

¿Puedo tener múltiples conjuntos con el mismo nombre?

No, el nombre del conjunto debe ser único dentro de tu compañía. Pero puedes tener métricas con el mismo nombre en diferentes conjuntos.


Documentación Técnica

Si eres desarrollador y necesitas entender la implementación técnica del sistema de métricas (arquitectura, endpoints, modelos de datos), consulta la documentación técnica en back/docs/metrics-implementation.md del repositorio.


TrainerStudio - Seguimiento preciso, progreso visible

On this page