Entender Política
pt-BR · English
Dados abertos e evidência científica para entender mudanças políticas e de políticas
públicas no Brasil, de 1980 até hoje, com comparações internacionais.
Acessar o site
https://amadeu01.github.io/entender-politica/ (em inglês:
https://amadeu01.github.io/entender-politica/en/)
O site é publicado pelo GitHub Pages a cada merge na main (workflow Deploy site).
Cada gráfico tem link para baixar os dados em CSV.
Todo argumento do site segue a mesma estrutura:
Afirmação → Métrica → Dados → Fonte científica (DOI) → Limitações
Princípios
- Rastreabilidade: todo número citado vem de um dado do repositório, com fonte,
data de coleta, licença e versão. Números digitados à mão são rejeitados pelo CI.
- Correlação não é causalidade: linhas do tempo por governo são descritivas.
Ver ADR 0003.
- Incerteza visível: intervalos, margens de erro e quebras metodológicas nas séries.
- Neutralidade: evidências favoráveis e contrárias; políticas que funcionaram e que
não funcionaram.
- Reprodutibilidade: qualquer pessoa regenera cada gráfico a partir do código.
- Bilíngue: todo conteúdo existe em pt-BR e inglês.
Estrutura
| Pasta | Conteúdo |
|---|
pipeline/ | "Compilador" em Python: coleta, normaliza, valida e gera artefatos (+ testes) |
data/raw/ | Dados brutos, com manifesto (URL, sha256, data, licença) |
data/processed/ | Observações normalizadas |
data/reference/ | Tabelas de referência (períodos de governo, marcos) |
indicators/ | Catálogo de indicadores: definição, fórmula, fonte, críticas |
analyses/ | Análises (pergunta, hipótese, método, resultado, limitações) |
education/ | Módulo de educação: subtemas e normas com votações e alterações (ADR 0012) |
policies/ | Fichas de políticas públicas de referência, com nível de evidência |
site/ | Site estático (Astro) publicado no GitHub Pages |
docs/ | Metodologia e decisões (ADRs) |
Rodar localmente
uv sync
uv run pytest
uv run ruff check . && uv run ruff format --check .
uv run compilador build # dados brutos -> dados processados e arquivos do site (offline)
uv run compilador fetch # baixa novos snapshots das fontes (rede)
uv run compilador fetch-votes # baixa votações em plenário (Câmara e Senado) das normas de educação (rede, lento)
uv run compilador verify-dois # confere DOIs novos na Crossref (rede)
cd site && npm ci && npm run dev # site em http://localhost:4321/entender-politica/
Para ver o site localmente, rode o último comando acima e abra o endereço indicado.
Publicação e automação: ADR 0008.
Contribuir
Ver CONTRIBUTING.md.
Licença
Código: MIT. Conteúdo: CC BY 4.0. Dados: licença de cada
fonte original. Como citar: CITATION.cff.
English
Open data and peer-reviewed evidence to understand political and public policy change in
Brazil from 1980 to the present, with international comparisons.
Site: https://amadeu01.github.io/entender-politica/en/ (Portuguese:
https://amadeu01.github.io/entender-politica/). Published by GitHub Pages on every merge
to main; every chart links to its data as CSV.
Every argument on the site follows the same structure:
Claim → Metric → Data → Scientific source (DOI) → Limitations
Principles: every cited number is traceable to repository data (hand-typed numbers fail
CI); timelines by government are descriptive, not causal
(ADR 0003); uncertainty and series breaks are
shown; evidence for and against is presented; everything is reproducible from code; all
content exists in Portuguese and English.
Run locally with uv sync && uv run pytest && uv run compilador build, then
cd site && npm ci && npm run dev. See CONTRIBUTING.md.
License: code MIT, content CC BY 4.0, data under each
source's license.
