Calculadora de Comparación de Costos de Desplazamiento

--- name: commute-cost-comparison-calculator description: Compara opciones de desplazamiento - coche (combustible o eléctrico), transporte público, bicicleta, bicicleta eléctrica, caminar, mezclas de uso compartido por día y tramos de park-and-ride - por mes y año con costo en efectivo, tiempo de puerta a puerta, costo del tiempo a tu propio valor por hora, costo por viaje y CO2. Elige pase vs pago por viaje para los días que viajas, separa los costos de operación del coche de los costos fijos, y muestra el punto de equilibrio del valor de una hora. Incluye una calculadora Python de stdlib con --self-test. --- # Calculadora de Comparación de Costos de Desplazamiento Ayudas a alguien a decidir cómo llegar al trabajo poniendo cada opción en la misma base: lo que cuesta en efectivo, cuánto de su vida toma, y cuánto vale ese tiempo para ellos. Cuentas lo que realmente cambia con la elección (combustible, estacionamiento, tarifas, la bicicleta), mantienes fuera los costos que pagan de todos modos a menos que realmente vendieran el coche, y muestras el equilibrio como un número claro: "conducir ahorra 32 horas perdidas al año y cuesta $3,697 más, así que solo vale si tu hora vale más de $115". ## Archivos en esta habilidad - `scripts/commute_cost.py` - lee un JSON de escenario (distancia, días de desplazamiento, valor del tiempo, opciones) e imprime una tabla de comparación, titular, valores de equilibrio del tiempo y notas por opción; soporta métrico (km, L/100 km) e imperial (mi, mpg), vehículos eléctricos, pases de transporte con topes diarios y subsidios del empleador, mezclas de uso compartido por día y viajes de múltiples tramos (solo biblioteca estándar de Python 3.8+) - `references/cost-components.md` - cada campo de opción, qué incluir para cada modo, dónde encontrar los números, y rangos típicos - `references/time-value-and-assumptions.md` - cómo elegir un valor del tiempo, tiempo utilizable en transporte público, qué omiten los totales (salud, seguridad, clima, flexibilidad) y cómo ejecutar verificaciones de sensibilidad - `templates/commute-comparison.md` - el resumen de decisión para entregar - `examples/commute.json` - un desplazamiento de 11 millas con conducción, autobús + tren ligero, una bicicleta eléctrica, una mezcla de bicicleta eléctrica/transporte público y park-and-ride - `examples/comparison-output.md` - la salida real de la calculadora para ese escenario ## Flujo de trabajo ### 1. Recopila los hechos Distancia de ida, días de desplazamiento por semana (el trabajo híbrido importa mucho) y semanas trabajadas por año, minutos de puerta a puerta por opción (incluyendo caminar, esperar, estacionar y transbordos: pide un viaje real, no la estimación del mapa), y por modo: economía de combustible del coche, precio de combustible o electricidad, estacionamiento y peajes, si mantendrían el coche de todos modos; tarifa de transporte público, precio del pase, tope diario, subsidio del empleador; precio de bicicleta o bicicleta eléctrica, vida útil esperada y mantenimiento. Pregunta cuánto vale una hora de su tiempo, u ofrece un valor predeterminado (la mitad de su pago por hora) y muestra la sensibilidad. ### 2. Ejecuta la calculadora ``` 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 ``` Salida 0 = comparación impresa, 2 = entrada incorrecta (campo faltante, proporciones de mezcla que no suman 1, modo desconocido, precio negativo). Sin código, sigue las fórmulas en `references/cost-components.md`. ### 3. Lee el resultado - La tabla está ordenada por total (efectivo + costo de tiempo); el titular nombra el más barato en efectivo, el más barato una vez que el tiempo cuenta y el más rápido. - **Valor de equilibrio del tiempo** compara cada opción con la más barata en efectivo: una opción que cuesta más vale solo si tu hora vale más que el número mostrado. "Nunca" significa que cuesta más y no ahorra tiempo utilizable. - El tiempo en transporte público que puedes usar (leer, correo) se descuenta con `usable_time_share`; el mismo campo puede acreditar tiempo en bicicleta que reemplaza ejercicio que harías de todos modos. Di cuál usaste. - Revisa la nota de transporte público: en 2-3 días de desplazamiento por semana, un pase mensual suele ser más caro que el pago por viaje; la calculadora elige el más barato y lo dice. ### 4. Entrega Completa `templates/commute-comparison.md`: recomendación en una oración, la tabla, valores de equilibrio, qué cambia la respuesta (días híbridos, precio del combustible, estacionamiento, valor del tiempo), qué no está valorado, y una sugerencia de prueba (por ejemplo, dos semanas de la mezcla antes de comprar algo). ## Resultado de ejemplo 11 millas por trayecto, 5 días a la semana, 46 semanas, tiempo valorado a $20/hora (`examples/commute.json`). Más barato en efectivo: autobús + tren ligero a $49/mes después de un subsidio del empleador de $50 (el pase de $99 supera los $105 de tarifas individuales). Más barato una vez que el tiempo cuenta: park-and-ride ($95 en efectivo, $361/mes en total) porque el 80 % del tramo de tren es utilizable. Conducir al centro es lo más rápido (28 min) pero cuesta $357/mes con estacionamiento de $12/día y solo vale si una hora vale más de $115. La bicicleta eléctrica cuesta $67/mes todo incluido y no emite nada, pero no ahorra tiempo utilizable con estos números; gana si el viaje reemplaza tiempo de gimnasio. Ver `examples/comparison-output.md`. ## Reglas - Cuenta solo costos que cambian con la elección; incluye seguro del coche, registro y costos de préstamo solo si la persona realmente renunciaría al coche (`count_fixed`). - Usa tiempos reales de puerta a puerta, incluyendo caminar, esperar, estacionar y transbordos. - Nunca presentes el valor del tiempo como un hecho: es la elección propia de la persona; muestra al menos una ejecución de sensibilidad (por ejemplo, `--value-of-time 0` y su salario). - Mantén salud, seguridad y clima fuera de los totales de dinero pero menciónalos; no moralices sobre coches o bicicletas. - Declara cada suposición con su número (precio del combustible, estacionamiento, depreciación por milla) para que la persona pueda cambiarla. - Da moneda y unidades como las usa la persona; no mezcles millas y kilómetros en un mismo escenario.