HormoneTrack/docs/GUIDE_INSTALLATION.md

HormoneTrack — Guide d'installation et d'utilisation

App Android de suivi de THS : courbes estimées heure par heure (E2 + T), log des doses, analyses de sang avec calibration, rappels affichés sur la Huawei Watch GT 3.

⚠️ Important : les courbes sont des estimations pharmacocinétiques, pas des mesures. Fie-toi toujours à tes prises de sang et aux consignes de ton endocrinologue.

---

1. Installer les outils (une seule fois)

1. Télécharge Android Studio (Ladybug ou plus récent) : https://developer.android.com/studio
2. Installe-le, lance-le une première fois et accepte l'installation du SDK Android (assistant de setup par défaut, tout coché).
3. Il te faut ~10 Go d'espace disque libre.

Tu n'as pas besoin d'installer Gradle ni le JDK séparément : Android Studio s'en charge.

2. Ouvrir le projet

1. Android Studio → Open → sélectionne le dossier ~/projects/HormoneTrack
2. Laisse le Gradle Sync se terminer (première fois : téléchargements, 5–15 min)
   • La barre du bas affiche la progression ; attends « Gradle sync finished ».
3. Vérifie que l'asset est bien présent : app/src/main/assets/pk_profiles.json (profils Estrannaise / Transfem Science extraits de ton Estrogen.ods).

3. Préparer ton téléphone

1. Paramètres → À propos du téléphone → tape 7 fois sur « Numéro de build » → « Mode développeur activé »
2. Paramètres → Système → Options développeur → active Débogage USB
3. Branche le téléphone en USB → accepte la fenêtre « Autoriser le débogage USB »

4. Installer l'app

1. Dans Android Studio, sélectionne ton téléphone dans la liste d'appareils (en haut)
2. Clique sur Run ▶️
3. L'app s'installe (pas de Play Store nécessaire) — au premier lancement :
   • Autorise les notifications (Android 13+)
   • Dans Paramètres → Rappels & alarmes : bouton « Accorder les alarmes exactes » (sinon les rappels peuvent être en retard de quelques minutes)

5. Voir les rappels sur la Watch GT 3

Les notifications de l'app remontent automatiquement sur la montre via Huawei Santé :

1. Vérifie que la montre est jumelée à Huawei Santé
2. Dans Huawei Santé → Montre → Notifications :
   • Autorise les notifications d'applications
   • L'app « Suivi Hormonal / HormoneTrack » doit être dans la liste autorisée
3. Test : programme un rappel 2 min à l'avance → la notif doit apparaître au poignet avec les boutons « Pris » et « Reporter 1 h »

Sur la GT 3, on ne peut pas installer d'app au poignet facilement (Lite Wearable, sideload via DevEco Assistant). La v1 utilise la montre comme écran de notifications, ce qui est fiable et sans maintenance. Une mini-app au poignet reste possible en Phase 2 si tu veux.

6. Premiers pas dans l'app

1. Traitements → + → choisis un preset (ex : Injection EV — Estrannaise)
   • Ester (EV / EU / EEn) + modèle (Estrannaise / Transfem Science) = les courbes du .ods
   • Pour gel/patch/oral : paramètres Bateman (temps au pic, demi-vie, biodispo)
2. Doses → + → logue tes injections passées (date/heure exactes, dose en mg)
   • Astuce : tu peux changer l'ester par injection (comme dans ton tableur)
   • Modifier une dose existante : appuie simplement sur sa ligne dans l'écran Doses (traitement, dose, date/heure, notes et ester tout ça éditable) — pas besoin de supprimer/recréer
3. Analyses → + → entre tes prises de sang (E2 en pg/mL, T en ng/mL)
4. Calibration (dans l'édition d'un traitement E2) → « Calibrer avec les analyses » → calcule le facteur d'échelle = médiane(lab ÷ prédiction), comme le « Scale factor » du .ods
5. Paramètres :
   • Langue : Système / Français / English
   • Estimation T : modèle T = plancher + (base − plancher) ÷ (1 + k·E2) (ng/mL), calibrable avec tes résultats T
   • Sauvegarde JSON : Export / Import (traitements + doses + analyses + réglages T)

7. Les modèles mathématiques

Les profils viennent de ta feuille Estrogen.ods (table « Models ») :

Profil	Source	Pic (pg/mL par mg)	Tmax (h)
EV(ese)	Estrannaise	61,1	~45 h
EU(ese)	Estrannaise	3,4	~55 h (plateau long)
EEn(ese)	Estrannaise	31,4	~152 h
EV(tfs)	Transfem Science	59,0	~51 h
EU(tfs)	Transfem Science	10,1	~198 h
EEn(tfs)	Transfem Science	32,0	~156 h

• Superposition : chaque injection contribue dose_mg × profil(dt) ; les courbes s'additionnent
• Interpolation linéaire entre les heures ; au-delà de 8000 h, extrapolation avec la pente terminale
• Calibration : facteur d'échelle par traitement (médiane des ratios lab/prédiction)
• Courbe T : dérivée de l'E2 estimé (modèle empirique, calibrable) — indicative seulement
• Unités T acceptées : ng/mL, ng/dL, ng/L, nmol/L (conversion automatique)

8. Fonctions du graphique (v1.2)

• Panoramique : fais glisser le graphique vers la droite pour remonter dans le passé (toute ta fenêtre d'historique) ; bouton « Revenir à maintenant » pour revenir
• Toggles Estrannaise / Transfem Science : les deux courbes peuvent être affichées simultanément (Estrannaise = bleu, Transfem Science = turquoise) pour comparer
• Prévision : configure la Fréquence d'injection (jours) dans un traitement (section « Fréquence ») puis active le chip « Prévision » → les doses à venir sont simulées et dessinées après la ligne « maintenant » (jamais sauvegardées)
• Calibration automatique (Paramètres, désactivée par défaut) : quand activée, les facteurs d'échelle et le modèle T sont ajustés en continu depuis tes labs — pour l'affichage seulement, tes réglages stockés ne changent pas

9. Dépannage

Problème	Solution
« SDK not found » au sync	Android Studio → Settings → Languages & Frameworks → Android SDK → installer API 34
Pas de téléphone détecté	Réactive le Débogage USB, change de câble (données, pas charge seule)
Notif absente sur la montre	Huawei Santé → Notifications → autorise l'app ; redémarre la montre
Rappels en retard	Paramètres → « Accorder les alarmes exactes » + désactive l'optimisation de batterie pour l'app
Import JSON échoué	Le fichier doit venir d'un export de l'app même version (IDs conservés)

10. Données & vie privée

• Tout est local : base Room sur le téléphone, aucun serveur, aucun compte
• Sauvegarde = fichier JSON que tu choisis où stocker (Owncloud, etc.)
• La désinstallation supprime les données → pense à exporter régulièrement