Igor Julliano.dev.br

Arquitetura Local-First para Fiscalização Agrária

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.