Calculadora de Comparação de Custo de Deslocamento

--- name: calculadora-comparacao-custo-deslocamento description: Compara opcoes de deslocamento - carro (combustivel ou eletrico), transporte publico, bicicleta, bicicleta eletrica, caminhada, combinacoes de compartilhamento diario e trechos de estacionar-e-embarcar - por mes e ano com custo em dinheiro, tempo porta-a-porta, custo do tempo ao seu proprio valor por hora, custo por viagem e CO2. Escolhe passe versus pagamento por viagem para os dias em que voce viaja, separa custos de uso do carro de custos fixos e mostra o ponto de equilibrio do valor de uma hora. Inclui uma calculadora Python com biblioteca padrao com --self-test. --- # Calculadora de Comparacao de Custo de Deslocamento Voce ajuda alguem a decidir como ir ao trabalho colocando todas as opcoes no mesmo patamar: o que custa em dinheiro, quanto da vida da pessoa consome e quanto esse tempo vale para ela. Voce conta apenas o que realmente muda com a escolha (combustivel, estacionamento, tarifas, a bicicleta), mantem os custos que a pessoa pagaria de qualquer forma fora, a menos que ela realmente vendesse o carro, e mostra a troca como um numero claro: "dirigir economiza 32 horas perdidas por ano e custa R$ 3.697 a mais, entao so compensa se sua hora valer mais de R$ 115". ## Arquivos nesta habilidade - `scripts/commute_cost.py` - le um cenario JSON (distancia, dias de deslocamento, valor do tempo, opcoes) e imprime uma tabela de comparacao, titulo, valores de equilibrio do tempo e notas por opcao; suporta metrico (km, L/100 km) e imperial (mi, mpg), veiculos eletricos, passes de transporte publico com limites diarios e subsidios do empregador, combinacoes de compartilhamento diario e viagens de multiplos trechos (somente biblioteca padrao Python 3.8+) - `references/cost-components.md` - cada campo de opcao, o que incluir para cada modal, onde encontrar os numeros e faixas tipicas - `references/time-value-and-assumptions.md` - como escolher um valor do tempo, tempo utilizavel no transporte publico, o que os totais deixam de fora (saude, seguranca, clima, flexibilidade) e como fazer verificacoes de sensibilidade - `templates/commute-comparison.md` - o resumo da decisao para entregar - `examples/commute.json` - um deslocamento de 11 milhas com dirigir, onibus + trem leve, uma bicicleta eletrica, uma combinacao de bicicleta eletrica/transporte publico e estacionar-e-embarcar - `examples/comparison-output.md` - a saida real da calculadora para esse cenario ## Fluxo de trabalho ### 1. Colete os fatos Distancia de ida, dias de deslocamento por semana (trabalho hibrido importa muito) e semanas trabalhadas por ano, minutos porta-a-porta por opcao (incluindo caminhada, espera, estacionamento e transferencias: peca uma viagem real, nao a estimativa do mapa), e por modal: economia de combustivel do carro, preco do combustivel ou eletricidade, estacionamento e pedagios, se a pessoa manteria o carro de qualquer forma; tarifa de transporte publico, preco do passe, limite diario, subsidio do empregador; preco da bicicleta ou bicicleta eletrica, vida util esperada e manutencao. Pergunte quanto vale uma hora do tempo da pessoa, ou ofereca um padrao (metade do salario por hora) e mostre a sensibilidade. ### 2. Execute a 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 ``` Saida 0 = comparacao impressa, 2 = entrada invalida (campo ausente, participacoes de combinacao que nao somam 1, modal desconhecido, preco negativo). Sem codigo, siga as formulas em `references/cost-components.md`. ### 3. Leia o resultado - A tabela e ordenada pelo total (custo em dinheiro + custo do tempo); o titulo nomeia o mais barato em dinheiro, o mais barato quando o tempo conta e o mais rapido. - **Valor de equilibrio do tempo** compara cada opcao com a mais barata em dinheiro: uma opcao que custa mais so vale a pena se sua hora valer mais do que o numero mostrado. "Nunca" significa que custa mais e nao economiza tempo utilizavel. - O tempo gasto no transporte publico que voce pode usar (ler, e-mail) e descontado com `usable_time_share`; o mesmo campo pode creditar tempo de bicicleta que substitui exercicio que voce faria de qualquer forma. Diga qual voce usou. - Verifique a nota de transporte publico: em 2-3 dias de deslocamento por semana, um passe mensal costuma ser mais caro que pagamento por viagem; a calculadora escolhe o mais barato e informa. ### 4. Entregue Preencha `templates/commute-comparison.md`: recomendacao em uma frase, a tabela, valores de equilibrio, o que muda a resposta (dias hibridos, preco do combustivel, estacionamento, valor do tempo), o que nao esta precificado e uma sugestao de teste (por exemplo, duas semanas da combinacao antes de comprar qualquer coisa). ## Exemplo de resultado 11 milhas por trecho, 5 dias por semana, 46 semanas, tempo avaliado em R$ 20/hora (`examples/commute.json`). Mais barato em dinheiro: onibus + trem leve a R$ 49/mes apos um subsidio de R$ 50 do empregador (o passe de R$ 99 vence R$ 105 em tarifas individuais). Mais barato quando o tempo conta: estacionar-e-embarcar (R$ 95 em dinheiro, R$ 361/mes no total) porque 80 % do trecho de trem e utilizavel. Dirigir para o centro e o mais rapido (28 min) mas custa R$ 357/mes com R$ 12/dia de estacionamento e so compensa se uma hora valer mais de R$ 115. A bicicleta eletrica custa R$ 67/mes tudo incluido e nao emite nada, mas nao economiza tempo utilizavel nesses numeros; ela vence se o passeio substituir tempo de academia. Veja `examples/comparison-output.md`. ## Regras - Conte apenas custos que mudam com a escolha; inclua seguro do carro, licenciamento e custos de financiamento somente se a pessoa realmente abrisse mao do carro (`count_fixed`). - Use tempos reais porta-a-porta, incluindo caminhada, espera, estacionamento e transferencias. - Nunca apresente o valor do tempo como um fato: e uma escolha da propria pessoa; mostre pelo menos uma execucao de sensibilidade (por exemplo, `--value-of-time 0` e o salario dela). - Mantenha saude, seguranca e clima fora dos totais em dinheiro, mas mencione-os; nao moralize sobre carros ou bicicletas. - Declare cada premissa com seu numero (preco do combustivel, estacionamento, depreciacao por milha) para que a pessoa possa altera-la. - Use moeda e unidades conforme a pessoa usa; nao misture milhas e quilometros em um mesmo cenario.