Brasil-Imposto

O que é

O Brasil-Imposto mostra, com dados oficiais, como o imposto pago no Brasil é arrecadado e redistribuído entre a União, os estados e os municípios, quem ocupa cada cargo dos três Poderes e quanto recebe, e para onde vai o dinheiro. Cada número tem a fonte oficial ao lado, com o link, o período e a data da coleta.

Estado: primeira versão pública (v1). As páginas são arquivos HTML estáticos montados a partir dos dados deste repositório e publicados no GitHub Pages em dois sites: o de testes, https://brasil-imposto.github.io/staging/, refeito a partir do ramo staging (hoje pelo mantenedor; automático quando o token do disparo existir), e a produção, https://brasil-imposto.github.io, que recebe uma tarefa aprovada por vez, levada do staging para a main. O site definitivo, em Astro, está em construção.

As páginas

Início: o mapa

O mapa do Brasil com o saldo de cada estado com a União: o que foi para a União menos o que voltou, por mês, ano ou mandato desde 2019, por habitante, no total ou em proporção. Ao lado, as contas do Brasil no período (resultado, juros e dívida) e quem presidia o país. Cada estado abre uma janela com a sua conta; SC e RS mostram também os municípios, e o DF as Regiões Administrativas.

Abrir: https://brasil-imposto.github.io

Os 3 Poderes

A árvore dos cargos da União e a ficha de cada pessoa: os 513 deputados, os 81 senadores, o presidente, o vice, os ministros de Estado e os ministros dos tribunais superiores, com o salário, cada auxílio e o que cada um usou em 2026. Para cada parlamentar, cada projeto que apresentou e o que aconteceu com ele. Em cada ficha, "Pedir correção" abre o formulário já preenchido.

Abrir: https://brasil-imposto.github.io/os-3-poderes.html

Como o dinheiro anda

Quem cobra cada imposto, as partes que a Constituição manda passar de um governo para o outro, quem gasta o quê e o que vira dívida, com os números de 2025. Três formas contam o mesmo caminho: siga R$ 100 de um imposto, os seis passos do dinheiro e o grande fluxo do ano.

Abrir: https://brasil-imposto.github.io/como-o-dinheiro-anda.html

De onde vêm os números

Receita Federal (arrecadação por estado), Tesouro Nacional (Resultado do Tesouro Nacional e SICONFI), Portal da Transparência (gastos, repasses, folha, cartões e viagens), INSS, MDS, IBGE (população e PIB), Câmara dos Deputados, Senado Federal, CNJ e os tribunais superiores, TSE, Planalto (leis e Constituição) e os portais dos estados e municípios cobertos. Os scripts que buscam e montam cada base estão em pipelines/ e docs/superpowers/tools/; as pesquisas que explicam cada escolha estão em docs/research/, e as decisões do projeto em docs/decisions/README.md.

Regras de método que aparecem na tela:

• Sem informação de estado: o dinheiro que a fonte oficial não põe em nenhum estado fica num bloco próprio, nunca espalhado pelos estados.
• DF, estimativa: a Receita registra no DF o imposto que órgãos e empresas com sede em Brasília retêm ou pagam pelo país inteiro (Lei 9.779/1999, art. 15). No mapa, em cada imposto o DF conta no máximo a sua parte no PIB do Brasil (IBGE); o que passa disso vai para o bloco da União. A outra estimativa do saldo são os meses de fevereiro de 2025 a janeiro de 2026, em que a Receita lançou no DF a arrecadação de outros estados; nos dois casos a tela diz que é estimativa.
• Repasse não é gasto: dinheiro que só passa de um governo para outro não conta como gasto de quem só repassou.

Correções: quando um número publicado muda por correção, a mudança entra no registro público data/corrections.json: o que estava, o que ficou, por quê, quando, a fonte oficial e o pull request.

Neutralidade

Só dados oficiais, com fonte; nenhum chamado ao voto; o mesmo tratamento para qualquer governo e qualquer partido; pessoas aparecem só com o papel que têm num documento oficial. As regras completas, e quem decide no projeto, estão em GOVERNANCE.md.

Como abrir na sua máquina

Só é preciso Python 3, sem pacotes extras:

python3 docs/superpowers/tools/build-cases.py
python3 docs/superpowers/tools/build-standalone-data.py
python3 docs/superpowers/tools/build-simulation.py
python3 docs/superpowers/tools/build-platform-preview.py

A página Como ler o mapa lê as notas de assets/map-notes.js, que pede também o Node: node docs/superpowers/tools/build-map-notes.cjs.

Depois, abra os arquivos das páginas no navegador pelo caminho do arquivo (eles ficam em docs/superpowers/previews/). Os pacotes assets/bi-data.js, assets/bi-federal.js, assets/map-notes.js e assets/bi-geo*.js não ficam no repositório: são refeitos por esses comandos a partir de data/.

Os pipelines de pipelines/ e os testes usam Python 3.12 com as versões fixadas em uv.lock: instale o uv e rode uv sync --locked, depois uv run python -m unittest discover -s pipelines/tests.

Conferir tudo como o ci (Python 3.12 com uv, Node 24; cerca de um minuto e meio):

uv sync --locked
uv run --locked python docs/superpowers/tools/check-all.py

As sondas no navegador usam as variáveis PW_CORE, CHROME_HEADLESS e CDN_MIRROR. O passo a passo, os erros comuns e a revisão estão no CONTRIBUTING.md, seção "Para desenvolver".

O site em Astro (em construção)

A pasta site/ tem o esqueleto do site definitivo: Astro 7, TypeScript estrito e uma página de prova que lê os arquivos de cada entidade, gerados a partir de data/ e conferidos com os esquemas de schemas/. Com Node 24 e o uv:

cd site && npm ci && npm run entities && npm run types && npm run check && npm test && npm run build

O site no ar continua sendo o das páginas acima até a última fase do Astro.

Como o repositório é organizado

Pasta	O que tem
data/	Os dados publicados, um arquivo por base, com a fonte e a data da coleta
pipelines/	Os scripts que buscam e montam cada base, e os testes
docs/superpowers/tools/	Os construtores das páginas e as ferramentas de conferência
docs/superpowers/previews/	As três páginas publicadas e o que elas carregam (assets/)
docs/research/	As pesquisas por trás de cada número e de cada regra
docs/decisions/	O registro das decisões do projeto e das perguntas em aberto
docs/superpowers/specs/ e plans/	O desenho aprovado de cada mudança e o plano de cada fase
schemas/ e site/	Os esquemas JSON e o site em Astro
.github/	Os formulários de issue, o modelo de pull request e as automações (ci, dco, pages)

Estado do projeto

Pronto (v1): as três páginas acima; o saldo dos 27 estados com a União por mês, ano e mandato desde 2019; as contas do Brasil; os municípios de SC e do RS e as Regiões Administrativas do DF; Os 3 Poderes com 722 fichas; o pacote de colaboração (formulários de issue, modelo de pull request, governança, código de conduta, segurança e o check do DCO).

O que vem (cada item é uma issue aberta):

• O site em Astro, fase por fase, cada fase aprovada antes do código: B1 a B5.
• "Pedir correção" em todas as páginas (#9).
• CI de proveniência (#10) e OpenSSF Scorecard (#11).
• Guias dos pipelines e documentos de fontes e créditos (#12).
• O salário de 3 ministros licenciados da Câmara (#13).
• Os municípios de outros estados (#14).

Como ajudar

Corrigir um número, acrescentar uma fonte, cobrir os municípios de um estado, propor um caso ou relatar um defeito: comece por um dos formulários de issue. Mudanças entram por pull request para o ramo staging, são conferidas no site de testes e só depois vão à produção; as regras para virar colaborador e para documentar um pull request estão na página da organização. Perguntas e ideias ficam em Discussions; falhas de segurança se relatam em privado (SECURITY.md); a convivência segue o código de conduta.

Licenças

Código: AGPL-3.0 (LICENSE). Dados publicados em data/ e textos: CC BY 4.0 (LICENSE-DATA), citando "Fonte: <órgão>; dados tratados pelo Brasil-Imposto". O dado público de origem segue as regras de cada órgão. Fotos e bandeiras: a licença e o crédito de cada arquivo estão junto deles.

In English

Brasil-Imposto is a civic, nonpartisan, open-source map of Brazilian public money built only from official data: how federal, state and municipal taxes are collected and shared, what each federal officeholder is paid and uses, and where the money goes. The site is https://brasil-imposto.github.io. The pages are static HTML built from data/ with Python 3 and no extra packages (commands above); an Astro site is being built phase by phase (issues #3 to #7). Code is AGPL-3.0; data and texts are CC BY 4.0. Issues and pull requests are welcome, in Portuguese or English; every number needs its official source. Pull requests go to the staging branch, which publishes the test site https://brasil-imposto.github.io/staging/; production only receives what was checked there. How to contribute and how to document a pull request: https://github.com/Brasil-Imposto.