Metodologia

Prioridade das fontes

  1. APIs oficiais gratuitas.
  2. Arquivos oficiais CSV, JSON ou ZIP.
  3. Bases públicas oficiais para download.
  4. APIs públicas gratuitas não oficiais (BrasilAPI/OpenCNPJ) — apenas apoio pontual.
  5. Scraping ético — apenas quando não houver API ou arquivo oficial adequado, e desativado por padrão.

Score de risco cívico

Calculado apenas sobre dimensões oficiais efetivamente disponíveis: despesa, presença, concentração de fornecedor e alertas. Dado ausente nunca é tratado como zero. Score só é emitido com ≥ 2 dimensões; caso contrário exibimos “Score indisponível — dimensões oficiais insuficientes.”.

Alertas

Todo alerta carrega links das fontes oficiais usadas no cruzamento. Todo alerta exibe:

Este alerta não representa acusação de ilegalidade. É um indicador automatizado baseado em dados públicos oficiais e precisa de análise humana.

Janela eleitoral

Alerta de gasto atípico em janela eleitoral só é gerado quando as datas provêm de fonte oficial (TSE) ou de configuração versionada com referência pública explícita. Sem fonte oficial, o alerta não é gerado.

Cache e histórico

Esta v1 não mantém histórico persistido. Dados são consultados sob demanda nas fontes oficiais e mantidos em cache volátil para performance.