Pular para o conteúdo principal

Backend / API

O backend é uma aplicação FastAPI que expõe as consultas, orquestra a geração de relatórios de compliance e serve os endpoints de monitoramento. Ele é o ponto de integração entre o acervo geoespacial (PostGIS), o armazenamento de objetos (Cloudflare R2) e as interfaces web.

Responsabilidades​

  • Consulta de imóveis — busca por código CAR ou geometria e recuperação dos dados consolidados.
  • Orquestração de compliance — dispara as verificações, recebe os resultados e aplica a consolidação determinística (score 0–100, faixa, justificativa).
  • Serviço de índices agro — serve os índices instantâneos ao vivo a partir da meteorologia atual/prevista, devolvendo valor, faixa e recomendações.
  • Monitoramento — endpoints de locais monitorados e de status das fontes de desmatamento.
  • Relatórios — geração e recuperação dos PDFs de análise.

Serviços de índices agro​

O backend mantém um registro de índices que permite servir qualquer índice instantâneo pelo seu id, a partir de uma única observação meteorológica. Cada índice é uma função pura entradas → resultado, o que torna o cálculo testável e determinístico. Os índices de janela (agregados) e o IPC têm pipelines próprios.

Veja Índices agro.

Consolidação de compliance​

A lógica que transforma a lista de checks em score vive em uma camada de semântica de resultados em Python puro (sem dependências de banco ou orquestrador), composta por:

  • Classificação do resultado (conforme / alerta / pendência).
  • Avaliação de gravidade do achado concreto.
  • Consolidação da nota e da justificativa.
  • Taxonomia de exibição (nome, bloco temático, fonte).

Essa separação garante que a cor do chip, as contagens e a nota concordem entre si, e que o cálculo seja auditável. Veja Scoring de compliance.

Serviço de tiles​

Os mapas são alimentados por vector tiles (MVT) publicados diretamente do PostGIS por um servidor de tiles dedicado (pg_tileserv). Camadas de grande volume (focos de fogo, alertas) são servidas a partir de views de dados recentes para manter a navegação fluida.

observação

Detalhes de infraestrutura, autenticação interna, variáveis de ambiente e deploy não fazem parte desta documentação pública.