# 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

## 8. 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) |

## 9. 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