Pular para o conteúdo

Pirâmide de Confiança

Como o Brasil a Vera classifica cada dado que exibe.

O princípio

Todo dado exibido no Brasil a Vera carrega um nível de confiança explícito. A regra é simples: fatos brutos aparecem separados de análises derivadas, e nenhum número aparece sem que o cidadão saiba de onde veio.

Quatro níveis (L1, L2, L3, L4) cobrem desde o dado oficial sem transformação até estimativas modeladas. Cada um tem um badge próprio na interface, com cor distinta. Passe o mouse ou o foco sobre qualquer badge no site para ver uma explicação rápida do nível.

Os quatro níveis

  • O que é
    Dado bruto vindo direto de uma fonte oficial (API da Câmara, API do Senado). Sem transformação interpretativa — apenas normalização de formato (encoding, datas).
    Exemplo
    "Deputado X votou SIM na votação Y em 12/05/2026" — registro literal da API da Câmara.
    Como ler
    Verificável independentemente: cada registro carrega um link para a fonte oficial. Se a plataforma mostra L1, o cidadão pode clicar e conferir na API original.
  • O que é
    Agregação determinística de dados L1 com fórmula pública. Mesmos inputs sempre geram o mesmo output. A fórmula vive no repositório open source.
    Exemplo
    "Deputado X votou 73% alinhado com a bancada do partido em 2026" — contagem direta de coincidências de voto vs. orientação partidária.
    Como ler
    Reprodutível: qualquer pessoa com acesso aos dados L1 e à fórmula deve chegar ao mesmo número. Se a fórmula muda, o histórico é recalculado.
  • O que é
    Cálculo derivado com fórmula aberta mas que envolve julgamento interpretativo (escolha de threshold, janela temporal, agrupamento por similaridade).
    Exemplo
    "Top 5 deputados com afinidade de voto com X" — coincidência de voto sobre janela de 12 meses, com quórum mínimo de 20 votações comparáveis.
    Como ler
    Auditável mas não neutro: a escolha dos parâmetros (12 meses, 20 votações) é decisão editorial documentada. Outra parametrização daria outro resultado.
  • O que é
    Estimativa baseada em modelo ou heurística. Reservado para análises futuras (Wave 3.4+) — ainda não em produção.
    Exemplo
    "Estimativa de alinhamento ideológico de X com pauta governista" — modelo treinado sobre histórico de votos com viés explícito.
    Como ler
    Quando estiver disponível, virá sob sub-marca "Brasil a Vera Labs" com identidade visual distinta. Nenhum dado L4 aparece hoje na plataforma.

Por que essa separação importa

Plataformas de transparência costumam misturar fato e interpretação na mesma tela. Isso facilita a comunicação, mas confunde quem precisa decidir em quê confiar. Quando "votou SIM" e "tem 73% de alinhamento" aparecem com o mesmo peso visual, o cidadão deixa de distinguir o que é dado oficial do que é cálculo do site.

A pirâmide é a estrutura que evita essa confusão. L1 é o que a Câmara publicou. L2 é o que o Brasil a Vera calculou com fórmula aberta. L3 envolve escolhas editoriais (que ficam documentadas). L4, quando existir, virá em sub-marca separada.

O contrato de confiança também é estrutural: nenhum cálculo L2/L3 pode ser feito sem ter dados L1 como base, e nenhum cálculo mais alto pode "contaminar" um mais baixo. Se todo código de L3 for removido amanhã, os dados L1 e L2 continuam funcionando intactos.

Onde isso aparece na interface

  • Badge em cada métrica: ao lado de cada número ou seção, o nível de confiança correspondente. Foque (Tab) ou passe o mouse para abrir o tooltip com descrição.
  • Página inicial: a seção "Pirâmide de Confiança" traz um exemplo concreto de cada nível.
  • Exports CSV: cada linha do CSV inclui a coluna trust_level — dado retirado do contexto da plataforma mantém a classificação.

Documentação técnica completa

Este texto é a versão cívica. Para quem quer entender a implementação arquitetural (tabelas no banco, regras por camada, isolamento estrutural), o documento canônico no repositório: