Gasosa App (MVP)

Bem-vindo ao Gasosa App! Este projeto tem como objetivo oferecer uma solução simples e eficiente para motoristas acompanharem abastecimentos, consumo médio e histórico dos seus veículos. O app é construído em Flutter, utilizando Firebase para autenticação, Drift para persistência local offline-first, e segue padrões modernos de arquitetura.

📚 Documentação Completa

O projeto possui documentação técnica completa organizada por domínio:

• 📖 Documentação Principal: Visão geral da arquitetura e padrões
• 🚀 Guia de Início Rápido: Setup e primeiros passos
• 📝 ADR - Decisões Arquiteturais: Registro de decisões técnicas

Domínios

• 🔐 Auth (Autenticação): Login, registro e sessão
• 🚗 Vehicle (Veículos): CRUD de veículos
• ⛽ Refuel (Abastecimentos): Registro e cálculo de consumo
• 🛠️ Core (Infraestrutura): Utilitários compartilhados

Visão Geral

• Propósito: Permitir o registro fácil de abastecimentos, cálculo de consumo médio, e visualização de histórico técnico para manutenção e controle de gastos.
• Público-alvo: Motoristas que buscam um histórico confiável do uso dos seus veículos, tanto para controle pessoal quanto para acompanhamento de manutenção.
• Arquitetura: Clean Architecture + Command Pattern, com foco em escalabilidade, manutenibilidade e testes.

Principais Funcionalidades

• Autenticação Firebase: cadastro/login por e-mail/senha e Google.
• CRUD de veículos: com foto opcional, dados principais, exclusão em cascata.
• CRUD de abastecimentos: registro completo (data, tipo de combustível, litros, valores, partida a frio, comprovante opcional).
• Cálculo de consumo médio: baseado no histórico de abastecimentos.
• Persistência local: Drift (SQLite-like), mantendo dados offline e prontos para sincronização futura.