HormoneTrack/README.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

8.0 KiB
Raw Blame History

HormoneTrack

Suivi de thérapie hormonale (THS) sur Android, avec courbes estimées heure par heure d'estradiol (E2) et de testostérone (T), calibration sur les prises de sang, rappels affichés sur smartwatch (Huawei Watch GT 3 via Gadgetbridge ou Huawei Health) et sauvegarde JSON. 100 % local, aucun compte, aucun serveur.

⚠️ Avertissement médical : les courbes sont des estimations pharmacocinétiques à titre informatif — ce ne sont pas des mesures. Fie-toi toujours à tes analyses de sang et aux consignes de ton endocrinologue.

Fonctionnalités

  • Courbes estimées heure par heure : E2 (pg/mL) et T (ng/mL), vue 24 h / 7 j / 30 j, panoramique (glisser pour remonter dans le passé)
  • Deux modèles PK au choix, superposables (issus de la feuille Estrogen.ods) : Estrannaise (EstraNase) et Transfem Science pour les injections EV / EU / EEn, affichés côte à côte avec toggles indépendants
  • Modèle Bateman paramétrable (temps au pic, demi-vie, biodisponibilité) pour gel, patch et voie orale
  • Simulation prévisionnelle : configurer la fréquence d'injection (jours) sur un traitement → projection des doses à venir sur le graphique (jamais sauvegardées)
  • Log des doses avec date/heure exacte, dose en mg, ester par injection (switch EV↔EU↔EEn comme dans le tableur), éditable (tap sur une ligne dans Doses), intervalle en jours entre dosages affiché
  • Analyses de sang : E2 + T en une seule entrée (chacune optionnelle), affichées côte à côte quand elles partagent la même date/heure, éditables (tap → choix de l'entrée) ; unités T : ng/mL, ng/dL, ng/L, nmol/L
  • Calibration : facteur d'échelle par traitement = médiane(lab ÷ prédiction du modèle), calculé automatiquement (« Scale factor » du .ods, automatisé) — ou calibration automatique permanente (option, désactivée par défaut) qui calibre chaque ester avec les labs de sa période (labs valerate → doses valerate, labs enanthate → doses enanthate) et recalibre le modèle T
  • Estimation T empirique T = plancher + (base − plancher) ÷ (1 + k·E2), calibrable avec tes résultats T (unités ng/mL, ng/dL, ng/L, nmol/L acceptées)
  • Rappels quotidiens avec actions « Pris » / « Reporter 1 h » dans la notification ; les notifications remontent sur la Watch GT 3 (Gadgetbridge ou Huawei Health)
  • Sauvegarde/Restauration JSON complète (traitements + doses + analyses + réglages T)
  • FR + EN (langue par app, indépendante du système)
  • UI Jetpack Compose récente (BOM 2026.08, Material You) ; 100 % local, aucun compte

Démarrage rapide (build depuis les sources)

Prérequis : JDK 17+ (Java 21 OK), Android SDK (la plateforme 37 sera auto-téléchargée par AGP si les licences sont signées). Le wrapper télécharge Gradle 9.7.1.

git clone <repo> && cd HormoneTrack
echo "sdk.dir=/chemin/vers/android-sdk" > local.properties   # ou ANDROID_HOME
./gradlew assembleDebug            # APK : app/build/outputs/apk/debug/app-debug.apk
./gradlew testDebugUnitTest        # 36 tests (moteur PK, profils, backup, régression)

Installation sur un téléphone : mode développeur + Débogage USB, puis Android Studio (Run ▶️) ou adb install -r app/build/outputs/apk/debug/app-debug.apk. Pas de Play Store : l'app est sideloadée. Détails pas-à-pas : docs/GUIDE_INSTALLATION.md.

Git

Dépôt initialisé avec des releases taguées (v1.1.0, v1.2.0, …) :

git tag            # lister les releases
git log --oneline  # historique par couches (toolchain / moteur / UI / docs)
git push -u origin main --tags   # après ajout d'un remote

Chaque commit de release passe ./gradlew testDebugUnitTest (vert obligatoire) et est taggué annoté. Voir docs/DEVELOPPEMENT.md §16.

Les modèles en bref

Chaque injection contribue dose_mg × profil(dt) où profil est la réponse normalisée (pg/mL par mg) issue des tables horaires d'Estrannaise / Transfem Science (8001 h) ; les contributions se superposent. Pics de référence :

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

La calibration (facteur d'échelle par traitement, calibré par tes labs) ajuste le modèle à ton corps, exactement comme la colonne « Scale factor » de la feuille d'origine.

Vie privée

  • Base de données Room locale sur le téléphone ; aucune télémétrie, aucun réseau
  • Sauvegarde = fichier JSON que tu stockes où tu veux (Owncloud, etc.)
  • allowBackup=false (données sensibles) ; verrou biométrique prévu en Phase 2
  • Compat Gadgetbridge (FOSS) : aucune dépendance à Huawei Health ni aux services Huawei

Structure du dépôt

HormoneTrack/
├── README.md                     ← ce fichier
├── docs/
│   ├── GUIDE_INSTALLATION.md     guide utilisateur (téléphone + montre)
│   ├── DEVELOPPEMENT.md          doc de dev complète (architecture, maths, bugs, tests)
│   └── MONTRE-GADGETBRIDGE.md    montre Huawei GT 3 : options + limites
├── build.gradle.kts              config Gradle racine (AGP/Kotlin/KSP épinglés)
├── settings.gradle.kts
├── gradle.properties
├── gradle/wrapper/               wrapper Gradle 8.9 (jar + properties)
├── gradlew / gradlew.bat
└── app/
    ├── build.gradle.kts          dépendances (Compose, Room, DataStore, Gson…)
    ├── proguard-rules.pro
    └── src/
        ├── main/
        │   ├── AndroidManifest.xml
        │   ├── assets/pk_profiles.json          ← tables horaires (Estrannaise/TFS)
        │   ├── java/com/hormonetrack/
        │   │   ├── data/         (Room : models, DAOs, repository, backup)
        │   │   ├── pk/           (moteur pharmacocinétique + profils)
        │   │   ├── reminder/     (alarmes exactes, notifs + actions, boot)
        │   │   ├── settings/     (DataStore : TConfig, langue)
        │   │   ├── ui/           (Compose : screens, components, theme)
        │   │   ├── HormoneTrackApp.kt
        │   │   └── MainActivity.kt
        │   └── res/              (strings FR/EN, thème, icônes)
        └── test/java/com/hormonetrack/          ← tests unitaires JVM
            ├── pk/               (moteur + profils)
            └── data/backup/      (round-trip Gson)

Feuille de route

  • v1 : courbes E2/T, log doses, labs + calibration, rappels, backup JSON, FR/EN
  • Tests UI Compose + compilation release signée
  • Verrou biométrique, widget, export CSV
  • Phase 2 montre : watchface personnalisée et/ou mini-app Lite Wearable (voir docs/MONTRE-GADGETBRIDGE.md)

Licence

À définir avant le premier push public (suggestion : GPL-3.0, cohérent avec l'écosystème Gadgetbridge). Les modèles PK appartiennent à leurs autrices respectives (Estrannaise, Transfem Science).