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*)
   - Tu as changé d'ester ? Crée (ou garde) le traitement de l'ancien ester et
     passe-le **inactif** (switch « Actif ») : il disparaît de la saisie et de tes
     rappels, mais **son historique reste simulé et calibré** sur les graphiques —
     parfait pour une transition valerate → enanthate
   - 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 → +** → une prise de sang complète en une entrée : **E2 et/ou T**
   (chacune optionnelle), date/heure commune, notes — les deux s'affichent côte à côte
   dans la liste
   - **Modifier** : appuie sur la ligne ; si la prise contient E2 **et** T, un sélecteur
     te demande laquelle modifier
   - **Supprimer** : la corbeille retire la prise entière (E2 + T ensemble)
   - Choisis bien l'unité : elle est convertie automatiquement pour l'affichage et la
     calibration (E2 en pg/mL ; T en ng/mL, ng/dL, ng/L, nmol/L)
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)
- **Pics / creux** (chip sur le graphique) : triangles ▲▼ aux extrema estimés de
  chaque courbe (E2 et T, les deux modèles) — pratique pour visualiser d'un coup
  d'œil les hauts et les bas entre deux injections
- **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. **Chaque ester est
  calibré avec les labs faits pendant sa période** : si tu étais sous valerate avant
  d'être sous enanthate, tes labs valerate calibrent les doses valerate (E2 **et**
  la suppression T), et inversement pour l'enanthate

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