/docs · Vetta Trainer

Comment fonctionne le moteur

Pas de boîte noire. On t'explique exactement comment le moteur Vetta construit ta semaine : archétypes, philosophies, périodisation, prévention des blessures. Si tu le comprends, tu peux en discuter avec ton coach.

Archétypes paramétriques

Le moteur ne porte pas de bibliothèque d'entraînements fixes. Il porte 66 archétypes paramétriques — des modèles avec des plages. Par exemple l'archétype « côte longue Z2 » a une plage de durée 45-90 min, intensité Z2 (75% LTHR), dénivelé 200-600 m.

À l'instanciation, l'archétype est rempli avec des valeurs spécifiques pour toi : durée 60 min, FC cible 145-152 bpm, D+ 350 m. Chaque semaine les variantes sont différentes — tu ne vois jamais deux fois la même séance.

Philosophies comme systèmes de poids

13 philosophies codées en dur : Daniels VDOT, Lydiard, Kilian montagne, Coggan puissance, sweet-spot, polarisé classique, Norwegian threshold (Ingebrigtsen/Bakken), MTB XC, natation CSS, triathlon classique, ultra Koop, polarisé cyclisme, magness.

Une philosophie n'est PAS une bibliothèque séparée d'entraînements. C'est un profil de poids sur les mêmes 66 archétypes. Le polarisé classique tape fort dans les Z2 et Z4-5, quasi zéro Z3. Le sweet-spot s'appuie sur le bas du Z3. Même structure ; poids différents.

Périodisation par phase

Quatre phases : base, build, peak, taper. La phase est choisie automatiquement selon les jours qui te séparent de ta prochaine course A (si tu as un objectif chargé).

Chaque phase module le volume et le mix de familles. Base privilégie endurance et strength_endurance. Build pousse threshold et VO2max. Peak affine le race-specific. Taper réduit le volume 22-38% (course -22%, vélo -38%, natation -35%) et filtre long + strength_endurance.

ramp_seguro : prévention des blessures

Le moteur ne propose jamais un saut de volume hebdomadaire supérieur à +8%. La règle des 10% est populaire mais l'évidence (Gabbett 2016) montre que <10% est la zone sûre, pas exacte. Vetta utilise +8% pour avoir de la marge.

Si ton ACWR > 1.3 pendant 5+ jours consécutifs sur les 2 dernières semaines, le moteur te suggère automatiquement une semaine de décharge (-25 à -30% de volume).

Seed déterministe par semaine

Deux visites au même /training dans la même semaine ISO retournent la MÊME semaine. Pas d'aléatoire caché — le seed est fonction de (user_id, année_iso, semaine_iso, phase, philosophie, jours_par_semaine).

Tu changes un paramètre (plus de jours par semaine, autre philosophie, autre phase) → la semaine change. Tu gardes les paramètres → la semaine reste stable du lundi au dimanche.

Inventaire et contraintes du monde réel

Chaque archétype déclare son `requiere` (équipement nécessaire). Le moteur ne prescrit que ce que tu as effectivement coché dans ton profil.

Si ton inventaire dit « pas de vélo » ou « vélo indisponible jusqu'au 2026-06-15 » (vacances, déplacement, roster Veladero), le moteur exclut les archétypes vélo jusqu'à cette date et les réactive automatiquement à l'expiration.

Zones : FC vs allure vs puissance vs CSS

Chaque archétype déclare l'intensité comme un token de zone (Z1..Z5b, P1..P7 cyclisme, S1..S5 natation). Le moteur résout ces tokens en chiffres concrets à l'instanciation, selon ton `zone_mode` et les données disponibles.

Détails du calcul des zones sur /docs/zonas. En bref : FC par Karvonen reserve, allure par Daniels VDOT, puissance par % FTP (Coggan), CSS par test 400+200 m.

Où le moteur n'aide PAS

Le moteur ne remplace PAS un coach humain pour les corrections techniques (foulée, technique de natation, gestion émotionnelle avant course). Cette partie reste humaine.

Le moteur ne prend pas non plus de décisions qui nécessitent un historique clinique (blessures récurrentes, allergies, grossesse). Quand ta situation est médicale, parle à un pro, pas à l'app.