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.