Pular para o conteúdo

Fontes e cadência

De onde vem cada dado e com que frequência o Brasil a Vera atualiza.

Princípio de rastreabilidade

Todo dado exibido carrega de onde veio e quando chegou. Cada registro guarda:

  • — URL da fonte oficial — link direto para o registro original na API que publicou o dado.
  • — Nome da fonte — ex: "Câmara dos Deputados API v2", "Senado Federal Dados Abertos".
  • — Timestamp da ingestão — momento em que o Brasil a Vera leu o dado pela última vez.

Esse metadado permite que qualquer cidadão verifique independentemente cada dado exibido — basta clicar no link.

Fontes oficiais em produção

Câmara dos Deputados

https://dadosabertos.camara.leg.br

O que ingere
Deputados em exercício, proposições, tramitação, votações nominais, orientação de bancada, gastos CEAP.
Cadência de atualização
  • Votações: 4× por dia
  • Deputados / comissões: diário
  • Proposições / tramitação: semanal
  • Gastos CEAP: semanal
Particularidades
  • — Votações em comissões com tramitação conclusiva podem não ter voto nominal em plenário registrado.
  • — CEAP demora dias a semanas entre a despesa real e a publicação na API.

Senado Federal

https://legis.senado.leg.br/dadosabertos

O que ingere
Senadores em exercício, proposições (matérias), votações nominais. Sem CEAP equivalente.
Cadência de atualização
  • Votações: 4× por dia
  • Senadores / matérias: diário
Particularidades
  • — A API não publica orientações de bancada — alinhamento partidário de senadores fica em empty state. Tracking em issue #83.
  • — Senado não tem cota de despesas equivalente à CEAP da Câmara.

Cobertura temporal

O Brasil a Vera cobre as legislaturas 56 e 57 (2019–2026). Legislaturas anteriores estão fora do escopo por agora — os dados existem nas fontes oficiais, mas a ingestão histórica seria custosa em tempo e armazenamento sem demanda empírica clara.

  • — Critério de inclusão e plano de arquivamento documentados em ADR-016.

Fontes planejadas (não em produção)

Fontes adicionais previstas no roadmap. Cada uma traz seu próprio conjunto de desafios (encoding, rate limits, vinculação entre IDs). A inclusão é gradual, conforme o produto consolida o uso das fontes atuais.

TSE — doações de campanha, candidaturas, resultados

Não ingerido ainda. Dados publicados em bulk CSV por eleição, encoding Latin-1, vinculação por CPF.

Previsão: Wave 3.3

Portal da Transparência (CGU) — emendas parlamentares, contratos

Não ingerido ainda. Requer API key gratuita e respeito a rate limits específicos.

Previsão: Wave 3+

IBGE — indicadores demográficos e socioeconômicos

Não ingerido ainda. Útil apenas para análises L3/L4 (correlação política × indicador social).

Previsão: Wave 3.4+

Tempo entre o fato e a plataforma

Entre o momento em que um parlamentar vota uma matéria e o momento em que esse voto aparece no Brasil a Vera, há duas latências em série:

  • — Latência da fonte oficial: a Câmara publica votações no mesmo dia, frequentemente em minutos. CEAP demora dias a semanas. TSE publica bulk só pós-eleição.
  • — Latência do cron de ingestão: o Brasil a Vera lê a fonte oficial em janelas pré-definidas (ver cadência acima). No pior caso de votações, são até 6 horas entre o registro na fonte e a aparição no site.

O timestamp da última ingestão fica visível na plataforma — basta consultar o badge L1 em qualquer registro.

Tratamento de falhas

APIs públicas brasileiras são frequentemente instáveis. O princípio operacional é simples: dados antigos são melhores que dados ausentes. Se um cron de ingestão falha, o sistema continua servindo o último snapshot bem-sucedido, com o timestamp visível, em vez de quebrar a tela.

Todas as falhas de ingestão geram log estruturado e notificação para o mantenedor. Detalhes técnicos: