Projetos 07 / 11
Ateri
Gestão de visitas técnicas rurais, offline-first
Plataforma para técnicos que acompanham agroindústrias familiares em campo. Cadastro de produtores, visitas com histórico rastreável, fotos e documentos. Funciona sem sinal e sincroniza depois, resolvendo conflitos campo a campo.
Visão geral
O Ateri organiza o trabalho de técnicos de extensão rural que acompanham agroindústrias familiares no oeste do Paraná. Cada produtor tem sua ficha, cada visita tem histórico rastreável, e o painel mostra a cota do mês — uma visita por produtor —, o que está atrasado e o que vem nos próximos dias.
O app de campo é offline-first: grava tudo no aparelho, funciona sem sinal na propriedade e sincroniza quando a conexão volta, resolvendo conflitos campo a campo. A API em C# e .NET 10 é o contrato comum para o app em React Native e o painel web em React, e o projeto foi também uma forma de estudar a stack que o mercado pede.
Funcionalidades
O que o sistema faz
-
Painel da cota do mês
Quantos produtores já foram atendidos, visitas concluídas, atrasadas e da próxima semana, quem falta visitar e o andamento por bloco de rota.
-
Agenda de visitas
Visitas por dia com status pendente, concluída, remarcada, cancelada ou atrasada, filtro por bloco, cidade e "só as minhas".
-
Ficha do produtor
Dados, coordenadas, CAF com aviso de vencimento, equipe responsável, anotações fixadas e o histórico completo de visitas.
-
Blocos de rota
Cidades agrupadas em blocos para planejar as saídas de campo e acompanhar a cobertura de cada região.
-
Arquivos e lançamentos
Fotos, documentos e áudios por produtor, que sobem só em Wi-Fi, além de quilometragem e despesas das visitas.
-
Funciona sem servidor
Um modo local permite usar o app na rua antes de existir servidor, guardando a fila de operações para levar tudo à API depois, sem perder nada.
Telas
Por dentro do sistema
Telas com dados fictícios, gerados para demonstração.
Stack
Como foi construído
- Frontend
- ReactTypeScriptTanStack QueryTanStack TableZustandTailwind 4shadcn/ui
- Mobile
- React NativeExpoExpo RouterSQLiteNativeWind
- Backend
- C#.NET 10ASP.NET Core Minimal APIsEF Core 10DapperIdentity + JWTOpenAPI
- Dados
- PostgreSQL
- Infra & DevOps
- DockerxUnitTestcontainersVitestPlaywright
Bastidores
Desafios técnicos
-
Uma rota de sincronização
O aparelho envia a fila de operações e recebe, na mesma resposta, o que mudou no servidor desde o último cursor. Com sinal fraco, cada ida e volta a menos conta, e o app já recebe o estado mesclado do que acabou de enviar.
-
Operações idempotentes com ids do aparelho
Cada operação tem um GUID v7 gerado no celular e a hora em que foi feita. Reenviar a mesma fila não duplica nada, e entidades criadas offline já nascem com o id definitivo.
-
Não perder trabalho em conflito
A última escrita vence campo a campo, com histórico por registro. Se uma operação é recusada (um CPF repetido, por exemplo), as seguintes do mesmo produtor ficam adiadas em vez de descartadas, esperando a correção.
-
Um contrato para dois clientes
O documento OpenAPI gerado pela API é a fonte dos tipos do web e do app. Web e mobile têm interfaces próprias, mas falam exatamente a mesma língua com o servidor.
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