Metodologia
Do dado ao gráfico
- Coleta. O pipeline baixa os dados das fontes oficiais e guarda cada arquivo bruto com URL, data de coleta, licença, versão da fonte e hash sha256.
- Normalização. Tudo vira um formato comum: geografia, ano, indicador, valor, intervalo de confiança quando existe, fonte, versão, licença e marca de quebra de série (ADR 0002).
- Validação. Esquema, limites de cada indicador, anos faltantes e saltos atípicos. Saltos reais, como a hiperinflação e a pandemia, viram avisos para revisão, nunca correções.
- Publicação. O site é gerado só a partir dos arquivos versionados no repositório. O CI confere que regerar tudo a partir dos dados brutos reproduz exatamente os dados publicados.
Números rastreáveis
Nenhum número é digitado à mão nos textos. Eles vêm dos dados do repositório, de artigos revisados por pares (com DOI e o local no artigo) ou de uma justificativa escrita. Cada número no texto é um link para a tabela "de onde vem cada número". DOIs são conferidos na Crossref (ADR 0007).
Governos e causalidade
As faixas de governo nos gráficos e a tabela de variação por período são descritivas. Um ano é atribuído ao governo em exercício em 1º de julho. Efeitos de políticas aparecem com atraso, fatores externos pesam e o Congresso, os estados e o Banco Central também decidem. Por isso o Brasil aparece sempre ao lado de países vizinhos, e afirmações causais só aparecem em análises com desenho causal (ADR 0003). Para entender o que cada tipo de estudo mostra, veja como ler estudos.
Quebras de série e incerteza
Quando a metodologia de uma pesquisa muda, como na troca da PNAD pela PNAD Contínua, as séries não são emendadas: aparecem separadas, com a quebra marcada no gráfico. Intervalos de confiança aparecem como faixas claras quando a fonte publica a incerteza.
Neutralidade
Toda análise traz evidências a favor e contra a hipótese. Toda ficha de política traz algum resultado nulo, negativo ou misto, ou documenta onde procurou evidência contrária.
Licenças
Cada observação carrega a licença da fonte (ADR 0006). Todas as decisões metodológicas estão em docs/adr. O changelog dos dados está em data/CHANGELOG.md.