Projetos 08 / 11
Garajá
Manutenção de veículos para a casa ou a frota
Centraliza manutenções, abastecimentos, documentos e custos por veículo. Pensado para o registro acontecer no posto ou na oficina: funciona offline, aceita lançamento retroativo e sincroniza quando a conexão volta.
Visão geral
O Garajá reúne tudo o que um carro custa: abastecimentos, manutenções, despesas, documentos e quilometragem, por veículo, para uma casa ou uma frota pequena. O painel responde duas perguntas logo de cara — o que vence em breve e quanto cada veículo custa por quilômetro.
O registro acontece no posto ou na oficina, muitas vezes sem sinal, então o app é offline-first: grava no aparelho, aceita lançamento retroativo e sincroniza quando a conexão volta. A API em .NET 10 é o contrato comum do app em React Native e do painel web em React, com anexos guardados no Cloudflare R2.
Funcionalidades
O que o sistema faz
-
Painel do que vence e do que custa
Gasto dos últimos 12 meses, custo por quilômetro, quilômetros rodados, alertas de manutenção e documentos e gasto por mês e por veículo.
-
Abastecimentos e consumo
Litros, preço, combustível, posto e tanque cheio. O consumo em km/l é calculado entre abastecimentos e o custo por km sai de tudo que o veículo gastou.
-
Plano de manutenção
Regras por quilometragem e por tempo (óleo, filtros, alinhamento, correia, bateria) com última e próxima execução e aviso antes de vencer.
-
Manutenções, despesas e documentos
Peças e mão de obra por oficina, pedágio, lavagem, IPVA, licenciamento, multas, CRLV e seguro com alerta de vencimento.
-
Anexos e anotações
Fotos e PDFs organizados em pastas, visualizador em tela cheia no app e anotações fixadas por veículo.
-
Frota compartilhada
Convite para outros membros, papéis de dono e membro, e o mesmo histórico para toda a casa ou empresa.
Telas
Por dentro do sistema
Telas com dados fictícios, gerados para demonstração.
Stack
Como foi construído
- Mobile
- React NativeExpo SDK 58Expo Routerexpo-sqliteNativeWindTanStack QueryZustand
- Frontend
- ReactTypeScriptTailwind
- Backend
- C#.NET 10ASP.NET Core Minimal APIsEF Core 10JWTOpenAPI + Scalar
- Dados
- PostgreSQL 18Cloudflare R2
- Infra & DevOps
- DockerCaddyxUnit v3Testcontainers
Bastidores
Desafios técnicos
-
Offline-first com lançamento retroativo
Cada registro nasce no aparelho com um GUID v7 e entra numa fila de sincronização. Como dá para lançar um abastecimento de ontem depois do de hoje, a API valida a cronologia do hodômetro em relação aos registros vizinhos.
-
Isolamento por frota em tudo
Toda tabela carrega a frota, filtros globais do EF Core restringem cada consulta e uma guarda no SaveChanges impede gravar fora do escopo. As rotas são fechadas por padrão.
-
Upload que funciona de verdade no Expo
O fetch do Expo recusava arquivos no FormData e nenhum anexo chegava ao servidor. O upload passou para XMLHttpRequest, com o nome do arquivo decodificado na API e envio só em Wi-Fi quando o usuário prefere.
-
Custo que não conta duas vezes
Documento e despesa não podem registrar o mesmo pagamento, senão o custo por quilômetro dobra. A modelagem separa o que é prazo (documento) do que é dinheiro (despesa).
Precisa de algo
nessa linha?
Conte a ideia ou o problema. Eu ajudo a desenhar a solução e construo do back ao app.
Vamos conversar