feat: iterate on the "voiture . prix d'achat" estimation

Author: EmileRolley

.gitignore

@@ -7,3 +7,4 @@ publicodes-voiture.model.json
 publicodes-voiture.personas.json
 publicodes-voiture.ui.json
 test.ts
+scripts/data/quechoisir/*.html

doc/specs.md

@@ -315,6 +315,27 @@ Avec ce choix, des questions peuvent se poser :
 > neuve et pour l'occasion ne pas la décompter ? Comment faire pour reporter
 > cette _dette d'empreinte_ lors d'un futur achat ?
 
+### Estimation du prix d'achat
+
+Pour le calcul des coûts de la voiture actuelle, il n'est pas nécessaire d'être
+très précis sur le prix d'achat puisqu'il pourra être facilement renseigné par
+l'utilisateurice. En revanche, **pour les alternatives, il est nécessaire
+d'avoir une estimation relativement précise du prix d'achat** pour pouvoir
+calculer les coûts. Or, **les prix varient énormément en fonction des modèles**
+au sein même d'une même catégorie de véhicule et il est difficile de trouver
+des sources et une méthodologie pour estimer ces prix en fonction du gabarit
+et du type de motorisation.
+
+**Il serait donc peut-être nécessaire de demander en plus la gamme de prix
+envisagé par l'utilisateurice pour les alternatives (entrée de gamme, milieu de
+gamme, luxe) pour pouvoir calculer une estimation plus précise des coûts**.
+Reste, à savoir comment déterminer les prix pour ces gammes en fonction du
+gabarit et de la motorisation.
+
+### Amortissement de l'empreinte de la construction
+
+TODO
+
 ### Quid des réglementation et interdiction sur des catégories de véhicules ?
 
 ## Ressources

rules/voiture.publicodes

@@ -63,44 +63,47 @@ voiture . occasion . décote:
 
 voiture . prix d'achat . estimé:
   titre: Prix d'achat estimé par défaut
+  decription: |
+    Prix d'achat moyen d'une voiture neuve en fonction du gabarit et de sa
+    motorisation.
   formule:
     variations:
       - si: voiture . gabarit = 'petite'
         alors:
           variations:
             - si: voiture . motorisation = 'thermique'
-              alors: 15000
-            - si: voiture . motorisation = 'hybride'
               alors: 19000
+            - si: voiture . motorisation = 'hybride'
+              alors: 22000
             - si: voiture . motorisation = 'électrique'
-              alors: 25000
+              alors: 32000
       - si: voiture . gabarit = 'moyenne'
         alors:
           variations:
             - si: voiture . motorisation = 'thermique'
-              alors: 20000
+              alors: 31000
             - si: voiture . motorisation = 'hybride'
-              alors: 23000
+              alors: 34000
             - si: voiture . motorisation = 'électrique'
-              alors: 30000
+              alors: 40000
       - si: voiture . gabarit = 'berline'
         alors:
           variations:
             - si: voiture . motorisation = 'thermique'
-              alors: 30000
+              alors: 38000
             - si: voiture . motorisation = 'hybride'
-              alors: 37000
+              alors: 42000
             - si: voiture . motorisation = 'électrique'
-              alors: 44000
+              alors: 48000
       - si: voiture . gabarit = 'SUV'
         alors:
           variations:
             - si: voiture . motorisation = 'thermique'
-              alors: 32000
+              alors: 40000
             - si: voiture . motorisation = 'hybride'
-              alors: 38000
+              alors: 44000
             - si: voiture . motorisation = 'électrique'
-              alors: 47000
+              alors: 50000
       - si: voiture . gabarit = 'VUL'
         alors:
           variations:
@@ -110,21 +113,39 @@ voiture . prix d'achat . estimé:
               alors: 38000
             - si: voiture . motorisation = 'électrique'
               alors: 45000
-      - sinon: 10
   unité: €
   note: |
-    Estimation du prix d'achat moyen d'une voiture neuve en France en fonction
-    de son gabarit et de sa motorisation.
+    La valeur du prix d'achat moyen d'une voiture neuve est importante pour le
+    calcul des coûts des alternatives et non vraiment pour le calcul de la
+    voiture actuelle. En effet, le prix d'achat de la voiture actuelle pourra
+    facilement être renseigné par l'utilisateurice. C'est pourquoi nous avons
+    choisi de nous baser sur des valeurs d'achat de voitures récentes, car ce
+    seront elles qui seront les plus susceptibles d'être achetées en
+    remplacement de la voiture actuelle.
+
+    Il est **très difficile de trouver une valeur moyenne pour le prix d'achat
+    car il y a de grand écarts entre les gammes de voitures**, les valeurs sont
+    donc à prendre avec du recul et pose un problème sur la précision de
+    l'estimation notamment pou les alternatives.
+
+    ### Sources
+
+    Pour déterminer un prix d'achat moyen, nous avons utilisé le
+    [script](https://github.com/betagouv/publicodes-voiture/blob/main/scripts/prix-voiture.js)
+    avec les données récupérées sur le comparateur [Que
+    Choisir](https://www.quechoisir.org/comparatif-voiture-citadine-n3).
+
+    Autres sources utilisées:
+    - [_Le tarif des autos neuves par segment_ (Kidioui)](https://voiture.kidioui.fr/voiture-neuve/3.html)
+    - [L'Argus](https://www.largus.fr)
+    - [Caroom](https://www.caroom.fr/guide/voiture-propre/electrique/carrosserie/suv)
 
-    Peut de réelles sources fiables sur le prix moyen d'une voiture neuve pour
-    l'instant. Donc pour l'instant, nous avons estimé les prix d'achat en
-    fonction du modèle de voiture en 2016.
+    #### Pistes d'amélioration
 
-    TODO: prendre le modèle le plus vendu pour chaque catégorie et regarder son
-    prix d'achat moyen en 2021.
+    Nous pourrions aller plus loin en prenant en compte les différents
+    carburants. Il faudrait alors trouver une source le détaillant. Cependant,
+    pour une première version, cela nous semble suffisant.
 
-    Sources utilisées:
-      - [L'Argus](https://www.largus.fr/mondial/prix-renault-zoe-2016-tarifs-et-equipements-de-la-ze-40-8154399.html)
 
 
 voiture . thermique . consommation:
@@ -326,17 +347,27 @@ voiture . gabarit:
     Si vous ne savez pas quel gabarit choisir, vous pouvez penser à la taille
     comme (petite, moyenne, grande, 4x4 urbain, camionnette).
   note: |
-    Nous considérons que la voiture par défaut est une "Berline", en témoigne
-    [une étude menée par AAA
-    Data](https://www.alphabet.com/fr-fr/parc-automobile-roulant-les-donnees-cles)
-    qui indique que "Si les SUV ont représenté 38 % des ventes de véhicules en
-    2019, ils ne représentent que 16 % de la totalité des véhicules en
-    circulation, loin derrière les berlines qui comptent pour 58 %, soit 23
-    millions de véhicules."
+    ### Sur le choix des gabarits
+
+    Nous avons choisi de distinguer les types de voiture par leur gabarit. Cela
+    fait référence aux [segments
+    automobiles](https://fr.wikipedia.org/wiki/Classification_des_automobiles)
+    définis par des lettres en Europe (A, B, etc...).
+
+    Ne semblant pas y avoir de dénomination faisant consensus entre les
+    différents acteurs du secteur automobile (concessionnaires, site
+    constructeur, journalisme auto, Car Labelling, etc...), nous avons fait le
+    choix de garder la même division en 5 catégories et valeur par défaut que
+    celle utilisée par [Nos Gestes
+    Climat](https://nosgestesclimat.fr/documentation/transport/voiture/gabarit)
+    pour plus de compatibilité et de simplicité.
+
+    Nous avons tout de même choisit de les renommer pour facilité la
+    compréhension des utilisateurices.
   avec:
     petite:
       titre: Citadine
-      description: Citadine type Zoé, Fiat 500
+      description: Citadine type Zoé, Fiat 500, Clio
     moyenne:
       titre: Monospace
       description: Modèle au dessus de la petite citadine, type Mégane, Golf

scripts/data/quechoisir/berline-essence-diesel.json

@@ -0,0 +1 @@
+{"items":{"Alfa Romeo Giulia 2.2 190 ch AT8":"43000","Audi A5 Sportback 40 TDI 204 S tronic 7 Quattro":"54650","BMW 320d 190 ch BVA8":"44100","BMW 320d 190 ch A":"43900","BMW 520d 190 ch BVA8":"48810","Jaguar XE D180 BVA AWD":"46960","Mercedes Classe C 220 d 9G-Tronic":"48300","Mercedes Classe C 200 9G-Tronic":"50550","Mercedes Classe E 220 d 9G-Tronic":"49200","Opel Insignia Grand Sport 2.0 D 170 ch BlueInjection":"37700","Opel Insignia Grand Sport 1.5 Turbo 165 ch":"34500","Peugeot 508 PureTech 180 S&S EAT8":"36400","Peugeot 508 2.0 BlueHDi 160 ch S&S EAT8":"38800","Volkswagen Arteon 2.0 BI-TDI 240 BMT DSG7 4Motion":"55840","Volkswagen Arteon 2.0 TSI 272 DSG7 4Motion":"57030","BMW 520d 197 ch BVA8":"65100"},"total":754840,"nbItems":16,"average":47177.5}

scripts/data/quechoisir/citadine-essence.json

@@ -0,0 +1,62 @@
+{
+  "items": {
+    "Renault Twingo SCe 75": "13500",
+    "Mazda 2 1.5L e-SKYACTIV G M Hybrid 115ch Homura Aka": "26450",
+    "KIA Rio 1.0 T-GDi 100 ch ISG BVM6": "18090",
+    "Mazda 2 e-SKYACTIV-G 90 M Hybrid": "19700",
+    "Seat Ibiza 1.0 EcoTSI 95 ch S/S BVM5": "16700",
+    "Citroën C3 PureTech 110 S&S EAT6 Shine Pack": "23850",
+    "Mini One 102 ch": "20600",
+    "Dacia Sandero TCe 90 Stepway Essentiel": "13690",
+    "Mazda 2 1.5L Skyactiv-G M Hybrid 90ch": "18350",
+    "KIA Picanto 1.2 DPi 84ch ISG BVM5": "15690",
+    "Fiat 500 1.0 70 ch Hybride BSG S/S": "15290",
+    "Hyundai i10 1.0 T-GDI 100": "17750",
+    "Renault Clio TCe 90 Energy": "16000",
+    "Mitsubishi Space Star 1.2 MIVEC 71 AS&G": "12390",
+    "Seat Ibiza 1.5 TSI 150 ch S/S ACT DSG7 FR": "26960",
+    "Volkswagen Polo 1.0 TSI 95 S&S DSG7 Style": "24710",
+    "Renault Clio TCe 120 Energy": "19300",
+    "Suzuki Swift 1.2 Dualjet Hybrid": "14540",
+    "Nissan Micra DIG-T 117": "20790",
+    "Hyundai i10 1.0 T-GDI 100 N Line": "20100",
+    "Renault Clio TCe 100": "18000",
+    "Skoda Fabia 1.0 TSI 95 ch BVM5 Style": "23840",
+    "Fiat Panda 1.0 70 ch Hybride BSG S/S": "13000",
+    "Dacia Sandero Stepway TCe 90": "12720",
+    "Suzuki Swift 1.2 Dualjet Allgrip": "16140",
+    "Hyundai i20 1.0 T-GDi 100": "22100",
+    "Volkswagen Polo 2.0 TSI 200 S&S DSG6 GTI": "29430",
+    "Ford Fiesta 1.0 EcoBoost 140 S/S BVM6 Active": "22600",
+    "KIA Picanto 1.0L 67 ch BVM5": "10900",
+    "Hyundai i20 1.0 T-GDi 100 DCT-7 Hybrid 48V N Line": "24200",
+    "Ford Ka+ 1.2 85 ch S&S": "12150",
+    "Fiat Panda Cross 1.0 70 ch Hybride BSG S/S": "14490",
+    "Audi A1 Sportback 30 TFSI 116 ch S tronic 7": "26160",
+    "Smart Fortwo Cabrio 0.9 90 ch S&S A": "21700",
+    "Hyundai i10 1.0 67": "15500",
+    "Audi A1 Citycarver 35 TFSI 150 ch S tronic 7": "29710",
+    "Citroën C3 PureTech 83 S&S BVM5 YOU!": "16590",
+    "Dacia Sandero TCe 90 Expression": "14900",
+    "Ford Fiesta 1.0 EcoBoost 125 ch S&S mHEV BVM6 ST-Line X": "24990",
+    "Renault Clio TCe 130 EDC FAP": "24600",
+    "Skoda Fabia 1.0 TSI 110 Style": "22720",
+    "Renault Twingo III 0.9 TCe Energy": "13300",
+    "Toyota Aygo 1.0 VVT-i": "13990",
+    "Seat Ibiza 1.0 EcoTSI 115 ch S/S BVM6": "18160",
+    "Peugeot 208 PureTech 130 S&S EAT8": "24700",
+    "Fiat 500 0.9 105 ch TwinAir S&S": "17590",
+    "Opel Corsa 1.2 Turbo 100 ch BVM6": "16800",
+    "Peugeot 208 PureTech 100 S&S BVM6": "18900",
+    "Opel Corsa 1.2 Turbo 130 ch BVA8": "22100",
+    "Renault Clio TCe 90 Techno": "21500",
+    "Nissan Micra IG-T 90": "15490",
+    "Volkswagen Polo 1.0 TSI 115 S&S DSG7": "22800",
+    "Honda Jazz 1.5 i-VTEC": "20250",
+    "Mini Cooper 136 ch BVA7": "27000"
+  },
+  "total": 1061370,
+  "nbItems": 55,
+  "average": 19297.636363636364
+}
+

scripts/data/quechoisir/citadine-électrique.json

@@ -0,0 +1 @@
+{"items":{"BMW i3s 94 Ah 184 ch":"42200","BMW i3 120 Ah 170 ch":"39950","Fiat 500C e 118 ch":"33300","Fiat 500 e 118 ch La Prima":"39400","Fiat 500 e 95 ch (RED) 2.0":"31400","Honda e Advance 17":"41270","Mini Cooper SE 184 ch (électrique)":"32900","Opel Corsa Electrique 136 ch Elegance":"33600","Peugeot e-208 électrique 50 kWh 136ch GT":"38355","Renault Twingo III E-Tech Electrique Techno":"27950","Renault Zoe 41 kWh":"23700","Renault Zoe R135 Achat Intégral / 52 kWh":"34600","Seat Mii Electric 83 ch":"21920","Smart Forfour EQ 0,82 ch":"27350","Smart Fortwo coupé 82 ch électrique BA1":"22950","Volkswagen e-up! électrique":"23740","Peugeot e-208 Electrique 51 kWh 156ch GT":"39300"},"total":553885,"nbItems":17,"average":32581.470588235294}

scripts/data/quechoisir/monospace-familiale-essence-diesel.json

@@ -0,0 +1 @@
+{"items":{"BMW 218d Active Tourer 150 ch BVA8":"34900","BMW 220i Active Tourer":"38950","Citroën Berlingo M PureTech 110 S&S BVM6":"21950","Citroën Berlingo M BlueHDi 130 S&S BVM6":"26450","Dacia Dokker Blue dCi 95":"15500","Dacia Jogger TCe 110 7 places SL Extreme":"20900","Ford Tourneo Connect 1.5 EcoBoost 114 DSG7 Titanium":"32600","Mercedes Classe B 220 d 8G-DCT":"45600","Mercedes Classe T 180 7G-DCT Progressive":"31027","Opel Combo Life 1.2 110 ch Start/Stop (L1H1)":"21300","Peugeot Rifter Long BlueHDi 130 S&S BVM6":"27050","Renault Grand Scenic dCi 160 Energy EDC":"36400","Renault Kangoo TCe 130 FAP":"28150","Renault Scenic dCi 130 Energy Edition One":"35500","Renault Scenic TCe 140 FAP":"28700","Toyota Proace City Verso Medium 1.2L 110 VVT-i BVM6":"23040","Volkswagen Caddy 2.0 TDI 122 DSG7 Life":"37260","Volkswagen Caddy 1.5 TSI 114 BVM6 Life":"32140","Volkswagen Golf Sportsvan 1.5 TSI 130 EVO BlueMotion Technology DSG7":"29900","Volkswagen Touran 2.0 TDI 150 DSG7 5pl":"37650","Volkswagen Touran 1.5 TSI EVO 150 DSG7":"43240","Mercedes Classe B 250 e 8G-DCT AMG Line":"53650"},"total":701857,"nbItems":22,"average":31902.590909090908}