Uma aplicação Fullstack que calcula a rota entre duas cidades e fornece a previsão do tempo exata para cada ponto do trajeto, considerando o deslocamento temporal (onde o carro estará daqui a X horas).
- Múltiplas Rotas & Seleção: O usuário agora pode escolher entre até 3 opções de trajeto (Principal e Alternativas) antes de carregar o clima.
- Resumo de Viagem Detalhado: Exibição clara do tempo total (formato amigável) e distância em quilômetros.
- Navegação GPS Externa: Botões dedicados para exportar a rota planejada para o Google Maps (mantendo paradas) ou Waze.
- Histórico Local de Viagens: Atalho "Viagens Recentes" que salva os últimos trajetos no navegador para preenchimento instantâneo.
- Cálculo de Rota: Estima tempo e distância real de direção.
- Tráfego com Múltiplas Paradas: Suporte a adicionar múltiplas paradas intermediárias na viagem.
- Previsão Espaço-Temporal: Cruza a posição do carro com a hora estimada de chegada para pegar a previsão do tempo correta (não a atual).
- Geocodificação Reversa: Identifica o nome das cidades ao longo da rodovia.
- Cache Inteligente: Utiliza SQLite para salvar rotas consultadas (TTL de 1 hora), economizando requisições externas e acelerando a resposta.
- Autocomplete: Frontend com busca de cidades integrada ao Mapbox/Nominatim.
- Modo Escuro (Dark Mode): Suporte nativo a temas claro e escuro, com persistência via
localStorage. - Interface Dinâmica & Badges: Timeline rica em detalhes com badges de status (📍 Partida, 🏁 Chegada, 📌 Parada) e ícones SVG responsivos.
- Segurança: Prevenção contra abusos usando Rate Limit nas rotas da API, validação rigorosa de input no servidor para evitar ataques de DoS e mitigação de vulnerabilidades XSS (Cross-Site Scripting) via DOM.
- Resiliência do Frontend: Tratamento robusto de erros HTTP em todas as chamadas
fetch, garantindo feedback claro ao usuário mesmo em falhas de servidor ou limites de rede. - Favicon Dinâmico: Emoji inline via SVG (🌦️) para evitar erros 404 e melhorar a identificação visual.
- Acessibilidade: Suporte a leitores de tela com
aria-labele associação semântica de labels e inputs, além de cores contrastantes garantindo legibilidade e conformidade com os padrões WCAG AA. - Segurança Avançada: Implementação de Subresource Integrity (SRI) em CDNs de terceiros (Leaflet) para garantir a integridade dos scripts carregados.
- SEO & Social Media: Meta tags otimizadas para Open Graph e Twitter Cards, incluindo correção de caminhos de imagem para melhor compatibilidade de preview.
- Performance: Configuração de cache de longo prazo (TTL eficiente de 1 ano) para ativos estáticos (CSS/JS), melhorando drasticamente a pontuação de velocidade no carregamento de navegadores recorrentes.
- Flexibilidade de Hospedagem: Correção de chamadas de API relativas, permitindo a implantação em subdiretórios perfeitamente integrada.
- Node Build Automático (ESBuild): Pipeline nativa acoplada para empacotar todo código Javascript do projeto (substituindo process.env do server no frontend), permitindo hospedagens JAMStack sem dores de cabeça.
Backend:
- Node.js & Express
- SQLite3 (Banco de dados local para Cache)
- Axios (Requisições HTTP)
- Helmet & CORS (Segurança de API e Cabeçalhos HTTP)
- Winston (Logging profissional estruturado)
- Arquitetura Modular (Dependency Injection):
CacheRepository: Isolamento de persistência SQLite.GeocodingService: Integração Mapbox/Nominatim.WeatherService: Previsão via Open-Meteo.RoutingProviderService: Orquestração de OSRM/GraphHopper/Mapbox.WeatherRouteOrchestrator: Orquestrador desacoplado e testável.
Frontend & Build Pipeline:
- HTML5, SCSS & JavaScript Puro (ES6 Modules: api.js, map.js, ui.js)
- ESBuild (Bundler e Minificador JS rápido com suporte a Watch Mode)
- Concurrently (Execução paralela de servidor e build em desenvolvimento)
- Sass (Pré-processador de CSS nativo)
- Sharp (Conversor e Esmagador de imagens node de altíssima velocidade)
- Playwright (Testes End-to-End automatizados para UI e fluxos de navegação) APIs Externas (Gratuitas/Open Source):
- 🗺️ Mapbox Geocoding: Geocodificação (Texto ↔ Coordenadas) (Principal).
- 🗺️ Nominatim (OSM): Geocodificação (Texto ↔ Coordenadas) (Fallback caso Mapbox falhe).
- 🛣️ OSRM / GraphHopper / Mapbox: Cálculo de rotas e geometria.
- 🌦️ Open-Meteo: Previsão do tempo meteorológica histórica e futura.
- Node.js instalado (v18 ou superior recomendado).
-
Clone o repositório:
git clone https://github.com/viniciusdocanto/weather-route-api.git cd weather-route-api -
Instale as dependências:
npm install
-
Configure as variáveis de ambiente: Crie um arquivo
.envna raiz do projeto (ou copie o.env-sample):cp .env-sample .env
Edite o arquivo
.enve adicione suas chaves:GRAPHHOPPER_KEY: Sua chave de API do GraphHopper.MAPBOX_TOKEN: Seu token de acesso do Mapbox.API_BASE_URL: (Opcional) URL base da API se for diferente do padrão/api.
-
Árvore de Desenvolvimento:
- Faça suas edições em
src/js/script.jsesrc/scss/style.scss. - Coloque as imagens novas em
src/img/.
- Faça suas edições em
-
Inicie o servidor localmente:
npm start
O comando iniciará automaticamente o processo do
esbuild,sassesharp, copiando todos os arquivos da pasta origem (/src) empacotados e minimizados para a pasta final (/assets), a qual oindex.htmlirá carregar. O app estará disponível emhttp://localhost:3000.
O projeto conta com uma pirâmide de testes completa, abrangendo testes unitários e de integração com o Node.js Native Test Runner, além de testes End-to-End (E2E) com o Playwright.
npm testOu individualmente:
node tests/test-core.js
node tests/orchestrator-di.test.js
node tests/api.test.jsOs testes cobrem:
- Validação de tradução de códigos WMO (Meteorologia).
- Integridade da estrutura de resposta da API de clima.
- Fluxo de negócio do Orquestrador usando Mocks (DI).
- Validação de entradas e endpoints da API HTTP (
/api/version,/api/route-options,/api/forecast,/api/search).
# Executa todos os testes E2E headless
npm run test:e2e
# Executa os testes E2E com interface gráfica interativa
npm run test:e2e:uiOs testes E2E cobrem:
- Renderização inicial da página, formulários e placeholders (
tests/e2e/home.spec.js). - Alternância e persistência do Modo Escuro via
localStorage(tests/e2e/dark-mode.spec.js). - Validações de entrada, toasts de erro, paradas dinâmicas e limites de datas (
tests/e2e/form-validation.spec.js). - Jornada completa do usuário: busca, seleção de trajeto alternativo, renderização de timeline de clima e links para Google Maps/Waze (
tests/e2e/trip-flow.spec.js).
npm run test:allEste projeto está sob a licença MIT. Consulte o arquivo LICENSE para mais detalhes.
Warning
Persistência de Dados (SQLite): Este projeto utiliza SQLite (weather_trip.db). Em plataformas como Render.com, o sistema de arquivos é efêmero. Se você precisar de persistência real entre deploys, considere utilizar um Persistent Disk ou migrar para um banco de dados gerenciado (Postgres/MySQL).