Alertes & surentraînement

EnduranceHub combine plusieurs signaux pour détecter un risque de surentraînement. Aucun indicateur isolé n'est fiable : le surentraînement se manifeste par la convergence de plusieurs marqueurs simultanément. L'approche multi-signaux réduit considérablement les faux positifs par rapport à un seuil unique.

Le score agrégé (0-4) correspond au nombre de signaux simultanément actifs parmi les 4 de la formule ci-dessous ; l'alerte « risque de surentraînement » ne se déclenche qu'à partir de 2 signaux (warning à 2, danger à 3+). À ne pas confondre avec le compteur d'alertes total affiché en valeur live, qui additionne aussi des alertes contextuelles (sommeil court, fitness en baisse, inactivité, série positive). En complément, des alertes individuelles (sommeil insuffisant, FC repos élevée, streak d'entraînement) sont affichées séparément : elles enrichissent le diagnostic sans entrer dans le score. Alertes wellness individuelles : low_hrv et high_resting_hr exigent 3 jours consécutifs hors de ta plage habituelle avant déclenchement. Depuis le 06/08/2026, « hors de ta plage » veut dire à plus de 1 écart-type (σ) de ta baseline 60 jours — vers le bas pour la HRV, vers le haut pour la FC de repos. Les anciens pourcentages fixes (−15 % et +5 %) traitaient à l'identique un athlète très régulier et un athlète naturellement variable ; l'écart-type s'adapte à toi. Le délai de 3 jours supprime ~30 % des faux positifs liés à la volatilité nocturne.

Les alertes sont recalculées à chaque sync. Une alerte peut rester active plusieurs jours tant que les signaux ne reviennent pas dans leur zone normale (ex : HRV remonte, CTL stabilisé). Les alertes wellness individuelles (low_hrv, high_resting_hr) requièrent 3 jours consécutifs avant déclenchement — un jour isolé bas ne suffit plus.

Le score cumule 4 signaux binaires : HRV Drop (moyenne 5 j à plus de 1 σ sous ta baseline 60 j), Humeur basse, CTL en déclin avec une fraîcheur sous −20 % de la CTL, ACWR au-dessus du seuil danger sport-spécifique. Le seuil est relatif (et non un TSB absolu de −15) : un seuil absolu ratait les athlètes à CTL élevée en déclin réel, et se déclenchait à tort chez les CTL basses. Distinct des alertes individuelles low_hrv / high_resting_hr qui appliquent le délai 3 jours consécutifs (DU-13).

Source : Multi-signaux adaptés — backend/app/services/alert_engine.py::compute_all_alerts

• Nécessite des données wellness régulières (HRV, humeur) : sans aucune donnée wellness sur 30 jours, le score multi-signaux n'est pas calculé du tout (l'alerte de surentraînement ne se déclenche pas). Avec wellness partiel, un signal n'est compté que si assez de données existent pour le calculer de façon fiable.
• Le seuil en écarts-types s'adapte à ta variabilité, mais il suppose une distribution à peu près régulière : après une longue coupure ou un changement de capteur, la baseline met ~2 mois à se reconstituer.
• La fenêtre 5j vs 30j peut masquer une dérive lente (mois en surcharge progressive).
• Le délai 3 jours consécutifs sur low_hrv/high_resting_hr retarde la détection d'une fatigue aiguë d'1 à 2 jours — contrepartie assumée de la réduction des faux positifs.
• Les alertes ne remplacent jamais l'avis d'un médecin du sport en cas de symptômes persistants.