FuelCalc é uma aplicação web progressiva (PWA) projetada para ajudar motoristas (especialmente de aplicativos como Uber e 99) a calcular e gerenciar seus gastos com combustível de forma eficiente. A aplicação oferece estatísticas detalhadas, gerenciamento de múltiplos veículos, histórico de viagens e muito mais, tudo com uma interface moderna e responsiva.
Tela principal e gerenciamento de veículos.
- 🚗 Gerenciamento de Múltiplos Veículos: Adicione, selecione e exclua diferentes veículos (carros e motos), cada um com sua própria eficiência de combustível.
- ⛽ Cálculo Preciso de Consumo: Calcule os litros consumidos e o custo total da viagem com base na quilometragem, eficiência do veículo e preço do combustível.
- 💰 Cálculo de Lucro (Opcional): Informe o ganho bruto da viagem para calcular o lucro líquido.
- 📊 Estatísticas Detalhadas: Visualize estatísticas por tipo de veículo, incluindo total de KM rodados, total gasto com combustível e média de consumo geral. Inclui um gráfico de gastos diários.
- 📅 Histórico Completo de Viagens: Mantenha um histórico de todas as suas viagens calculadas, com detalhes completos acessíveis através de um modal.
- 🌐 Internacionalização (i18n): Suporte para Português (Brasil) (padrão) e Inglês, com seletor de idioma na interface.
- 💾 Persistência de Dados Local: Todos os dados de veículos e histórico são salvos localmente no seu navegador usando
localStorage. - 📤📥 Backup e Restauração: Exporte todos os seus dados para um ficheiro JSON e importe-os posteriormente.
- 🗑️ Limpeza de Dados: Opções para limpar o histórico de um tipo de veículo específico ou limpar completamente todos os dados da aplicação (com dupla confirmação).
- 📱 Progressive Web App (PWA):
- Instalável na tela inicial do seu dispositivo (desktop e mobile).
- Funciona offline para funcionalidades básicas após o primeiro carregamento.
- Interface responsiva que se adapta a diferentes tamanhos de ecrã.
- 🎨 Interface Moderna: Tema escuro elegante e componentes de UI customizados para notificações e modais.
- 🔢 Exibição de Versão: A versão atual da aplicação é exibida no rodapé.
- Frontend:
(ES6+ com Classes)
- Bibliotecas:
(para gráficos de estatísticas)
- Recursos PWA:
- Service Workers
- Web App Manifest
- Armazenamento:
- LocalStorage
Acesse a aplicação diretamente através do link do GitHub Pages: https://johnaugust934.github.io/FuelCalc/
- Clone o repositório:
git clone [https://github.com/JohnAugust934/FuelCalc.git](https://github.com/JohnAugust934/FuelCalc.git)
- Navegue até a pasta do projeto:
cd FuelCalc - Abra o
index.htmlno seu navegador:- Simplesmente abra o ficheiro
index.htmldiretamente no seu navegador. - Ou, para uma melhor simulação do ambiente de servidor e para o Service Worker funcionar corretamente localmente, use um servidor local simples. Se tiver Node.js instalado:
E acesse o endereço fornecido (geralmente
npx serve .http://localhost:3000).
- Simplesmente abra o ficheiro
- Selecione o Idioma: Use os botões 🇧🇷 PT-BR / 🇬🇧 EN no canto superior direito para escolher o seu idioma preferido.
- Gerencie seus Veículos:
- Escolha entre "Carro" ou "Moto".
- Clique em "+ Adicionar Veículo" para inserir o nome e a eficiência (km/L).
- Selecione um veículo da lista para usar sua eficiência automaticamente nos cálculos.
- Calcule uma Viagem:
- Preencha os campos "KM Inicial", "KM Final", "Eficiência" (pode ser preenchido automaticamente ao selecionar um veículo) e "Preço por Litro".
- Opcionalmente, adicione o "Ganho Bruto da Viagem".
- Clique em "Calcular Gastos". O resultado será exibido e a viagem guardada no histórico.
- Consulte Histórico e Estatísticas:
- As seções de histórico e estatísticas aparecerão abaixo dos cálculos para o tipo de veículo selecionado.
- Clique num item do histórico para ver detalhes.
- Use os botões "Ver Mais" / "Minimizar" para controlar a exibição do histórico.
- Backup e Restauração:
- Na seção "Backup e Restauração", você pode exportar todos os seus dados ou importar de um ficheiro de backup.
- Há também uma opção para limpar todos os dados da aplicação (use com cuidado!).
- Instalar como App (PWA):
- Em navegadores compatíveis (Chrome, Edge, Firefox em Android), procure pelo ícone de instalação na barra de endereço ou no menu para adicionar o FuelCalc à sua tela inicial e usá-lo como um aplicativo nativo.
FuelCalc/
├── icons/ # Ícones da aplicação para PWA e favicons
│ ├── icon-72x72.png
│ └── ... (outros tamanhos)
├── libs/ # Bibliotecas de terceiros
│ └── chart.min.js # Chart.js para gráficos
├── screenshots/ # Screenshots para o manifest PWA
│ ├── screenshot.png
│ └── screenshot1.png
├── app.js # Lógica principal da aplicação em JavaScript
├── index.html # Estrutura principal da página (HTML)
├── manifest.json # Web App Manifest para PWA
├── README.md # Este ficheiro
├── styles.css # Folha de estilos principal
├── sw.js # Service Worker para PWA (cache e offline)
└── translations.js # Strings de tradução para i18n
Contribuições são sempre bem-vindas! Se você tem sugestões, correções de bugs ou novas funcionalidades:
- Faça um Fork do projeto.
- Crie uma nova Branch para a sua funcionalidade (
git checkout -b feature/MinhaNovaFeature). - Faça Commit das suas alterações (
git commit -m 'Adiciona MinhaNovaFeature'). - Faça Push para a sua Branch (
git push origin feature/MinhaNovaFeature). - Abra um Pull Request no repositório original.
Por favor, tente seguir os padrões de código existentes e adicione comentários relevantes às suas alterações.
Este projeto está licenciado sob a Licença MIT. Veja o ficheiro LICENSE (se existir) para mais detalhes, ou consulte opensource.org/licenses/MIT.
Desenvolvido com ❤️ por João Augusto
✨ Sinta-se à vontade para usar, modificar e contribuir! ✨