Siphonight
e8f87c096d
- docs/CHANGELOG.md : entrée v1.2.0 complète - docs/DEVELOPPEMENT.md : versions épinglées à jour, note Material Expressive (API encore internal), migration Room v1→v2, §7.3b (override modèle/prévision/ auto-cal), §8 (36 tests), §10/§11 (panoramique, multi-séries), §16 (workflow git), §18 (disque), historique des sessions - README : statut v1.2.0, features à jour, section Git (tags de release) - GUIDE : nouvelle section « Fonctions du graphique » (panoramique, toggles modèles, prévision, calibration auto)
124 lines
6.9 KiB
Markdown
124 lines
6.9 KiB
Markdown
# 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
|