# VintEuros ⛽📈
> Combustíveis mais baratos em Portugal 🇵🇹, Espanha 🇪🇸 e França 🇫🇷. Comparação em tempo real de mais de 24.000 postos de combustível, tendências históricas de 90 dias e calculadora de desvio de viagem.

## Visão Geral (Overview)
O VintEuros (https://www.vinteuros.com) é uma plataforma web moderna, rápida e gratuita para pesquisar, comparar e analisar preços de combustíveis na Europa do Sul. O sistema integra dados oficiais atualizados diariamente de três governos europeus:
- **Portugal**: DGEG (Direção-Geral de Energia e Geologia) e ENSE (Entidade Nacional para o Setor Energético).
- **Espanha**: Minetur (Ministerio para la Transición Ecológica y el Reto Demográfico).
- **França**: Ministère de l'Économie (Prix des carburants en France - Flux instantané v2).

## Principais Funcionalidades (Key Features)

### 1. Pesquisa & Comparação de Postos (+24.000 Postos)
- Base de dados com mais de 24.000 postos de abastecimento em Portugal (~3.175), Espanha (~11.318) e França (~9.635).
- Combustíveis suportados: Gasóleo Simples (Gazole), Gasolina 95 Simples (SP95 / E10), Gasolina 98 Simples (SP98), GPL Auto (GPLc) e Superetanol E85.
- Filtros por país (Todos, Portugal, Espanha, França), raio de proximidade (1km a 100km), marcas, favoritos e endereço de partida.
- Ordenação por menor preço, menor distância ou melhor relação poupança/desvio.

### 2. Tendências Históricas & Comparação Internacional (Price Trends)
- Histórico contínuo de 90 dias com dados oficiais para Gasóleo Simples, Gasolina 95 e GPL Auto.
- Cálculo em tempo real das médias nacionais do próprio dia para todos os países, eliminando o atraso de publicação dos boletins estatísticos.
- Comparação lado a lado em gráfico unificado: Portugal (PVP), Espanha (PVP) e França (PVP).
- Indicador específico para Portugal: Preço de Referência ENSE para antecipar as variações de preço à segunda-feira.

### 3. Calculadora de Viagem & Desvio (Trip Detour Calculator)
- Calcula com precisão se compensa fazer um desvio de rota para abastecer num posto mais barato.
- Considera o consumo médio do veículo (L/100km), capacidade do depósito e litros a abastecer.
- Autocomplete e geocodificação de cidades e moradas em Portugal, Espanha e França via Google Places e Nominatim.
- Traçado de rota visual e cálculo de distâncias reais via Google Maps Directions API e OSRM.

### 4. Personalização & Sincronização
- Autenticação segura via Google One Tap, Google OAuth e Email/Palavra-passe.
- Sincronização de postos favoritos, combustível preferido, consumo do veículo e locais de Casa/Trabalho através do Firebase Firestore.

## Endpoints e Rotas (Key Routes)
- Página Principal (Pesquisa e Lista de Postos): https://www.vinteuros.com/
- Tendências de Preços: https://www.vinteuros.com/trends
- Calculadora de Viagem: https://www.vinteuros.com/calculator
- Política de Privacidade: https://www.vinteuros.com/privacy
- Termos de Utilização: https://www.vinteuros.com/terms

## Arquitetura Técnica (Technology Stack)
- Frontend: React 19, TypeScript, Vite 6, Tailwind CSS 4, Motion/React, Recharts, Leaflet.
- Backend: Node.js 24, Express, Firebase Cloud Functions (2nd Gen, europe-southwest1).
- Caching: In-memory SWR (Stale-While-Revalidate) com persistência em Firestore e JSON local.
- Segurança: Helmet, Rate Limiting, CSP estrito.

## Informação de Contacto e Domínios
- Domínio Principal: https://www.vinteuros.com
- Domínio Alternativo / Firebase Hosting: https://maisgasolinamelhor.web.app