Siphonight/HormoneTrack
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 49 Wiki Activity
HormoneTrack/docs/GUIDE_INSTALLATION.md
Siphonight c71a50429d v1.2.2 : prise de sang E2 + T en une entrée, affichage côte à côte, toggle T masque aussi les labs T 
- LabDialog : mode création avec deux sections (E2 et T, chacune optionnelle,
  au moins une valeur requise) → insère 1 ou 2 LabResult au même timestamp ;
  mode édition inchangé (un seul marqueur, pré-rempli)
- LabsScreen : regroupement par timestamp (groupLabsForDisplay : E2 avant T,
  autres ensuite, tri desc) → affichage « E2 306 pg/mL · T 45 ng/dL » côte à
  côte ; tap sur une paire → sélecteur « Quelle entrée modifier ? » puis
  édition pré-remplie ; suppression = la prise entière (confirm nommant les
  valeurs) ; formatLabValue préserve les décimales
- ChartScreen : le toggle T masque désormais aussi les labs T (avant : seuls
  les points restaient visibles)
- LabsGroupingTest : 4 tests de regroupement (48 tests verts au total)
- versionCode 5, versionName 1.2.2 ; docs mises à jour
2026-09-05 18:33:19 +02:00

7.6 KiB
Raw Blame History

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 → + → 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)
  • 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 et tes labs enanthate calibrent les doses enanthate (le mélange des périodes ne fausse plus rien)

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