Arquitetura Local-First para Fiscalização Agrária
1 Apr 2025
2 min read
O Desafio Fundamental
O projeto REFUSA é uma iniciativa governamental para modernizar a fiscalização fundiária nacional. O sistema teria de funcionar em locais extremos como o interior do Sertão e da Amazônia, sob restrições críticas:
- Conectividade Inexistente: Resolução offline que pudesse operar sem redes de telefonia celular.
- Validade Jurídica Imutável: Prova fotográfica e registro imutável das infrações para evitar impunidade.
- Complexidade de Conflito de Dados: Se dois fiscais em campo avaliassem os mesmos lotes concomitantemente em dias diferentes, as alterações necessitariam harmonização à exaustão após a sincronização, sem intervenção humana corriqueira.
As Soluções Implementadas
Como Tech Lead Mobile no projeto, criei uma sólida arquitetura focada no conceito Local-First, visando resiliência e clareza no desenvolvimento do app:
- Padrão CQRS + Clean Architecture: Arquitetura descentralizada garantindo que as operações se baseiem num modelo command/query, simplificando depuração e evolução.
- Write Local Always: A interface do sistema e todos os salvamentos interagem primeiro e imediatamente com o DB local. O Sync para a API ocorre completamente secundário, em background, isolado do fluxo de interação do usuário.
- Hashs Imutáveis: Todas as imagens e evidências gravadas offline usam hashes SHA-256 no file system para atestar perante a justiça federal que arquivos não foram modificados, trazendo validade incontestável.
- Engine de Sync Customizada: Como não tínhamos tempo real para lock no servidor, desenvolvi uma mecânica complexa de resolução automática para gerenciar o merge de conflito de edições locais sobre o mesmo agrupamento no mapa.
O Impacto
Ao simplificar os protocolos burocráticos e digitalizar perfeitamente as diligências com a solidez de um sistema offline funcional, o app garantiu a eficácia da vistoria fundiária na União, escalando organicamente nacionalmente sem corromper auditorias e garantindo 100% de estabilidade legal nos relatórios.
Gostou do que leu?
Vamos conversar sobre como posso ajudar no seu projeto.