FieldCopilot: Motor de Otimização e Roteamento Logístico de Pesquisas de Campo

[!NOTE] Sanitized Technical Specification (proprietary_sanitized): This technical sheet is an authorized public specification adhering to strict intellectual property compliance and Brazilian LGPD (Lei Geral de Proteção de Dados) compliance. Proprietary source code, production database instances, raw databases, confidential credentials, and client Personally Identifiable Information (PII) remain strictly protected and are not exposed.

Especificação Técnica Sanitizada (proprietary_sanitized): Ficha técnica pública autorizada em estrita conformidade com a Lei Geral de Proteção de Dados (LGPD) e diretrizes de propriedade intelectual. Código-fonte, instâncias de produção, credenciais confidenciais e dados pessoais identificáveis (PII) protegidos.

Ficha técnica pública autorizada sob diretriz proprietary_sanitized. Código-fonte, bancos de dados transacionais e telemetria de campo protegidos sob estrito sigilo institucional.

Contexto / Organização: Instituto de Pesquisa de Opinião e Inteligência de Mercado
Período: 2025 - 2026
Categoria de Atuação: Data Science
Tecnologias: FastAPI, Python, React 18, TypeScript, Leaflet, GeoParquet, Uber H3, PostgreSQL, Docker, OR-Tools

Visão Geral Executiva

Motor logístico e plataforma analítica espacial desenvolvida para automação do planejamento amostral, roteamento de equipes e controle de cotas de pesquisas de campo. Integra partição territorial restrita (Spatially Constrained Regionalization n >= m), roteamento geodésico TSP 2-Opt, ingestão de setores censitários via GeoParquet/H3 e auditoria de produtividade em tempo real.

Arquitetura & Fluxo de Dados

O diagrama abaixo ilustra a topologia e esteira de processamento dos componentes técnicos sanitizados:

flowchart TD
  A[Dados Censitários IBGE / Malhas Vetoriais] --> B[Regionalização Espacial Restrita n >= m / H3]
  B --> C[Otimizador de Roteamento TSP 2-Opt]
  C --> D[PostgreSQL / PostGIS / SQLAlchemy]
  D --> E[Backend FastAPI / REST API]
  E --> F[Frontend React 18 / TypeScript / Leaflet]
  E --> G[Motor de Auditoria & Telemetria em Tempo Real]
  G --> H[Exportação de Rotas & Painel de Supervisão de Campo]

Destaques de Engenharia

• Regionalização Espacial Restrita: Agrupamento territorial de setores censitários com piso amostral mínimo (n >= m) e células hexagonais H3 (resolução 8) para eliminar paradas operacionais inviáveis.
• Roteamento Geodésico Otimizado: Heurística TSP 2-Opt com matrizes de distâncias geodésicas e restrições de turno operacional (8h/dia, tempos de aproximação e deslocamento entre pontos).
• Mitigação de Moral Hazard: Arquitetura desacoplada de auditoria com telemetria em tempo real, validação de velocidade média e controle de desvio de cotas.