Monitora Brasil

Painel que acompanha o desenvolvimento do Brasil em comparação com outros países. Ele cruza 40 indicadores econômicos, sociais, institucionais e ambientais, de 1995 a 2025, e os resume em escores de 0 a 100 para cinco macrotemas.

É um trabalho voluntário e aberto ao público. O objetivo é ajudar qualquer pessoa a entender, com dados oficiais e método transparente, como o Brasil está se saindo: em que avança, em que fica para trás e como se compara a outros países. Código, dados e cálculos estão todos neste repositório, para que qualquer um possa conferir, reproduzir e melhorar.

• Site: pasta site/, um site estático pronto para hospedar em domínio próprio (ver docs/10)
• Base conceitual: Dossiê de Indicadores de Desenvolvimento (21 categorias, 5 macrotemas): https://claude.ai/artifact/1nwmHfoeYXmQ5RZhytXXVM
• Repositório: https://github.com/ChrisBerenguer/Monitora-Brasil
• Natureza: projeto voluntário, aberto e sem fins comerciais, mantido por Chris Berenguer
• Histórico de versões: CHANGELOG.md

O que o painel responde

1. Como o Brasil está em cada dimensão do desenvolvimento e no conjunto, em relação ao resto do mundo?
2. Como isso mudou no tempo, ano a ano e entre mandatos presidenciais?
3. Como o Brasil se compara aos seus pares: América Latina, BRICS, OCDE e países de renda média-alta?
4. Quanto as estatais federais lucram ou perdem, ano a ano e por mandato (aba Estatais)?
5. Quanto cresce cada segmento da economia, da agropecuária aos serviços, ano a ano e por mandato (aba Indústria)?
6. O que a Câmara votou e como votou cada deputado, desde 2019 (aba Leis e votação)?

Resultado de referência (dados de outubro de 2026)

Macrotema	Escore do Brasil em 2000	Escore do Brasil em 2025
Estabilidade macroeconômica	43,5	43,3
Estrutura produtiva e inovação	52,2	55,7
Coesão social e distribuição	35,4	32,9
Estado, instituições e segurança	50,8	39,6
Bem-estar e sustentabilidade	60,0	63,4
Geral	48,4	47,0

Em 2025 o Brasil fica na 100ª posição entre 176 países no escore geral. Em 2010 estava na 68ª posição entre 175. O escore é relativo: 50 significa estar no meio da distribuição mundial (ver docs/03-metodologia.md).

Estrutura do repositório

Monitora-Brasil/
├── README.md                  este arquivo
├── docs/                      documentação detalhada (leia em ordem)
│   ├── 01-visao-geral.md
│   ├── 02-conceitos-e-teorias.md
│   ├── 03-metodologia.md
│   ├── 04-dicionario-de-indicadores.md
│   ├── 05-nomenclatura-e-glossario.md
│   ├── 06-dados-fontes-e-esquemas.md
│   ├── 07-site.md
│   ├── 08-limitacoes-e-roadmap.md
│   ├── 09-como-atualizar.md
│   └── 10-publicacao.md
├── scripts/
│   ├── baixar_brutos.py       baixa as séries brutas para brutos/ (fora do git)
│   ├── build_dados.py         calcula percentis, escores e estatísticas → dados/
│   ├── coletar_industria.py   crescimento por segmento da economia (IBGE/SIDRA) → industria.json
│   ├── coletar_votacoes.py    votações nominais da Câmara e voto de cada deputado → votacoes.json, votos/
│   ├── explicacoes.py         textos para leigos de cada indicador (botão "i" do site)
│   ├── fontes.py              códigos oficiais e links (página e API) de cada indicador
│   └── gerar_dicionario.py    gera docs/04 a partir dos dados
├── dados/                     conjuntos de dados em JSON (cópia em site/data/)
├── site/                      o painel web: HTML, CSS, JavaScript, d3 local e dados
├── .github/workflows/pages.yml publicação automática no GitHub Pages
├── netlify.toml               configuração para Netlify
└── vercel.json                configuração para Vercel (publica a pasta site/)

Começo rápido

Precisa de Python 3.9 ou mais recente, sem bibliotecas externas.

git clone https://github.com/ChrisBerenguer/Monitora-Brasil.git
cd Monitora-Brasil
python scripts/baixar_brutos.py     # 42 arquivos CSV, cerca de 13 MB
python scripts/build_dados.py       # gera dados/*.json
python scripts/gerar_dicionario.py  # atualiza docs/04

Para ver o painel localmente:

cd site && python -m http.server 8000   # abra http://localhost:8000

Para publicar num domínio próprio, veja docs/10-publicacao.md.

Guia de leitura

Se você quer...	Leia
Entender o propósito e o escopo	01 · Visão geral
Entender a teoria por trás de cada indicador e da estatística usada	02 · Conceitos e teorias
Saber exatamente como cada número é calculado	03 · Metodologia
Consultar a definição de um indicador	04 · Dicionário de indicadores
Entender códigos, siglas e nomes de campos	05 · Nomenclatura e glossário
Ver as fontes, licenças e o formato dos arquivos	06 · Dados, fontes e esquemas
Usar ou modificar o site	07 · Site
Saber o que falta e o que vem depois	08 · Limitações e roadmap
Atualizar os dados	09 · Como atualizar
Publicar em domínio próprio	10 · Publicação

Como contribuir

O projeto é aberto a contribuições de qualquer pessoa: correções, sugestões de indicadores, melhorias na metodologia, no site ou na documentação.

• Achou um erro ou tem uma sugestão? Abra uma issue em https://github.com/ChrisBerenguer/Monitora-Brasil/issues explicando o que viu e, se possível, a fonte.
• Quer mudar código ou dados? Faça um fork, crie um branch, rode o pipeline (scripts/build_dados.py) e abra um pull request. Mudanças de método devem vir acompanhadas da atualização de docs/03-metodologia.md.
• Discordou de uma escolha metodológica? Ótimo, é para isso que ela está documentada. As decisões que mais mudam o resultado estão na seção "Robustez" do doc 03 e em docs/08.

Fontes e licença dos dados

Os dados vêm do World Development Indicators e dos Worldwide Governance Indicators do Banco Mundial, e do Índice de Desenvolvimento Humano do PNUD. Todos são distribuídos sob a licença CC BY 4.0 pelo espelho mantido pela Gapminder/open-numbers. Quem reutilizar os dados precisa citar as fontes originais. Detalhes em docs/06.