Esquema JSON de planes Universal Fit (v1.0)

Esta referencia describe la forma pública del plan. Los nombres de campos y valores enum se conservan en inglés porque forman parte del contrato de importación.

Principios

1. Amigable para LLMs. Los campos son explícitos y fáciles de leer.
2. Estricto. Las claves desconocidas se rechazan y los errores apuntan a la ruta JSON exacta.
3. Concreto antes que ingenioso. La progresión semanal se escribe con números reales, no fórmulas mágicas.
4. Multimodal desde el inicio. Fuerza, cardio, peso corporal y movilidad son de primera clase.
5. Capas claras. weeks -> days -> blocks -> items -> sets.

Forma principal

{
  "$schema": "https://universalfit.app/schema/v1.0.json",
  "schema_version": "1.0",
  "plan": { /* metadata */ },
  "settings": { /* units, defaults */ },
  "exercises": { /* OPTIONAL inline custom exercises */ },
  "mesocycles": [ /* OPTIONAL phase grouping */ ],
  "weeks": [ /* the program */ ]
}

Reglas clave

• plan.id, plan.name, plan.goal, plan.level, plan.duration_weeks, plan.days_per_week y weeks son obligatorios.
• weeks.length debe coincidir con plan.duration_weeks.
• day es 1-based dentro de la semana y puede no ser consecutivo.
• rest_day: true marca descanso y puede omitir bloques.
• Un item de fuerza tiene exactamente uno de sets o sets_template.
• Un item de cardio usa cardio y no usa sets.

Valores canónicos

goal: strength, hypertrophy, endurance, power, fat_loss, general_fitness, sport_specific, mobility, mixed.

level: beginner, intermediate, advanced.

block.type: warmup, main, accessory, finisher, cooldown, mobility.

Importación

El validador del sitio y la app usan el mismo contrato. Corrige cualquier error de ruta JSON antes de importar el archivo.