Fatos Narrados
Portal independente de transparência pública, economia e fiscalização governamental.
Não exigir que o cidadão acredite em uma narrativa. Permitir que ele verifique os fatos.
Todos os números vêm exclusivamente de fontes oficiais e primárias (IBGE, Banco Central, Tesouro Nacional, PNCP, Câmara dos Deputados). Cada número exibido tem um link para a consulta original, e a página de cada indicador tem um botão que consulta a API oficial na hora e compara com o valor mostrado.
O que já funciona
| Página | O que faz | Fonte |
|---|
index.html | Desmontando Boatos: busca para conferir uma afirmação com os dados oficiais | Todas as integradas |
resultado.html#q=… | Resultado da verificação: classificação, o que foi confirmado ou desmentido, documentos consultados, cronologia e limitações | Todas as integradas |
painel.html | Painel com 11 indicadores-chave, busca e temas | IBGE, BCB |
emendas.html | Emendas parlamentares desde 2014: painel de totais, filtros combinados, mapa por estado, comparação, tipos e qualidade dos dados, exportação em CSV | CGU |
emenda.html?id=… | Uma emenda: quem fez cada etapa, destino, linha do tempo, favorecidos, convênios, documentos e situação de acesso. Para emendas "Pix", consulta ao vivo | CGU, Transferegov.br |
indicador.html | Explorador de 29 séries: período, mandatos no gráfico, comparação (mesma unidade), estatísticas, tabela, CSV/JSON e verificação ao vivo na fonte | IBGE, BCB |
governos.html | 16 métricas por mandato (FHC 1 → Lula 3) com o mesmo método para todos; clique em um valor para ver o cálculo | IBGE, BCB |
tema.html?t=… | Pequenos múltiplos por tema; ranking de preços e calculadora da inflação | IBGE, BCB |
gastos.html | Despesa da União nas 28 funções de governo, 2015 em diante, nominal ou corrigida pelo IPCA | Tesouro (SICONFI) |
fiscalizacao.html | Consulta ao vivo de licitações/contratações e da cota parlamentar de cada deputado | PNCP, Câmara |
fontes.html | Catálogo de 24 fontes oficiais verificadas, com status, formato e limitações | — |
metodologia.html | Princípios editoriais, regras de atribuição a governos, tratamento das séries | — |
Indicadores integrados
- Inflação e custo de vida: IPCA (12 meses e mensal); subitens do IPCA — alimentação no domicílio, arroz, carnes, café, gasolina, diesel, etanol, gás de botijão, energia elétrica, aluguel, plano de saúde, ônibus urbano.
- Emprego e renda: taxa de desocupação e rendimento médio real (PNAD Contínua).
- Atividade: PIB (4 trimestres e anual), IBC-Br.
- Contas públicas: dívida bruta e líquida, resultado primário e nominal, juros nominais; despesas da União por função.
- Juros e câmbio: meta Selic, dólar.
- Comércio exterior: exportações, importações e saldo da balança.
Os códigos de cada série (SGS do Banco Central, tabelas/variáveis do SIDRA) foram conferidos nos metadados oficiais e estão em js/data/catalog.js.
Como rodar
Requer Node.js 18 ou superior. Não há dependências para instalar.
npm start # servidor local em http://localhost:8080
npm run update # baixa todos os dados das APIs oficiais (~5 min; Selic e dólar são lentos)
npm run update:emendas # baixa e processa o arquivo de emendas da CGU (~2 min, usa ~2 GB de memória)
npm test # testes das transformações e das regras de atribuição
Para atualizar só alguns indicadores: node scripts/update-data.mjs ipca-12m desocupacao.
O site é estático (HTML, CSS e JavaScript em módulos ES) e pode ser publicado como está em GitHub Pages, Netlify, Vercel ou qualquer servidor de arquivos. Ele precisa ser servido por HTTP (não abre por file://, por causa dos módulos).
Arquitetura
index.html, indicador.html, governos.html, … páginas (HTML semântico, conteúdo básico sem JS)
css/styles.css tema claro/escuro, responsivo, sem framework
js/
data/catalog.js catálogo de indicadores: FONTE ÚNICA da verdade (site + script de atualização)
data/governments.js mandatos e regras de atribuição de períodos
data/metrics.js métricas por mandato (um único código para todos os governos)
data/transforms.js funções puras: acumulado 12m, diário→mensal, índices, CSV
data/sources.js catálogo de fontes oficiais verificadas
api/official.js conectores BCB, SIDRA e SICONFI (funcionam no navegador e no Node)
components/ gráfico SVG próprio, cartões, layout
pages/ um módulo por página
data/
series/*.json dados baixados (com data/hora e URL da consulta)
manifest.json situação de cada série na última atualização
scripts/
update-data.mjs atualização a partir das APIs oficiais
serve.mjs servidor local sem dependências
tests/ node:test
.github/workflows/ atualização diária automática, com cada mudança versionada no Git
Decisões principais:
- Dados versionados no Git. A atualização diária grava os JSON e faz commit. O histórico do repositório mostra quando cada número mudou, inclusive revisões dos próprios órgãos.
- Emendas fora do Git. O arquivo de emendas processado tem cerca de 60 MB e não é versionado (
data/emendas/ está no .gitignore). Ele é gerado por scripts/update-emendas.mjs a cada publicação. Para rodar a aba de emendas localmente, execute npm run update:emendas uma vez.
- Verificador por regras. O Desmontando Boatos (
js/verify/engine.js) não usa inteligência artificial: reconhece assunto, números, datas, governos e comparações e confere com as séries integradas. Sem dado oficial, o resultado é "não comprovado", nunca "falso".
- Nada é inventado. Se uma API falha, o arquivo anterior é mantido e a falha fica registrada no manifesto e na página inicial.
- Neutralidade visual. Nenhuma cor partidária; mandatos em faixas cinza alternadas; nenhum número pintado de "bom" ou "ruim".
- Um eixo por gráfico. Só é possível comparar indicadores da mesma unidade.
- Sem dependências de front-end: o gráfico é SVG próprio, acessível por teclado (setas, Home/End) e com tabela de dados.
Como evoluir
Veja docs/ROADMAP.md: próximas fontes (ANP, Comex Stat, Portal da Transparência, Novo Caged, DataJud), indicadores estaduais e municipais, banco de dados e API própria.
Licença
Código sob licença MIT. Os dados pertencem aos órgãos públicos que os produzem e seguem as condições de uso de cada um.
