Aller au contenu

Infobulles pédagogiques des métriques et traduction anglaise de la vitrine

Billet #278 : Infobulles pédagogiques des métriques et traduction anglaise de la vitrine
Type : Fonctionnalité / Expérience utilisateur / Aide à la décision
Composants concernés : code_source_simule/tooltip_guidance.py, code_source_simule/flask_app.py, code_source_simule/portfolio_metrics.py, templates/_metric_tooltip.html, templates/dashboard.html, templates/demo_index.html, templates/titre_detail.html, docs/features/chapter4.md, docs/fr/features/chapter4.md, tests/, specs/019-add-metric-tooltips/

1. Contexte

Ce rapport fait suite à mes dernières livraisons sur les indicateurs, avec la même vision: faire de mon tableau de bord un véritable outil d'aide à la décision et préparer un socle d'information clair pour la future IA de conseil (voir ma Vision du projet).

Jusqu'ici, mes cartes d'indicateurs affichaient des signaux fiables, mais elles supposaient que l'on connaisse déjà le sens exact de chaque métrique et le seuil qui la déclenche. Pour une personne qui découvre l'application, ou pour moi-même après une pause, cette lecture demanderait un effort de mémoire. En parallèle, la vitrine publique et la fiche titre de démonstration mélangeaient encore français et anglais, ce qui nuisait à la crédibilité de la démonstration auprès du public.

2. Objectif

Rendre chaque indicateur immédiatement compréhensible et actionnable, sans quitter la page, et livrer une vitrine publique entièrement cohérente en anglais.

Concrètement, il s'agissait de :

  • expliquer chaque métrique directement sur sa carte, en langage simple, avec l'action à envisager ;
  • offrir un accès en un clic à la documentation détaillée du bon concept, pour approfondir sans se perdre ;
  • garantir que le tableau de bord reste stable et lisible même quand certaines données sont manquantes ;
  • uniformiser la vitrine publique et la fiche détaillée du titre démontré en anglais, dates comprises.

3. Ce qui a été livré

  • Des infobulles pédagogiques sur les sept cartes de métriques avancées : chaque carte présente désormais un point d'aide qui explique le sens de la métrique, la règle de déclenchement (le seuil exact), et l'action suggérée. L'ouverture se fait au survol sur ordinateur et au tap sur mobile, et la fermeture par clic à l'extérieur ou touche « Échap ».
  • Un lien contextuel vers la documentation : chaque infobulle mène directement à la section dédiée du chapitre 4 (Stratégie d'investissement), propre à la métrique concernée. Le libellé s'adapte au public — « En savoir plus » côté dashboard sécurisé, « Learn more » côté démo publique.
  • Un message clair en cas de donnée manquante : lorsqu'une métrique ne peut pas être évaluée faute d'information suffisante, la position est écartée et l'infobulle affiche explicitement « donnée insuffisante », plutôt que d'induire en erreur.
  • Un état de secours documentaire : si le lien de référence est absent ou invalide, l'infobulle affiche un message d'indisponibilité et désactive le lien, pour ne jamais renvoyer vers une page erronée.
  • Un tableau de bord plus résistant : le calcul de chaque indicateur est désormais isolé. Une seule donnée problématique n'empêche plus l'affichage des autres cartes ; le tableau de bord reste stable et exploitable.
  • Une vitrine publique entièrement en anglais : la page de démonstration et la fiche détaillée du titre démonstré sont désormais cohérentes en anglais, avec un affichage des dates en anglais garanti quel que soit le réglage régional du serveur.
  • Des points d'ancrage documentaires stables : le chapitre 4 (versions française et anglaise) a été enrichi d'ancres dédiées à chaque concept, pour assurer des liens fiables dans la durée.

4. Impact business

  • Compréhension immédiate : chaque signal explique lui-même son sens et l'action à envisager, ce qui réduit l'effort d'interprétation et accélère la décision.
  • Autonomie de l'utilisateur : l'accès direct au bon chapitre de documentation transforme le tableau de bord en outil pédagogique, sans recherche manuelle.
  • Confiance renforcée : le traitement explicite des données manquantes et des liens indisponibles protège la fiabilité perçue de l'outil.
  • Vitrine plus crédible : une démonstration entièrement en anglais donne une image professionnelle et homogène du produit.
  • Continuité de la vision : ces explications structurées constituent un contexte précieux que la future IA de conseil pourra réutiliser pour justifier ses recommandations.

5. Validation et statut

  • Suite de tests complète au vert : 227 passed.
  • Comportements clés couverts par des tests dédiés : présence des sept infobulles sur les deux vues, exactitude des liens vers les ancres du chapitre 4, libellé différencié entre dashboard et démo, message « donnée insuffisante » lorsque les colonnes requises manquent, et contrat de contenu uniforme des infobulles (sens, règle, action, lien).
  • Non-régression vérifiée : alignement des tests de la fiche titre sur la nouvelle interface anglaise, et préservation des cartes métier existantes.
  • Traçabilité : travaux réalisés sur la branche ajout_indicateurs_demo et cadrés par la spécification specs/019-add-metric-tooltips/.
  • Billet de traçabilité associé : #278.

6. Leçons apprises

  1. Un bon indicateur ne se contente pas d'être juste : il doit aussi se laisser comprendre sans effort. Expliquer la métrique à l'endroit exact où elle s'affiche vaut mieux qu'une documentation séparée que l'on ne consulte jamais.
  2. Isoler le calcul de chaque métrique rend l'ensemble du tableau de bord plus robuste : une donnée imparfaite dégrade une seule carte au lieu de compromettre toute la page.
  3. Bilan d'utilisation de jetons : la consommation brute enregistrée pour cette implémentation est de 11,45 $ pour 1142,32 crédits Copilot AI. Cette augmentation de coût par rapport à la tendance observée dans les plus récentes livraisons se justifie par l'envergure des changements qu'impliquaient la présente livraison: un nombre plus important de fichiers à lire, analyser et modifier par l'IA.