# Metodologia

Versão 0.1, 5 de outubro de 2026. As decisões que este documento resume, com o porquê e as alternativas descartadas, estão em [decisoes.md](decisoes.md).

## 1. Propósito e limites

O projeto reúne dados públicos e documentos oficiais sobre os governos Lula e Bolsonaro e os apresenta num site, para que o leitor tire as próprias conclusões sem depender de narrativas.

"Sem viés" por completo não existe. O viés entra já na escolha do indicador, do período e da base de comparação. O projeto não promete neutralidade; promete três coisas verificáveis:

- **Simetria**: a mesma régua para os dois governos, em todos os temas.
- **Transparência**: toda escolha de método fica documentada, com o porquê.
- **Rastreabilidade**: todo número leva à fonte original em um clique.

O site não dá nota nem placar. Um "quem ganhou" exigiria dar peso a cada tema, e esse peso é o juízo de valor que cabe ao leitor.

## 2. Escopo

### 2.1 Mandatos

| Coluna | Período | Papel |
|---|---|---|
| Lula 1 | 2003–2006 | comparado |
| Lula 2 | 2007–2010 | comparado |
| Bolsonaro | 2019–2022 | comparado |
| Lula 3 | 2023–2026 (em curso) | comparado |
| Dilma 1, Dilma 2, Temer | 2011–2018 | contexto |
| FHC 2 | 2002 | só como herança de Lula 1 |

Os mandatos aparecem separados. Uma média dos três mandatos de Lula misturaria contextos mundiais diferentes. Datas exatas em [mandatos.csv](mandatos.csv).

### 2.2 Linha do tempo contínua

As séries vão de 2002 a 2026. O ano de 2002 entra para mostrar o que Lula 1 herdou. Dilma e Temer aparecem sombreados como contexto, porque cada governo herda o anterior: Bolsonaro recebeu o pós-recessão de 2015–16 e o teto de gastos; Lula 3 recebeu o pós-pandemia e as mudanças fiscais de 2022.

### 2.3 Atribuição de períodos

- **Dado anual**: o ano civil pertence ao mandato em que está. Todos os mandatos comparados começam em 1º de janeiro, então nenhum ano fica dividido entre dois governos comparados. O ano de 2016, dividido entre Dilma e Temer, aparece como transição.
- **Dado mensal**: o mês pertence a quem governava no último dia do mês.
- **Mandato em curso**: Lula 3 usa o último dado disponível e leva o rótulo "parcial". Séries anuais usam só anos completos; o ano corrente aparece à parte, como acumulado no ano.

### 2.4 Indicadores fixados antes

A lista de indicadores de cada tema é escolhida antes de ver os resultados, para evitar a seleção involuntária do que confirma uma opinião prévia. A lista fica em [indicadores_fixados.md](indicadores_fixados.md) e entra no git antes da primeira coleta do tema. O histórico de commits prova a ordem.

Trocar ou acrescentar indicador depois é permitido, mas a mudança fica registrada em [decisoes.md](decisoes.md), com o motivo, e o indicador original continua publicado.

### 2.5 Mesma régua

- **Valores em reais**: corrigidos pelo IPCA, a preços médios de 2025. Exceção: o PIB, cuja variação real é medida pelo índice de volume do IBGE (decisão D-008).
- **Per capita** quando o tamanho da população importa.
- **Em % do PIB** para estoques e fluxos fiscais.

## 3. Como resumir um mandato

Cada indicador mostra, por mandato, três números.

- **Herdou**: o valor do último período antes da posse. Dado anual: o ano anterior. Dado mensal: dezembro do ano anterior.
- **Entregou**: o valor do último período do mandato. Para Lula 3, o último disponível, marcado "parcial".
- **Média do mandato**, que depende do tipo de indicador:

| Tipo | Exemplo | Resumo |
|---|---|---|
| Taxa de variação | crescimento do PIB, inflação | taxa média composta: ((1+x₁)(1+x₂)…(1+xₙ))^(1/n) − 1 |
| Nível ou taxa | Selic, câmbio, resultado primário | média aritmética |
| Estoque | dívida em % do PIB | variação em pontos percentuais (entregou − herdou), além da média |

Toda média vem em duas versões: com e sem 2020–21 (seção 7).

Para os indicadores com equivalente internacional, o resumo também mostra o Brasil menos a mediana dos pares, ano a ano e na média do mandato (seção 6).

## 4. As quatro camadas

Todo tema é apresentado em quatro camadas que nunca se misturam.

1. **Fato**: o dado bruto, com fonte. Sem adjetivo.
2. **Contexto**: o que estava fora do controle do governo. Preço de commodities, juros e crescimento mundiais, pandemia, composição do Congresso, decisões do STF, de estados e municípios.
3. **Decisão**: o que o governo de fato fez, em leis, decretos, medidas provisórias, vetos e execução orçamentária. Sempre com link para o ato oficial. Fica em `eventos/<tema>.csv`.
4. **Leitura**: o melhor argumento favorável e o melhor argumento crítico, lado a lado, rotulados como interpretação e atribuídos a autores identificáveis. As duas leituras têm o mesmo espaço e a mesma posição na página.

Regras de convivência:

- Nenhum número aparece na leitura sem estar antes na camada de fato.
- A camada de contexto não absolve nem condena: registra o que mudou fora do governo, com dado.
- A separação resolve o caso do PIB. O número fica na camada 1; o porquê fica nas camadas 2 e 3. Um PIB menor pode vir de um choque externo ou de uma escolha de gasto, e o site mostra qual.

## 5. Fontes

### 5.1 Hierarquia

| Nível | Tipo | Uso permitido |
|---|---|---|
| 1 | Órgão oficial primário: IBGE, Banco Central, Tesouro, ministérios, Planalto, Congresso, TCU, CGU, INPE, ONU, NDB | números, fatos, decisões |
| 2 | Instituição independente: IFI do Senado, Ipea, FGV, FMI, Banco Mundial, CEPAL, OCDE | números e contexto |
| 3 | Artigo acadêmico | contexto e leituras |
| 4 | Imprensa | só data e descrição de evento na linha do tempo, nunca números |

Quando a mesma série existe em dois níveis (por exemplo, o IPCA no IBGE e no Banco Central), usa-se a do órgão que produz o dado.

Rede social não entra como fonte. Entra como objeto de checagem: o projeto lista as dez afirmações mais repetidas de cada lado e confere cada uma contra a base.

### 5.2 Ficha por indicador

Cada indicador tem uma ficha em `fontes/fichas/<tema>/<id>.md` com definição, fonte, link, código da série, data de extração, unidade, deflator e ressalvas. O cabeçalho da ficha é lido pelo script de coleta: a ficha é o catálogo. Modelo em [modelos/ficha_indicador.md](modelos/ficha_indicador.md).

### 5.3 Reprodutibilidade

- **Coleta por script.** Banco Central (SGS), IBGE (SIDRA), FMI (SDMX) e FRED têm API. Os scripts em `scripts/` usam só a biblioteca padrão do Python, para que qualquer pessoa rode sem instalar nada.
- **Bruto intocado.** Cada download vira um arquivo em `dados/brutos/<fonte>/` com a data no nome, nunca editado nem sobrescrito, e ganha uma linha no manifesto da pasta com URL da consulta, data e hash SHA-256.
- **Tratado derivável.** Todo CSV em `dados/tratados/` sai dos brutos por script. Ninguém edita o tratado à mão.
- **Links arquivados.** Cada link de fonte documental vai para o Wayback Machine, porque páginas de governo mudam. A cópia fica na coluna `url_arquivada`.
- **Documentos.** O Zotero organiza PDFs e relatórios, com citação pronta. Os arquivos ficam em `documentos/`.

## 6. Comparação com pares

Comparar o Brasil com outros países no mesmo período separa o que foi do mundo do que foi do governo. O boom de commodities de Lula 1 e 2 foi vento a favor para toda a América Latina; a pandemia atingiu todos os países.

- **Fonte**: FMI, World Economic Outlook, via API SDMX. Mesmo conceito estatístico para todos os países, inclusive o Brasil. Por isso, na comparação com pares, o número do Brasil também vem do WEO, mesmo quando o IBGE ou o Banco Central publicam a série original.
- **Grupos** (lista em [pares.csv](pares.csv)):
  - **América Latina**: os países da lista de América Latina da CEPAL com dados no WEO, sem o Brasil (18 países).
  - **Emergentes do G20**: Argentina, China, Índia, Indonésia, México, Rússia, Arábia Saudita, África do Sul e Turquia.
- **Estatística**: mediana anual. A mediana impede que um país grande domine o grupo e resiste a valores extremos (Venezuela, Argentina). Quando falta dado de um país num ano, a mediana usa os disponíveis e o número de países fica registrado.
- **Projeções**: valores projetados pelo WEO não entram.

A escolha dos grupos está registrada na decisão D-009.

## 7. Pandemia e situações extremas

A pandemia não vira âncora nem é apagada. Três técnicas, usadas juntas, isolam o choque sem escondê-lo.

- **Com e sem 2020–21.** Todo gráfico e toda média ganham as duas versões. Excluir esses anos tira a queda do PIB e também o Auxílio Emergencial, que reduziu a pobreza em 2020. As duas coisas saem juntas, e o site diz isso.
- **Comparação com pares.** O Brasil é comparado à mediana da América Latina e dos emergentes no mesmo período (seção 6). O mesmo vale para o boom de commodities de Lula 1 e 2.
- **Módulo de crises.** Cada crise recebe uma ficha idêntica, com cinco seções: o que aconteceu; o que era competência federal; quais decisões foram tomadas e quando; resultado mensurável; como os países pares se saíram. Modelo em [modelos/ficha_crise.md](modelos/ficha_crise.md). Fichas em `eventos/crises/`.

Crises candidatas:

| Governo | Crises |
|---|---|
| Lula 1 e 2 | crise financeira de 2008 |
| Bolsonaro | Brumadinho (2019), queimadas na Amazônia (2019), pandemia (2020–21), crise hídrica (2021), choque de combustíveis (2022) |
| Lula 3 | 8 de janeiro (2023), crise Yanomami (2023), enchentes do RS (2024), tarifaço dos EUA (2025) |

## 8. Armadilhas conhecidas

Cada armadilha que afeta um indicador aparece na seção "Ressalvas" da ficha dele.

**Do plano original**

- A PNAD Contínua só existe desde 2012. O emprego em Lula 1 e 2 vem da PME, que cobria seis regiões metropolitanas. As séries não se emendam diretamente.
- O CAGED mudou de metodologia em 2020 (Novo CAGED). Saldos antes e depois não são comparáveis sem ajuste.
- O Banco Central tem autonomia formal desde 2021 (LC 179/2021), com mandatos fixos para a diretoria, descasados do mandato presidencial. A partir daí, a Selic deixou de ser decisão de um diretor demissível pelo presidente.
- Educação básica e segurança pública são majoritariamente estaduais e municipais.
- Políticas têm defasagem: o efeito de uma reforma costuma aparecer no mandato seguinte.

**Encontradas na preparação do piloto de economia**

- **Orçamento do primeiro ano.** O primeiro ano de cada mandato roda com a lei orçamentária proposta pelo governo anterior. O site marca o primeiro ano.
- **Revisões do PIB.** O IBGE revisa os anos recentes quando publica as Contas Nacionais anuais, com cerca de dois anos de atraso. Até lá, os dados vêm das Contas Trimestrais e são preliminares.
- **Quebra na dívida bruta.** O Banco Central mudou a metodologia da dívida bruta do governo geral em 2008; a série nova começa em dezembro de 2006. Para 2002–2006 só existe a série antiga, que inclui os títulos do Tesouro na carteira do Banco Central e por isso dá valores mais altos. As duas não se emendam.
- **Eventos fiscais não recorrentes.** Receitas ou despesas únicas mudam o resultado primário de um ano sem mudar a política fiscal de fundo: cessão onerosa da Petrobras (2010), dividendos e privatização da Eletrobras (2022), pagamento de precatórios atrasados (2023). As fichas listam esses eventos.
- **Preços administrados.** Parte do IPCA (combustíveis, energia, tarifas) muda por decisão de governo, como a redução de tributos sobre combustíveis em 2022 ou o reajuste de energia em 2015. A inflação de um ano pode refletir essas decisões, não só a política monetária.
- **População revisada.** O Censo 2022 contou menos gente do que as projeções previam, e o IBGE refez a série de população. Indicadores per capita usam a série de população do próprio IBGE nas Contas Nacionais, que já incorpora a revisão.

## 9. Revisão adversarial

Antes da publicação, uma pessoa de cada lado tenta derrubar o material. Cada objeção recebe resposta escrita; o que estiver certo é corrigido, e a correção fica registrada em [decisoes.md](decisoes.md).

## 10. Ordem de execução

| Etapa | Status |
|---|---|
| 1. Documento de metodologia, com escopo e as quatro camadas | versão 0.1 (este documento) |
| 2. Piloto completo de economia, com 8 a 10 indicadores, da coleta ao gráfico | feito: dados, linha do tempo, leituras e página |
| 3. Expandir tema por tema | em andamento: emprego e renda, educação e meio ambiente completos; política externa com o estudo de caso do BRICS |
| 4. Linha do tempo de decisões e módulo de crises | linhas do tempo de economia, emprego e renda, educação, meio ambiente e BRICS feitas; módulo de crises a fazer |
| 5. Checar as narrativas mais repetidas de cada lado | a fazer |
| 6. Revisão adversarial, uma pessoa de cada lado | a fazer |