Aller au contenu

Ajout d'indicateurs de valorisation P/E & PEG

Billet #275 : Ajout des indicateurs de valorisation P/E et PEG (haut et bas)
Type : Fonctionnalité / Aide à la décision / Analyse métier
Composants concernés : code_source_simule/portfolio_metrics.py, code_source_simule/flask_app.py, code_source_simule/tooltip_guidance.py, templates/dashboard.html, templates/demo_index.html, tests/test_portfolio_metrics.py, tests/test_dashboard.py, tests/test_tooltip_guidance_contract.py, tests/conftest.py, data_fixtures/pe_ratio_indicators.csv, data_fixtures/peg_ratio_indicators.csv, docs/features/chapter4.md, docs/fr/features/chapter4.md, specs/017-global-quality-indicators/

1. Contexte

Cette implémentation est une prolongation de mes deux dernières interventions sur l'ajout d'indicateurs de règles de gestion puis de signaux d'analystes. La logique reste identique : transformer mon tableau de bord en 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).

Cette fois, je m'attaque à un angle de lecture qui manquait encore : la valorisation des titres à travers deux ratios complémentaires, le P/E (prix vs bénéfices) et le PEG (prix vs bénéfices ajustés de la croissance attendue). Ces repères sont centraux dans ma stratégie d'investissement, mais ils n'étaient visibles nulle part de façon synthétique sur le dashboard et la démo.

2. Objectif

Rendre immédiatement lisibles les titres les plus chèrement valorisés et les moins chèrement valorisés du portefeuille, à la fois sous l'angle prix/bénéfices (P/E) et sous l'angle prix/croissance (PEG), afin de repérer d'un coup d'œil les extrêmes qui méritent une attention.

Concrètement, il s'agissait de :

  • faire ressortir les dix titres au P/E le plus élevé et les dix titres au P/E le plus bas ;
  • faire ressortir les dix titres au PEG le plus élevé et les dix titres au PEG le plus bas ;
  • afficher pour chaque ligne le ticker et son ratio actuel dans un format propre et comparable ;
  • conserver exactement le langage visuel des cartes de performeurs déjà présentes, pour une lecture sans effort d'adaptation.

3. Ce qui a été livré

  • Quatre nouveaux indicateurs de valorisation livrés en parallèle sur /dashboard et /demo :
    • Ratios P/E les + élevés : les dix titres dont le P/E est le plus haut, triés du plus élevé au plus faible.
    • Ratios P/E les + bas : les dix titres dont le P/E est le plus bas, triés du plus faible au plus élevé.
    • Ratios PEG les + élevés : les dix titres dont le PEG est le plus haut, triés du plus élevé au plus faible.
    • Ratios PEG les + bas : les dix titres dont le PEG est le plus bas, triés du plus faible au plus élevé.
  • Une présentation lisible et disciplinée :
    • chaque ligne affiche le ticker et le ratio (P/E ou PEG) avec deux décimales ;
    • un tri déterministe : à valeur égale, les titres sont départagés par ticker de A à Z ;
    • un état vide explicite par carte lorsqu'aucun titre n'est éligible, pour éviter toute ambiguïté.
  • Une règle d'inclusion volontairement stricte : seuls les titres avec un ratio numérique strictement positif sont retenus, car les valeurs nulles, négatives ou non exploitables ne sont pas comparables pour une lecture de valorisation.
  • Un périmètre de calcul autonome : les indicateurs s'appuient strictement sur les données courantes du fichier CSV, en retenant la valeur la plus récente disponible par titre, sans dépendance à une source de marché externe.
  • Une cohérence visuelle stricte : les cartes P/E et PEG réutilisent la structure et les styles des blocs de référence « Top / Flop Performeurs ».
  • Une cohérence pédagogique renforcée : les infobulles PEG ont été intégrées dans le même contrat métier que les infobulles existantes, avec ancrage direct vers la documentation de stratégie (chapitre 4).

4. Impact business

  • Lecture de valorisation immédiate, sous deux angles : je repère instantanément les extrêmes P/E et PEG sans calcul ni tri manuel.
  • Décision mieux outillée : le duo P/E + PEG permet de distinguer une valorisation simplement élevée d'une valorisation élevée potentiellement justifiée par la croissance.
  • Continuité de la vision : cet ajout complète les indicateurs précédents et enrichit encore le contexte que la future IA de conseil pourra exploiter.
  • Fiabilité de l'information : un filtrage strict des ratios non exploitables (P/E et PEG) protège la qualité du signal au moment de décider.

5. Validation et statut

  • Suite de tests ciblée de la fonctionnalité au vert : 71 passed.
  • Comportements clés couverts par des tests dédiés : filtrage des P/E et PEG manquants, non numériques ou inférieurs ou égaux à zéro, tri décroissant et croissant selon la carte, départage par ticker A-Z en cas d'égalité, affichage à deux décimales, état vide par carte, et parité visuelle avec les cartes de référence.
  • Contrat des infobulles validé : présence des nouvelles clés P/E et PEG, cohérence des liens d'ancrage et robustesse des messages de fallback.
  • Non-régression vérifiée : les cartes de performeurs existantes restent intactes après l'ajout des quatre cartes de valorisation.
  • Billet de traçabilité associé : #275.

6. Leçons apprises

  1. Réutiliser un langage visuel déjà connu accélère la livraison et réduit la charge de lecture : l'utilisateur reconnaît immédiatement la logique d'une nouvelle carte, même quand on ajoute une seconde famille de ratios.
  2. Un filtre d'inclusion clair et explicite (ici, uniquement des ratios strictement positifs) vaut mieux qu'un affichage exhaustif : mieux vaut un signal juste que beaucoup de bruit.
  3. Livrer P/E et PEG en même temps améliore la pertinence décisionnelle : le P/E donne la cherté brute, le PEG remet cette cherté en perspective avec la croissance attendue.
  4. Bilan d'utilisation de jetons : pour cet ajout conjoint des indicateurs de valorisation P/E et PEG, la consommation brute enregistrée est de 13,69$ pour 1360,6 crédits Copilot AI. En comparaison des implémentations similaires récentes mentionnées dans la section Contexte ci-dessus, cette troisième livraison a donc coûté environ 22.45 % de plus que la seconde livraison mais 16,88 % de moins que la première livraison. Cette augmentation par rapport à la précédente livraison peut s'expliquer par l'envergure de la présente implémentation: 4 indicateurs ajoutés aujourd'hui VS 3 précédemment.