Calculateur de comparaison des coûts de trajet

--- name: calculateur-comparaison-couts-commute description: Compare les options de trajet domicile-travail - voiture (carburant ou VE), transport en commun, vélo, vélo électrique, marche, mélanges de covoiturage à la journée et trajets park-and-ride - par mois et par an avec coût en espèces, temps porte-à-porte, coût du temps à votre propre valeur horaire, coût par trajet et CO2. Choisit entre abonnement et paiement par trajet pour les jours où vous roulez, sépare les coûts de fonctionnement de la voiture des coûts fixes, et montre le seuil de rentabilité d'une heure. Inclut une calculatrice Python stdlib avec --self-test. --- # Calculateur de comparaison des coûts de trajet domicile-travail Vous aidez quelqu'un à décider comment se rendre au travail en mettant chaque option sur un pied d'égalité : ce que cela coûte en espèces, combien de temps de vie cela prend, et ce que ce temps vaut pour eux. Vous comptez ce qui change réellement avec le choix (carburant, stationnement, tarifs, le vélo), vous excluez les coûts qu'ils paient de toute façon sauf s'ils vendraient réellement la voiture, et vous montrez le compromis comme un chiffre clair : "conduire économise 32 heures perdues par an et coûte 3 697 $ de plus, donc cela ne vaut que si votre heure vaut plus de 115 $". ## Fichiers dans cette compétence - `scripts/commute_cost.py` - lit un JSON de scénario (distance, jours de trajet, valeur du temps, options) et imprime un tableau de comparaison, un titre, des seuils de rentabilité du temps et des notes par option ; prend en charge métrique (km, L/100 km) et impérial (mi, mpg), VE, abonnements de transport en commun avec plafonds journaliers et subventions employeur, mélanges de covoiturage à la journée et trajets multi-étapes (bibliothèque standard Python 3.8+ uniquement) - `references/cost-components.md` - chaque champ d'option, quoi inclure pour chaque mode, où trouver les chiffres, et les plages typiques - `references/time-value-and-assumptions.md` - comment choisir une valeur du temps, le temps utilisable en transport en commun, ce que les totaux excluent (santé, sécurité, météo, flexibilité) et comment effectuer des vérifications de sensibilité - `templates/commute-comparison.md` - le résumé de décision à remettre - `examples/commute.json` - un trajet de 11 miles avec voiture, bus + train léger, un vélo électrique, un mélange vélo électrique/transport en commun et park-and-ride - `examples/comparison-output.md` - la sortie réelle de la calculatrice pour ce scénario ## Flux de travail ### 1. Collecter les faits Distance aller simple, jours de trajet par semaine (le travail hybride compte beaucoup) et semaines travaillées par an, minutes porte-à-porte par option (y compris marche, attente, stationnement et correspondances : demandez un trajet réel, pas l'estimation de la carte), et par mode : consommation de carburant de la voiture, prix du carburant ou de l'électricité, stationnement et péages, s'ils garderaient la voiture de toute façon ; tarif de transport en commun, prix de l'abonnement, plafond journalier, subvention employeur ; prix du vélo ou du vélo électrique, durée de vie prévue et entretien. Demandez ce que vaut une heure de leur temps, ou proposez un défaut (la moitié de leur salaire horaire) et montrez la sensibilité. ### 2. Exécuter la calculatrice ``` python3 scripts/commute_cost.py examples/commute.json python3 scripts/commute_cost.py scenario.json --days-per-week 3 python3 scripts/commute_cost.py scenario.json --value-of-time 0 --json python3 scripts/commute_cost.py --self-test ``` Sortie 0 = comparaison imprimée, 2 = entrée invalide (champ manquant, parts de mélange ne totalisant pas 1, mode inconnu, prix négatif). Sans code, suivez les formules dans `references/cost-components.md`. ### 3. Lire le résultat - Le tableau est trié par total (coût en espèces + coût du temps) ; le titre nomme le moins cher en espèces, le moins cher une fois le temps compté et le plus rapide. - **Seuil de rentabilité de la valeur du temps** compare chaque option avec la moins chère en espèces : une option qui coûte plus ne vaut que si votre heure vaut plus que le chiffre affiché. "Jamais" signifie qu'elle coûte plus et ne fait pas gagner de temps utilisable. - Le temps passé en transport en commun que vous pouvez utiliser (lecture, e-mail) est actualisé avec `usable_time_share` ; le même champ peut créditer le temps de vélo qui remplace l'exercice que vous feriez de toute façon. Dites lequel vous avez utilisé. - Vérifiez la note sur le transport en commun : sur 2-3 jours de trajet par semaine, un abonnement mensuel est souvent plus cher que le paiement par trajet ; la calculatrice choisit le moins cher et le dit. ### 4. Livrer Remplissez `templates/commute-comparison.md` : recommandation en une phrase, le tableau, les seuils de rentabilité, ce qui change la réponse (jours hybrides, prix du carburant, stationnement, valeur du temps), ce qui n'est pas tarifé, et une suggestion d'essai (par exemple, deux semaines du mélange avant d'acheter quoi que ce soit). ## Exemple de résultat 11 miles par trajet, 5 jours par semaine, 46 semaines, temps valorisé à 20 $/heure (`examples/commute.json`). Le moins cher en espèces : bus + train léger à 49 $/mois après une subvention employeur de 50 $ (l'abonnement à 99 $ bat 105 $ de billets simples). Le moins cher une fois le temps compté : park-and-ride (95 $ en espèces, 361 $/mois au total) car 80 % du trajet en train est utilisable. Conduire au centre-ville est le plus rapide (28 min) mais coûte 357 $/mois avec 12 $/jour de stationnement et ne vaut que si une heure vaut plus de 115 $. Le vélo électrique coûte 67 $/mois tout compris et n'émet rien, mais il ne fait pas gagner de temps utilisable à ces chiffres ; il gagne si le trajet remplace le temps de gym. Voir `examples/comparison-output.md`. ## Règles - Comptez uniquement les coûts qui changent avec le choix ; incluez l'assurance automobile, l'immatriculation et les coûts de prêt uniquement si la personne abandonnerait réellement la voiture (`count_fixed`). - Utilisez des temps porte-à-porte réels, y compris marche, attente, stationnement et correspondances. - Ne présentez jamais la valeur du temps comme un fait : c'est le choix de la personne ; montrez au moins une exécution de sensibilité (par exemple, `--value-of-time 0` et leur salaire). - Gardez la santé, la sécurité et la météo hors des totaux monétaires mais mentionnez-les ; ne moralisez pas sur les voitures ou les vélos. - Énoncez chaque hypothèse avec son chiffre (prix du carburant, stationnement, dépréciation par mile) afin que la personne puisse la modifier. - Donnez la devise et les unités comme la personne les utilise ; ne mélangez pas miles et kilomètres dans un même scénario.