Crise, forme et conseils

Alertes de risque de crise et limite de notification

Si tu l'as activée, Trévor t'écrit chaque matin vers 8 h quand ton risque de crise atteint 70 % sur des mesures fraîches. Une alerte douce facultative existe dès 40 %. Il n'envoie jamais plus d'un message d'alerte par jour, et il retient le message pendant les heures calmes.

Où tu le vois : Message du bot reçu le matin (un message neutre avec un bouton « Ouvrir » sur l'écran verrouillé, puis le contenu), suivi d'un second message « Deux conseils pour maintenant ». Les boutons « Activer l'alerte du matin (si risque ≥ 70) » et « Me prévenir dès le risque modéré (40 %) » sont dans l'écran « Mon risque de crise ». Les soignants voient aussi une ligne d'alerte « Risque de crise calculé X % » dans le tableau de bord quand le score est de 70 ou plus.

Ce que l’algorithme lit

• Le risque de crise du jour (score, fraîcheur, explications), calculé comme sur la page publique du risque de crise (montre, déclaration, dossier)
• Ton choix d'activer l'alerte du matin, et ton choix d'activer l'alerte douce dès 40 % (réglage)
• Date de la dernière alerte envoyée (état de Trévor)
• Heures calmes (par défaut de 22 h à 7 h, heure locale) et fuseau horaire (réglage)

Le calcul, étape par étape

Les valeurs utilisées

Ce qui est affiché

Au plus un message d'alerte par jour. Alerte « élevé » (score de 70 ou plus) : « Risque de crise ce matin : X % (élevé). Signaux : … », puis des gestes (boire environ 1,5 à 2 litres, se reposer au chaud, éviter les efforts intenses) et les cas où contacter l'équipe soignante ou appeler le 144 (douleur qui monte, fièvre au seuil, essoufflement). Alerte douce (de 40 à 69, si activée) : « Ton risque de crise monte un peu : X % ce matin (modéré). Signaux : … », avec la phrase « Rien d'alarmant à ce stade ». Les deux messages se terminent par « Cette fonction est expérimentale et ne vaut pas avis médical ». Le second message donne les deux premiers gestes de « Que faire maintenant ? ».

Un exemple chiffré

Score du matin à 72 %, mesures datées d'hier, alerte du matin activée, aucune alerte envoyée aujourd'hui : le score atteint 70, le message « élevé » part, et la date du jour est enregistrée. À 8 h 30, aucun second message ne part même si le score monte à 85. Autre cas : 45 % sans alerte douce activée, aucun message. Avec l'alerte douce activée, le message doux part. Autre cas : 75 % mais mesures de 4 jours, rien ne part. Aucun résultat chiffré n'a été exécuté : les cas viennent des conditions de due_alerts.

Ce que cet algorithme ne sait pas faire

• La date du jour est enregistrée avant que le message soit livré. Si l'envoi échoue ou si le message est abandonné (nuit puis jour local changé), tu ne reçois pas d'alerte ce jour-là, et aucune autre ne part.
• Le contrôle ne se fait qu'à 8 h locales. Un score qui dépasse 70 à 15 h attend le lendemain matin.
• Les seuils d'alerte (70 et 40) ne sont pas ceux des niveaux affichés : l'écran du risque écrit « modéré » dès 30 et « élevé » dès 60. Un score de 65 est donc « élevé » à l'écran, mais ne déclenche pas l'alerte de 70. Le texte de l'alerte dit pourtant « (élevé) » pour tout score de 70 ou plus.
• L'alerte est facultative et éteinte par défaut. Sans l'avoir activée, tu ne reçois rien, quel que soit le score.
• Si les mesures ont plus de 2 jours, aucun message ne part, même avec un score élevé, car le score est jugé périmé. L'absence d'alerte ne prouve donc pas l'absence de risque.
• Un score bas n'exclut jamais une crise. Les messages le rappellent dans « Que faire maintenant ? ».
• La nuit, l'alerte attend la fin des heures calmes. Une crise qui se prépare pendant la nuit n'est pas signalée plus tôt par Trévor : en cas d'urgence, il faut appeler le 144 sans attendre.

Code : src/trevor/wearables/service.py (CRISIS_ALERT_THRESHOLD, CRISIS_SOFT_THRESHOLD, due_alerts, alerts_enabled, set_alerts, silent_mode, interpretation_source), src/trevor/conversation/reminders.py (crisis_alerts, _deliver, QUIET_DAILY, tick à 8 h), src/trevor/conversation/push_gate.py (hold_if_quiet, push_gated), src/trevor/conversation/attention_budget.py (EXEMPT), src/trevor/localtime.py (is_quiet, QUIET_DEFAULT), src/trevor/navigator/reco_flow.py (soft_alert_enabled, alert_lines), src/trevor/dashboard/data.py (wearable_alerts), data/i18n/fr.json (textCrisisAlertMessage, textCrisisAlertSoft, textCrisisAlertsEnabled, textCrisisAlertsSoftEnabled)

Apprentissage du modèle personnel et de la cohorte

Chaque nuit, Trévor peut entraîner un modèle de régression logistique sur tes propres jours, puis un modèle commun à toutes les personnes suivies. Les poids de départ viennent d'un a priori clinique, et l'entraînement ne les éloigne que si tes données le justifient. Au moment du calcul, les modèles qui ont fait leurs preuves se mélangent avec l'a priori.

Où tu le vois : Dans l'écran « Mon risque de crise », le bloc « Fiabilité du modèle » dit si le calcul part de repères cliniques, de la cohorte ou de tes données (nombre de jours, nombre d'épisodes de crise, AUROC en validation temporelle).

Ce que l’algorithme lit

• Écarts à ta normale et repères du jour, pour chaque jour passé qui a une ligne de base (voir « Lignes de base et écarts ») (montre, déclaration)
• Étiquettes de crise : douleur déclarée de 7/10 ou plus, hospitalisation, observation de conversation d'intensité 7 ou plus qui parle de crise ou d'urgences, jours des épisodes du journal des crises (déclaration)
• Traitements tels qu'ils étaient chaque jour d'entraînement : temps écoulé depuis la transfusion, nombre de culots, régularité de l'hydroxyurée (dossier, déclaration)

Le calcul, étape par étape

Les valeurs utilisées

Les poids

Un poids positif augmente le résultat, un poids négatif le diminue.

Ce qui est affiché

Deux modèles enregistrés (le tien et celui de la cohorte), chacun avec ses poids, son biais, son nombre de jours, son nombre de crises et son AUROC en validation croisée temporelle. Au moment du calcul, la liste des modèles retenus et leurs poids de mélange. L'écran affiche l'origine du calcul : « repères cliniques » (a priori seul), « ajusté sur la cohorte » ou « ajusté sur tes données », avec jours, épisodes et AUROC.

Un exemple chiffré

Un modèle personnel avec 8 crises et une AUROC de 0,70, et un modèle de cohorte avec 10 crises et une AUROC de 0,62. Les deux passent leur seuil (4 crises et 0,65 ; 5 crises et 0,6). Les poids de mélange sont a priori 1,0, cohorte min(4 ; 10/5) = 2,0 et personnel min(6 ; 8/2) = 4,0, soit une part de 4/7 pour le modèle personnel. Si l'AUROC personnelle n'était que de 0,60, le modèle personnel serait écarté et seuls l'a priori (1,0) et la cohorte (2,0) resteraient. Vérifié en exécutant blend() du dépôt (résultat : prior 1.0, cohort 2.0, personal 4.0).

Ce que cet algorithme ne sait pas faire

• Le modèle apprend à prédire un jour étiqueté crise dans les 3 jours (aujourd'hui et les 2 suivants), alors que les textes parlent de 48 heures. L'étiquette est large : aujourd'hui, demain et après-demain.
• L'étiquette de crise vient en grande partie de ce que tu déclares. Une crise non déclarée compte comme un jour calme, et une douleur de 7/10 sans crise réelle compte comme une crise.
• Avec 4 à 10 crises, le modèle est fragile : l'AUROC est estimée sur très peu de cas, et un seul épisode de plusieurs jours compte pour beaucoup de jours positifs.
• L'AUROC affichée vient de la validation croisée, tandis que le modèle enregistré est entraîné sur tous les jours. Les blocs consécutifs d'un même épisode de crise peuvent aussi tomber de part et d'autre d'une frontière de bloc.
• À l'entraînement, la vasoconstriction vaut 0, et les traitements sont reconstitués jour par jour. En direct, ces valeurs sont lues à l'instant du calcul : le modèle n'a donc jamais appris le poids de la vasoconstriction sur tes données.
• Les poids appris sont ensuite multipliés par 1,6 sans nouvelle validation de ce gain, calibré sur un cas rapporté.
• Le modèle de cohorte regroupe des personnes très différentes, et ses écarts sont déjà normalisés par personne. Il peut être entraîné sur peu de personnes.

Code : src/trevor/wearables/crisis.py (build_features, train_logistic, auc_score, evaluate_blocked, blend, amplified, PRIOR_WEIGHTS), src/trevor/wearables/service.py (day_records, training_rows, _treatment_history, train_user, train_cohort, train_everyone, _stored_model)

Forme du jour (récupération)

La forme du jour est un repère de récupération sur 100, à la manière d'un score d'Oura. Trévor affiche tel quel le score que donne ton appareil quand il existe. Sinon il calcule le sien à partir de ton sommeil, de ta variabilité cardiaque (HRV) et de ton cœur au repos, comparés à ta normale.

Où tu le vois : Écran « Ma forme du jour » (commande /forme, ou Ma santé > Forme, risque, hémoglobine), tuile « Forme du jour » de Ma santé, écran Mesures et estimations, écran Ma santé de la montre. Le texte donne un pourcentage, un niveau (bonne, moyenne, basse), la source (score de l'appareil ou estimation Trévor), jusqu'à 2 facteurs, un conseil du jour et la mention que ce n'est pas un avis médical.

Ce que l’algorithme lit

• Score de récupération fourni par l'appareil (Oura readiness, Body Battery de Garmin, etc.) (montre ou bague)
• Minutes de sommeil, HRV, fréquence cardiaque au repos des 30 jours précédents et du jour (montre ou bague)
• Nuit déclarée dans « Ma nuit » : bonne, moyenne ou mauvaise (déclaration)
• Interprétation activée par la personne (avertissement accepté, réglage global ou programme de test) (réglage)

Le calcul, étape par étape

Les valeurs utilisées

Les poids

Un poids positif augmente le résultat, un poids négatif le diminue.

Ce qui est affiché

Un score de 0 à 100 (en pourcentage), un niveau (bonne à partir de 66, moyenne de 40 à 65, basse sous 40), une source (« device » ou « computed »), jusqu'à 2 facteurs en phrases (par exemple « Nuit plus courte que d'habitude », « Ton cœur au repos est un peu élevé »), la date et l'indication « frais ». Le conseil dépend du niveau : bonne (belle forme, garde tes bons réflexes), moyenne (à ton rythme, hydrate-toi, garde de la marge), basse (repose-toi, hydrate-toi, ménage tes efforts, évite le froid). Le texte précise que ce n'est pas un avis médical et ne remplace ni ton ressenti ni ton équipe de soins. Quand rien ne s'affiche, une phrase donne la cause : pas de montre, mode silencieux, avertissement à accepter, moins de 7 jours de référence, mesures trop anciennes ou trop peu nombreuses.

Un exemple chiffré

Vingt jours de référence : sommeil autour de 430 min (médiane 430, dispersion 30 par le plancher), HRV médiane 51,5 (dispersion 4), FC au repos médiane 60,5 (dispersion 2). Aujourd'hui : sommeil 360 min, HRV 44, FC 65. Les z sont −2,33 (borné −2), −1,875 et +2,25 pour la FC, inversé en −2,25 (borné −2). La moyenne pondérée vaut (0,40 × −2 + 0,35 × −1,875 + 0,25 × −2) / 1 = −1,96. Score = 50 + (−1,96 × 15) = 20,7, arrondi à 21 : niveau bas. Les deux facteurs affichés sont le sommeil (|z| 2,33) puis la FC (|z| 2,25) : « Nuit plus courte que d'habitude » et « Ton cœur au repos est un peu élevé ». Résultat vérifié en exécutant compute_readiness du dépôt.

Ce que cet algorithme ne sait pas faire

• Le score de l'appareil est affiché tel quel, sans contrôle ni explication de Trévor. Seul le score calculé est expliqué.
• Le score calculé n'utilise que trois mesures. Il ignore la douleur, l'humeur, l'oxygène, la température et ce que tu déclares dans le suivi du jour. Une journée de forte douleur peut donc donner une forme « bonne » si tu as bien dormi.
• Quand une seule mesure est présente, il n'y a pas de score. Avec deux mesures seulement, le score repose sur elles deux avec des poids ramenés à 1.
• La nuit déclarée remplace le sommeil seulement le jour où la montre n'a pas mesuré le sommeil, avec le poids du sommeil (0,40).
• Le score est borné par des z de ±2, donc un score calculé reste entre 20 et 80 ; il n'atteint jamais 0 ni 100. Seul un score d'appareil peut aller jusqu'aux extrêmes.
• Un score d'appareil ancien (plus de 2 jours) n'est plus affiché comme forme du jour, mais un score calculé ancien est retiré. Un jour sans appareil ni calcul n'a pas de forme.
• La forme du jour est distincte du risque de baisse de forme et du « forme » de « Que faire maintenant ? ». Ce sont trois notions différentes avec des calculs différents.

Code : src/trevor/wearables/readiness.py (compute_readiness, _usable, _level, WEIGHTS, DRIVER_LABEL), src/trevor/wearables/service.py (readiness_today), src/trevor/conversation/wearables_screen.py (_readiness_lines, screen_readiness), src/trevor/lifecourse/health_view.py (_form_reason, _form_tile, EMPTY_NOTE), src/trevor/signals.py (build), src/trevor/wearables/watch_summary.py (_health), data/i18n/fr.json (textReadiness*)

Lignes de base et écarts à ta normale

Trévor compare chaque mesure de ta montre ou de ta bague à ce qui est habituel pour toi, et non à une norme générale. Pour cela il calcule une médiane et un écart absolu médian (MAD) sur tes jours précédents, puis transforme l'écart du jour en z-score robuste et en tendance sur 3 jours. Ces écarts sont la matière première du risque de crise, du risque de baisse de forme et de la forme du jour.

Où tu le vois : Jamais affiché sous forme de chiffre brut. Les écarts apparaissent dans les phrases des écrans « Mon risque de crise » et « Ma forme du jour » (par exemple « Ton sommeil est plus court que d'habitude »), dans la liste des signaux qui pèsent le plus, et dans la phrase qui explique pourquoi une forme du jour manque.

Ce que l’algorithme lit

• Fréquence cardiaque au repos, variabilité cardiaque (HRV), SpO2, minutes de sommeil, pas, écart de température cutanée, score de stress, fréquence respiratoire, bruit ambiant, fréquence cardiaque la plus basse de la nuit (montre ou bague, import de fichier)
• Douleur déclarée (0 à 10) et jours de crise (déclaration (suivi du jour, conversation, journal des crises))
• Oxygène de la nuit et sommeil détaillé (efficacité, réveils, sommeil profond, heure de coucher) (montre, bague, oxymètre ou saisie « Ma nuit »)

Le calcul, étape par étape

Les valeurs utilisées

Ce qui est affiché

Un dictionnaire de caractéristiques par jour : z-scores bornés de −4 à +4 (FC repos, HRV, SpO2, sommeil, pas, température, stress, respiration, bruit, FC minimale de nuit), tendances sur 3 jours (FC repos, HRV, sommeil, respiration), douleur récente, jours de douleur, crise récente, SpO2 basse, signe de fièvre et caractéristiques de nuit. Un z positif veut dire « au-dessus de ta normale ». Le sens favorable ou défavorable n'est donné que plus loin, par les poids des modèles.

Un exemple chiffré

Huit jours de FC au repos : 60, 61, 59, 62, 60, 58, 61, 60. La médiane est 60. Les distances à 60 sont 0, 1, 1, 2, 0, 2, 1, 0, dont la médiane (le MAD) est 1. 1,4826 × 1 = 1,48 est sous le plancher de 2,0 bpm, donc la dispersion vaut 2,0. Un jour à 66 bpm donne z = (66 − 60) / 2,0 = +3,0. Un jour à 68 bpm donne +4,0, valeur maximale, et un jour à 75 bpm donne aussi +4,0. Résultat vérifié en exécutant _robust et _z du dépôt (médiane 60,0, dispersion 2,0, z de 68 bpm = 4,0).

Ce que cet algorithme ne sait pas faire

• La fenêtre de 30 compte des enregistrements et non des jours du calendrier : un trou de plusieurs semaines sans mesure fait remonter la ligne de base plus loin dans le passé.
• Il suffit de 7 valeurs pour fixer une normale. Avec si peu de jours, la médiane et le MAD sont peu stables, et le plancher de dispersion décide souvent seul.
• Un jour très atypique mais déjà passé (une crise, une maladie) entre dans la ligne de base des jours suivants. La médiane et le MAD y résistent mieux qu'une moyenne, mais une longue période anormale devient peu à peu ta nouvelle normale.
• Une mesure absente vaut un écart de 0, c'est-à-dire neutre. Un modèle qui lit peu de mesures ne voit donc pas de différence entre « tout va bien » et « rien n'a été mesuré ».
• Le z est borné à 4 : un écart énorme et un écart très grand pèsent pareil.
• Les mesures de poignet ou de doigt sont bruitées (mouvement, port irrégulier). Trévor ne filtre pas ces valeurs avant la médiane, hors le rejet des nuits de qualité faible pour les mesures de nuit.

Code : src/trevor/wearables/crisis.py (_robust, _z, MIN_SD, build_features, night_features, nadir_abs, pain_days), src/trevor/wearables/crisis_signaux.py (features), src/trevor/wearables/readiness.py (même méthode pour 3 mesures)

Que faire maintenant ?

Quand ton risque de crise monte, que ta forme est moyenne ou mauvaise, ou qu'une douleur commence, Trévor te propose de 3 à 5 gestes concrets. Il commence toujours par la consigne de sécurité s'il voit un signe d'urgence, puis il met en avant les gestes qui t'ont déjà aidé, les repères généraux, et enfin ce que d'autres personnes observent si leur nombre est suffisant. Ce sont des gestes d'auto-soin généraux, jamais une dose de médicament.

Où tu le vois : Écran « Que faire maintenant ? » (commande /quefaire ou /action, bouton proposé dès 40 % de risque), cartes de l'application compagnon (GET /api/phone/reco), et les deux premiers gestes dans le second message de l'alerte du matin. Chaque geste a une raison (« Pourquoi »), parfois une preuve (« Chez toi » ou « Parmi des personnes qui utilisent Trévor »), et un bouton « Je l'ai fait ».

Ce que l’algorithme lit

• Score et niveau du risque de crise du jour (calcul Trévor (montre, déclaration, dossier))
• Forme du jour de l'appareil ou calculée, humeur du jour (bien 8, moyen 5, pas bien 3), « Ça ne va pas » au suivi du jour : la pire de ces formes compte (montre, déclaration)
• Douleur du jour (la plus forte entre les observations et le suivi du jour) (déclaration)
• Signes d'urgence : fièvre déclarée ou température mesurée à 38,3 °C ou plus, essoufflement, douleur dans la poitrine, confusion, déficit neurologique (choisis dans l'application), douleur qui monte malgré le traitement (déclaration, calcul)
• Saturation mesurée (92 % ou moins), oxygène de nuit plus bas que ta normale plusieurs nuits de suite, nuit plus fragmentée (montre, bague, oxymètre)
• Sensation de froid ou frissons au suivi du jour (déclaration)
• Plan de soins : oxygène prévu, antalgique de secours prévu (carte d'urgence, dossier)
• Gestes que tu as notés et leur effet sur ta douleur ou ta forme le lendemain (déclaration (« Je l'ai fait »))
• Effets observés chez les autres personnes qui utilisent Trévor (anonymes, agrégés) (données de la cohorte)

Le calcul, étape par étape

Les valeurs utilisées

Ce qui est affiché

Une liste de 5 gestes au plus. Chaque geste porte une source : « securite » (consigne d'urgence ou équipe de soins), « perso » (« Chez toi »), « plan » (« Ton plan » : antalgique de secours, oxygène prévu), « general » (repère général) ou « autres ». Gestes du catalogue : urgence, équipe de soins la nuit, eau, repos au chaud, éviter le froid, éviter l'effort intense, éviter l'alcool, chaleur locale, respiration et relaxation, antalgique du plan (sans dose), antalgique prêt, oxygène du plan, sommeil, repas réguliers, prévenir un proche. L'écran se termine par « Ces gestes ne remplacent pas ton équipe soignante. Si tu te sens moins bien, contacte-la. » Il faut appeler le 144 sans attendre en cas de signe grave.

Un exemple chiffré

Contexte : score 75 (élevé), forme moyenne, douleur 4/10, fièvre déclarée, plan avec antalgique de secours nommé, sans oxygène. La fièvre est un signe d'urgence, donc la première carte est la consigne de sécurité. Il reste 4 places. Comme la douleur est de 3 ou plus, l'ordre est eau, repos au chaud, chaleur locale, antalgique du plan, puis la respiration. Résultat de reco.build : urgence (securite), eau (general), repos au chaud (general), chaleur (general), antalgique du plan (plan). Deuxième cas : score 45 (modéré), forme bonne, aucune douleur, aucun signe : eau, repos au chaud, éviter le froid, sommeil, repas réguliers. Vérifié en exécutant reco.build du dépôt.

Ce que cet algorithme ne sait pas faire

• Le niveau utilisé ici (élevé à partir de 70, modéré de 40 à 69) diffère de celui de l'écran du risque (modéré dès 30, élevé dès 60). Un score de 65 est « élevé » à l'écran du risque, mais « modéré » pour l'ordre des gestes.
• Les signes d'urgence viennent de ce que tu déclares, du suivi du jour, d'une saturation mesurée et d'un calcul de douleur qui monte. Si tu ne déclares rien et qu'aucune mesure n'existe, aucune consigne de sécurité n'apparaît. Un score bas n'exclut jamais une crise.
• Le seuil de saturation de 92 % vient d'une mesure de montre ou de bague, bruitée. Le code précise qu'il est à valider cliniquement. Le geste proposé est toujours de contacter l'équipe de soins, jamais de te donner de l'oxygène.
• Les gestes « pour toi » reposent sur une association entre un geste et la douleur ou la forme du lendemain, sans preuve de cause. Tu fais souvent un geste parce que tu as mal, ce qui brouille le lien. Un effet défavorable n'est jamais montré comme conseil.
• Les gestes des autres personnes exigent au moins 20 personnes. Avec moins, rien n'est montré. Le calcul est mis en cache 6 heures.
• Les textes des gestes sont généraux. Aucune dose de médicament n'est donnée, et l'antalgique de secours n'entre pas dans les effets « pour toi ».
• Le nombre minimal de 3 gestes est annoncé dans le code mais pas imposé : une liste plus courte est possible, par exemple quand peu de gestes généraux restent disponibles.

Code : src/trevor/navigator/reco.py (build, _general_order, emergency_signs, personal_effects, gesture_effect, favourable, level_of, triggered, form_of_mood, worst_form), src/trevor/navigator/reco_flow.py (context_for, compute, present, pain_rising, plan_of, record_done, alert_lines, api_payload), src/trevor/navigator/reco_peers.py (aggregate, peer_actions), src/trevor/conversation/reco_screen.py, src/trevor/conversation/reminders.py (crisis_alerts : deuxième message), data/i18n/fr.json (textReco*)

Risque de baisse de forme

Le risque de baisse de forme est un second score, plus doux et plus fréquent que le risque de crise. Il estime la probabilité d'un fléchissement de ton quotidien (sommeil, énergie, douleur) dans les 48 heures. Il sert à agir tôt, par exemple avec du repos, de l'hydratation et un rythme plus calme, avant une éventuelle crise.

Où tu le vois : Dans le message du bot « Mon risque de crise » (écran Ma montre), juste sous le risque de crise : une ligne « Risque de baisse de forme : X % · niveau » avec une icône verte, orange ou rouge, une phrase d'explication, puis une puce par signal qui pèse. Aucun autre écran, ni l'application, ni la montre, ni le tableau de bord n'affichent ce score (le code ne l'envoie qu'à ce message).

Ce que l’algorithme lit

• Écarts à ta normale de ton sommeil, de ton activité (pas), de ta HRV, de ta FC au repos, de ton stress mesuré, de ta température cutanée et de ta SpO2, plus les tendances sur 3 jours (voir « Lignes de base et écarts ») (montre ou bague)
• Douleur déclarée des 3 derniers jours, jours de douleur de la semaine, crise des 7 derniers jours (déclaration)
• Hémoglobine basse, retard de transfusion, effet de la transfusion qui s'estompe, transfusion récente ou qui tient, hydroxyurée suivie ou irrégulière (dossier, déclaration, import de laboratoire)
• Nuits de suite avec un oxygène bas (montre, oxymètre ou saisie « Ma nuit »)
• Froid, chaleur et particules fines PM2.5 du lieu (météo et qualité de l'air du lieu)

Le calcul, étape par étape

Les valeurs utilisées

Les poids

Un poids positif augmente le résultat, un poids négatif le diminue.

Ce qui est affiché

Un pourcentage de 0 à 100, un niveau et jusqu'à 4 explications. Niveaux : faible sous 30 % (icône verte), modéré de 30 à 59 % (orange), élevé à partir de 60 % (rouge). Le bot écrit « Risque de baisse de forme : X % · niveau », puis « Un fléchissement possible de ta forme (sommeil, énergie, douleur) dans les 48 h, plus léger qu'une crise », puis une puce par explication, par exemple « Ton sommeil est plus court que d'habitude : cela fait monter ton risque de baisse de forme. ». Le sens des signaux pour la forme se lit dans les poids : un z de sommeil négatif multiplié par −0,6 donne une contribution positive.

Un exemple chiffré

Sans aucun écart, tous les signaux valent 0 et le score est de 20 % (niveau faible). Prenons une journée où le sommeil est à −2 dispersions, l'activité à −1,5, la HRV à −1, la FC au repos à +1, le stress à +1 et la douleur récente à 0,5 (5/10). Le logit vaut −1,4 + 1,2 (sommeil) + 0,75 (pas) + 0,4 (HRV) + 0,4 (FC) + 0,45 (stress) + 0,4 (douleur) = 2,2. La probabilité est 1 / (1 + e^−2,2) = 0,90, soit 90 % (niveau élevé). Les quatre explications retenues sont le sommeil (1,2), les pas (0,75), le stress (0,45), puis la HRV (0,4), qui égale la FC et la douleur à 0,4 et passe devant dans l'ordre du tableau des poids. Résultat obtenu en exécutant form_risk du dépôt (score 90, niveau élevé, contributions z_sleep 1,2 ; z_steps 0,75 ; z_stress 0,45 ; z_hrv 0,4).

Ce que cet algorithme ne sait pas faire

• Les poids sont fixes. Contrairement au risque de crise, le risque de baisse de forme n'est jamais entraîné sur tes données ni sur celles de la cohorte, et aucune AUROC n'existe pour lui. Rien ne dit que ce score prédit vraiment une baisse de forme.
• Aucune définition d'une « baisse de forme » n'est écrite dans le code : il n'y a ni étiquette, ni cible mesurée. Le « 48 h » du texte est une intention, non une quantité vérifiée.
• Un jour calme part à 20 % : le niveau « faible » est donc atteint de justesse avec un seul signal moyen. Un signal à lui seul de poids 0,8 avec une valeur de 1 fait passer à 35 %, niveau « modéré ».
• Le score n'a pas de plafond à 99 %, ni de plafond après transfusion. Une journée très chargée peut dépasser 99 %.
• Les symptômes que tu déclares (fièvre, difficultés à respirer, fatigue, mauvaise nuit, mal-être) n'entrent pas dans ce score, alors qu'ils entrent dans le risque de crise. Ta fatigue déclarée ne fait donc pas monter le risque de baisse de forme.
• Quand l'oxygène de la nuit est mesuré, il remplace la SpO2 du jour dans le calcul des écarts, mais la baisse de forme ne lit pas l'oxygène moyen de la nuit. La SpO2 pèse alors 0 dans ce score, et seules les nuits de suite avec un oxygène bas (0,25) restent.
• Une moyenne d'oxygène meilleure que d'habitude peut faire baisser le score même si la nuit a eu un creux, car la règle de non-rassurance du risque de crise n'est pas appliquée ici.
• Sans montre ni bague, les écarts valent 0. Le score ne repose alors que sur la douleur, le dossier et l'environnement, et peut sembler rassurant par défaut.
• Le score n'est pas calculé sur le téléphone : l'application compagnon ne reçoit pas ses poids. Il n'existe que dans le message du bot.

Code : src/trevor/wearables/crisis.py (FORM_WEIGHTS, FORM_BIAS, form_risk, after_transfusion, explain, reason_label, EXPLAIN_UP, EXPLAIN_DOWN, FEATURE_LABELS), src/trevor/wearables/service.py (crisis_risk, lignes 793-796 ; crisis_text, lignes 1019-1025), data/i18n/fr.json (textCrisisFormHead)

Signaux de la montre et sources de température et de cœur

Trévor lit trois familles de signaux issus de la montre, de la bague ou de fichiers. Les signaux factuels sont des repères simples (SpO2 sous 92 %, FC au repos 10 bpm plus haute, sommeil court, etc.) affichés avec leur date. Trois caractéristiques de température et de cœur entrent dans le risque de crise avec des poids modestes, et le module des signaux compare température et cœur à ta ligne de base pour ses propres écrans.

Où tu le vois : Les signaux factuels apparaissent dans le résumé de la montre (« Mes 7 derniers jours ») et dans le tableau de bord des soignants sous la forme « Objet connecté : SpO2 nocturne 91 % ». Les trois caractéristiques du risque se lisent dans les phrases du risque de crise, avec en dessous la ligne « d'où viennent la température et le cœur » (source, type, méthode, qualité). L'écran Signaux montre la température et le cœur face à ta ligne de base.

Ce que l’algorithme lit

• SpO2 moyenne de nuit, fréquence cardiaque au repos, HRV, sommeil, écart de température cutanée, fréquence respiratoire (montre ou bague, import de fichier)
• Fréquence cardiaque la plus basse de la nuit et écart de température de peau fournis par d'autres sources (fichiers importés, saisie, hôpital)
• Les 30 jours précédents de chaque mesure (montre ou bague)

Le calcul, étape par étape

Les valeurs utilisées

Les poids

Un poids positif augmente le résultat, un poids négatif le diminue.

Ce qui est affiché

Pour les signaux factuels : une liste de lignes datées, par exemple « SpO2 nocturne 91 % », « FC repos 72 bpm (référence 60) », « HRV 38 ms (référence 52, baisse de 25 % ou plus) », « Température cutanée +0,6 °C », « Fréquence respiratoire 21 /min », « Moins de 5 h de sommeil 3 nuits de suite », du plus récent au plus ancien. Pour le risque de crise : trois nombres (z de la FC la plus basse de la nuit, nuits d'affilée de 0 à 4, couplage de 0 à 3) qui s'ajoutent au calcul, et la liste des sources (jusqu'à 6). Pour l'écran Signaux : les écarts à ta normale de la température et du cœur. Les ECG n'entrent pas dans le score : ils déclenchent seulement des messages d'orientation.

Un exemple chiffré

FC au repos : médiane des 30 jours précédents à 60 bpm. Un jour à 70 bpm donne le signal « FC repos 70 bpm (référence 60) », car 70 ≥ 60 + 10. Un jour à 69 bpm n'en donne pas. Pour le couplage, avec un z de température de +2 et un z de FC de nuit de +3 : min(3 ; 2) × min(3 ; 3) / 3 = 2. Contribution au risque de crise avant amplification : 0,3 × 2 = 0,6 ; après le gain de 1,6 : 0,96 sur l'échelle du modèle. Calcul fait à la main à partir des formules du code, non exécuté.

Ce que cet algorithme ne sait pas faire

• Les signaux factuels sont des seuils fixes sur des valeurs de poignet ou de doigt, mesurés par un capteur grand public. Les valeurs de SpO2 de nuit et de température de peau sont sensibles aux mouvements et au port de l'appareil.
• Le signal de sommeil court ignore une nuit sous 2 h, donc une vraie très courte nuit peut ne pas compter.
• Il y a deux lignes de base différentes pour le cœur : celle du risque de crise (médiane et MAD sur 30 enregistrements, minimum 7) et celle des signaux factuels et du module Signaux (30 jours, minimum 5 ou 3 nuits, seuils en bpm). Les seuils (+10 bpm, +8 bpm) ne sont pas les mêmes.
• La température de peau n'est pas la température du corps : un capteur ne déclenche jamais l'urgence, et le couplage entre température et cœur invite à prendre la température, sans dire que tu as de la fièvre.
• L'écart de température fourni par l'appareil est déjà un écart à sa propre base. Quand la ligne de base de Trévor manque, il est simplement divisé par 0,25 °C.
• Les autres sources ne complètent que les jours que la montre a déjà mesurés : une FC de nuit ou un écart de peau importés pour un jour sans montre sont ignorés.
• Les signaux factuels et la liste des sources disparaissent si l'interprétation est désactivée.

Code : src/trevor/wearables/service.py (signals, summary, day_records, crisis_risk), src/trevor/wearables/crisis_signaux.py (night_streak, features, NEW_PRIOR_WEIGHTS), src/trevor/signaux/service.py (crisis_extras, crisis_sources, crisis_sources_text, build), src/trevor/signaux/baseline.py (against_baseline, consecutive_elevated, robust), src/trevor/signaux/temperature.py (analyse, is_fever), src/trevor/signaux/heart.py (analyse), src/trevor/signals.py (vue « Mesures et estimations »), data/signaux_sources.json (baseline)

Tendance à la vasoconstriction (expérimental)

Cet indice indicatif repère une peau qui se refroidit plus que d'habitude pendant la nuit, signe possible de vasoconstriction. Il compare ta température de peau, ton cœur au repos, ta HRV, ton oxygène et ta respiration à tes 14 jours précédents. Il reste silencieux quand la mesure est fragile, et il n'est calculé que si tu as donné ton accord.

Où tu le vois : Au poignet (écran Ma santé de la montre), sous forme de codes seulement (état, niveau, noms des facteurs, qualité), et comme un facteur « Peau qui se refroidit (expérimental) » dans les explications du risque de crise quand il pèse. Aucune valeur de santé n'est affichée par cet indice.

Ce que l’algorithme lit

• Température cutanée de nuit (valeur de peau, ou écart donné par l'appareil) (montre ou bague)
• Fréquence cardiaque au repos, HRV, SpO2, fréquence respiratoire (montre ou bague)
• Qualité de la mesure des 14 derniers jours (calcul Trévor)
• Ton accord « Mon contexte » pour la vasoconstriction, et l'indicateur activé côté Trévor (réglage)

Le calcul, étape par étape

Les valeurs utilisées

Les poids

Un poids positif augmente le résultat, un poids négatif le diminue.

Ce qui est affiché

Un résultat avec un état (silence, calme, légère ou nette), un niveau de 0 à 2, les noms des facteurs présents (temp, hr, hrv, spo2, resp), la qualité de la mesure (bonne, moyenne, insuffisante) et le nombre de jours exploitables. Seules les étiquettes sortent, jamais une valeur de santé ni une série, et rien n'est journalisé. Pour le risque de crise, seul le niveau compte : 0 pour silence et calme, 1 pour légère, 2 pour nette. Dans l'application et à la montre, les codes sont silent, calm, slight et clear.

Un exemple chiffré

Quatorze jours de référence : peau autour de 34,0 °C, cœur au repos 58 à 59 bpm, HRV 50 à 52, SpO2 96, respiration 14, sommeil 420 min. Aujourd'hui : peau 33,5 °C et cœur 66 bpm. La peau a baissé de 0,5 °C (au moins 0,3) et de plus d'une dispersion, et le cœur monte de plus de 5 bpm : deux facteurs (temp, hr) avec une qualité bonne, donc état « nette », niveau 2, soit +0,64 sur l'échelle du modèle (2 × 0,32). Si le cœur reste à 59 bpm, seul « temp » est présent : état « légère », niveau 1. Résultat vérifié en exécutant compute() du dépôt (nette, niveau 2, facteurs temp et hr ; légère, niveau 1, facteur temp).

Ce que cet algorithme ne sait pas faire

• Le signal central est la température de la peau mesurée au poignet ou au doigt, qui varie avec la température de la pièce, la literie, le port de l'appareil et le mouvement. Une baisse de 0,3 °C peut venir d'une chambre plus fraîche.
• L'indice de perfusion (PPG) et la température distale de jour ne sont pas collectés par Trévor : ils ne comptent pas, et le texte ne les promet pas.
• Sans refroidissement de la peau, les autres signes sont mis de côté : un cœur plus rapide ou une HRV basse seuls ne disent rien ici sur la vasoconstriction.
• La base ne compte que 14 jours et seulement 5 valeurs, donc elle est fragile. La qualité « insuffisante » rend l'indice silencieux, mais « moyenne » suffit à un état « légère ».
• L'état « nette » exige une qualité « bonne » et au moins deux facteurs. Les facteurs ne sont pas pondérés entre eux.
• Au moment de l'entraînement du modèle, l'indice vaut toujours 0 : son poids n'a jamais été appris sur tes données.
• Une température de peau qui se refroidit n'est pas un diagnostic. Le texte de l'indice reste une aide à la prudence (froid, manque d'eau, stress, infection).

Code : src/trevor/wearables/vasoconstriction.py (compute, level_feature, for_user), src/trevor/wearables/mesure.py (assess, usable), src/trevor/wearables/service.py (_vaso_feature), src/trevor/wearables/crisis.py (PRIOR_WEIGHTS vasoconstriction), src/trevor/wearables/watch_summary.py (_vasoconstriction)