Siphonight/HormoneTrack
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 49 Wiki Activity
HormoneTrack/docs/GUIDE_INSTALLATION.md

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

1.bis Option SANS compilation : télécharger l'APK depuis les releases

Chaque version taguée est publiée en release Gitea avec les APK prêts à installer — pas besoin d'Android Studio ni de faire un build :

  1. Va sur Releases du dépôt Gitea (onglet « Releases » à droite) : https://gitea.cloudyfy.fr/Siphonight/HormoneTrack/releases (miroir équivalent : https://gitea.farewell.dev/Siphonight/HormoneTrack/releases)
  2. Deux APK par release :
Fichier Quoi Pour qui
HormoneTrack-vX.Y.Z-release.apk Optimisé (R8 : code minifié/compacté, ressources shrinkées) — 2,4 Mo au lieu de 20 Mo, démarrage et fluidité meilleurs Recommandé — usage quotidien
HormoneTrack-vX.Y.Z-debug.apk Non optimisé, hookable par un debugger — 20 Mo Diagnostic/développement uniquement
  1. Installe : télécharge l'APK → ouvre-le → accepte « installer une application inconnue » (une seule fois). Mise à jour : installe la nouvelle version par-dessus l'ancienne — données conservées (les deux APK sont signés avec la même clé debug, donc interchangeables dans les deux sens sans perte).

⚠️ Après l'installation d'un APK release (optimisé R8), fais un test rapide une fois : export/import d'un backup JSON + graphiques — R8 n'est pas vérifiable par les tests automatisés.

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
    • Astuce mise à jour : l'app affiche les nouveautés de chaque version au démarrage (fermable) ; la version installée et le lien des releases sont dans Paramètres (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 Posologie (intervalle en 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