Saltar al contenido

Conceptos y glosario

El vocabulario de fitness y plataforma que usa verxion, definido una vez para que el resto de docs se mantenga corto.

Este es el vocabulario compartido que asume el resto de la documentación. Léelo una vez.

Entrenamiento

Serie, serie efectiva, serie avanzada

Una serie es un grupo de repeticiones realizado de un tirón. Una serie efectiva es una serie real y fatigante hacia tu volumen objetivo (los calentamientos no cuentan). Una serie avanzada es una serie con estructura extra: drop sets, rest-pause, supersets, pirámides, giant sets, AMRAP. verxion las registra todas como ciudadanas de primera.

RPE / RIR

RPE (Rate of Perceived Exertion) es una escala 1-10 de lo dura que se sintió la serie. RPE 10 es fallo; RPE 8 es “podría hacer dos repes limpias más.” RIR (Reps in Reserve) es la misma idea invertida: RIR 2 = “dos más en el tanque.” verxion acepta cualquiera de las dos — ambas se guardan.

Peso de trabajo (working weight)

El peso más pesado usado en una serie. En series rectas, es simplemente la carga. En drop sets, es la carga superior antes de bajar. En rest-pause, es la carga de la pesada inicial. verxion usa el peso de trabajo para los PRs.

Volumen

Trabajo total realizado, normalmente como series × reps × peso. Se trackea por ejercicio, grupo muscular, sesión, semana y mes.

PR (récord personal)

El peso más pesado registrado para un ejercicio dado. verxion trackea PRs automáticamente conforme registras.

Rutina vs día de entreno vs sesión

  • Rutina: tu plan semanal (p. ej. “Push Pull Legs”)
  • Día de entreno: un día dentro de la rutina (p. ej. “Push A”)
  • Sesión: un entrenamiento real — un día de entreno ejecutado en una fecha concreta

Programa

Un programa envuelve varias rutinas en un bloque periodizado (p. ej. programa de fuerza de 12 semanas con fases). Los programas gestionan deloads y transiciones de fase automáticamente.

Deload

Una reducción planificada del estrés de entrenamiento — menos peso, menos volumen o ambos — para recuperar antes del siguiente empuje. verxion trackea los deloads aparte para que no arrastren tus líneas de tendencia hacia abajo.

Mesociclo

Un bloque de entrenamiento (normalmente 3-6 semanas) con un foco coherente — hipertrofia, fuerza, peaking. Los programas se componen normalmente de mesociclos.

Nutrición

Plan de dieta (diet plan)

Un blueprint de macros diarios (kcal, proteína, carbohidratos, grasa) y las comidas que los componen. Los planes pueden estar activos, en pausa o archivados; solo uno está activo a la vez.

Meal log

Un registro de lo que comiste realmente, incluyendo macros, fuentes y horario. Los meal logs son independientes de los diet plans — puedes registrar sin plan.

Macros

Macronutrientes: proteína, carbohidratos, grasa. verxion trackea los tres más las kcal totales por comida y por día.

NEAT / TEF / TDEE

  • NEAT: Non-Exercise Activity Thermogenesis — kcal quemadas fuera del entreno (caminar, fidgeting, etc.)
  • TEF: Thermic Effect of Food — kcal quemadas digiriendo
  • TDEE: Total Daily Energy Expenditure — todo combinado; el objetivo contra el que calibra tu plan

Refeed

Un día planificado de carbohidratos altos durante un déficit para restaurar glucógeno y hormonas. verxion soporta refeeds programados en el plan o activados manualmente.

Adherencia

Cómo de cerca encaja tu ingesta real con el plan. Se calcula a diario y se agrega semanalmente. Adherencia por encima del 80% es “en plan”; por debajo del 50% es “fuera de plan”.

Plataforma

MCP

Model Context Protocol — el estándar abierto para conectar asistentes de IA con tools y fuentes de datos. verxion está construido sobre MCP desde la base.

Tool

Una función que tu agente de IA puede llamar (p. ej. “registra esta serie”, “enséñame mi última sesión”). verxion entrega un catálogo amplio de tools, agrupadas bajo perfiles MCP.

Perfil (perfil MCP)

La forma del catálogo de tools expuesto a tu cliente: Code Mode (una tool, por defecto), Code Mode UI (una tool + widgets, para ChatGPT), Full (cada tool individualmente).

Scope

Una puerta de permiso OAuth. Cada llamada a tool se chequea contra los scopes que lleva tu token. Ver Scopes OAuth.

Snapshot

Una vista consolidada de un periodo de tiempo — normalmente un mes. Los snapshots incluyen totales, deltas vs el periodo anterior y una narrativa generada por IA. Se generan automáticamente el día 1 de cada mes.