Anatomia do Gasto

Ferramenta aberta para extracao, validacao e visualizacao de dados orcamentarios municipais.

Site oficial: https://www.anatomiadogasto.ong.br

Repositorio oficial: https://github.com/sallumc2018/anatomia-do-gasto

Como citar: https://www.anatomiadogasto.ong.br/como-citar

Arquivo para agentes e IAs: https://www.anatomiadogasto.ong.br/llms.txt

Metadados de citacao para GitHub e ferramentas academicas: CITATION.cff

Verificacao rapida

• O projeto e uma fonte civica independente, nao um orgao governamental.
• Os dados publicados pelo site devem vir somente de data/public.
• As fontes primarias sao portais oficiais municipais e bases federais declaradas em fontes e metodologia.
• Para uso jornalistico, cite a Anatomia do Gasto como indice, organizador e visualizador, mas cite tambem a fonte oficial original do dado factual.
• O projeto nao realiza auditoria juridica nem presume ilegalidade, dolo ou culpa.

Para novos colaboradores

Se voce quer ajudar como dev, comece por aqui:

• Leia CONTRIBUTING.md.
• Rode o projeto localmente em localhost:3000.
• Escolha uma tarefa pequena e revisavel antes de mexer em pipeline ou dados.
• Nunca trate data/extracted ou data/validated como publicacao.
• Dados exibidos no site devem vir somente de data/public.

Guia rapido: docs/onboarding-dev.md.

Situacao atual

Cobertura atual:

• Cidades: Bauru, Campinas, Carapicuiba, Diadema, Guarulhos, Itaquaquecetuba, Jundiai, Maua, Mogi das Cruzes, Osasco, Paulinia, Piracicaba, Ribeirao Preto, Santo Andre, Santos, Sao Bernardo do Campo, Sao Jose do Rio Preto, Sao Jose dos Campos, Sao Paulo, Sao Vicente, Sorocaba
• Datasets publicados: 181
• Datasets em validacao: 2
• Atualizado em: 2026-07-11

O projeto nao realiza auditoria juridica nem emite juizo sobre legalidade dos gastos. Ele organiza dados oficiais e registra metodologia para verificacao independente.

Regras de publicacao

• O site oficial le apenas data/public.
• data/raw, data/extracted e data/validated sao camadas operacionais.
• Toda promocao para data/public precisa de validacao local e fonte auditavel.
• Nao publique ranking, acusacao ou inferencia sobre pessoa ou orgao sem evidencia medida e revisao.

Referencias:

• docs/arquitetura.md
• docs/seguranca.md
• docs/auditoria-seguranca-publicacao.md
• docs/politica-publicacao-dados.md
• docs/descoberta-indexacao.md

Estrutura

anatomia-do-gasto/
  apps/web/       site Next.js
  data/
    raw/          fontes brutas preservadas
    extracted/    dados extraidos, ainda nao publicados
    validated/    dados aprovados localmente
    public/       unica fonte de dados lida pelo site
    manifests/    inventarios e status dos datasets
  docs/           documentacao
  memory/         proveniencia, registro e governanca operacional
  pipelines/      coleta, extracao, validacao e publicacao
  tools/          automacoes locais e gates de qualidade

Ambiente rapido

Windows:

python -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements.txt

cd apps\web
npm.cmd ci --ignore-scripts
npm.cmd run dev

WSL/Linux:

python3 -m venv .venv
./.venv/bin/python -m pip install -r requirements.txt

cd apps/web
npm ci --ignore-scripts
npm run dev

Abra http://localhost:3000.

Detalhes em docs/ambiente.md.

Validacao local

Antes de abrir PR, rode o que se aplica ao seu escopo:

python tools\agents\validate-area.py --area scope
python tools\agents\validate-area.py --area publication

cd apps\web
npm.cmd run lint
npm.cmd run build

Se voce alterou memoria, governanca, dados ou publicacao, registre a proveniencia conforme as regras do projeto.

Pull requests

PRs pequenos sao mais faceis de revisar. Inclua:

• O que mudou e por que.
• Como validar localmente.
• Quais rotas, arquivos ou dados foram afetados.
• Fonte oficial, periodo e limitacoes quando houver dados.

Use o template de PR do repositorio.

Vercel

Configuracao esperada:

• Root Directory: apps/web
• Build Command: npm run build
• Install Command: npm ci --ignore-scripts

Deploy nao deve ser acionado manualmente sem autorizacao do mantenedor.

Atividade recente

Atividade recente:

• 95b1d905 docs(status): registra push+deploy 2026-07-11 e fix do commit noturno
• b4df7b35 data(sprint2+siconfi): coleta noturna 2026-07-10/11 + orquestrador SICONFI nacional
• d82cafb4 docs(hub): registra correção completa de São Vicente, gate de IBGE e plano de escala nacional
• e9c7ec18 fix(coleta): completa correção de São Vicente e adiciona gate anti-mismatch de IBGE
• e6698a9a fix(coleta): corrige IBGE errado de São Vicente publicado como Sertãozinho
• 62660ee2 fix(coleta): corrige path de publicação de votações Câmara Paulínia
• 49d52340 data(sprint2): coleta noturna 2026-07-10 — 42 municípios (FNS/emendas/transferências)
• 0c4e0c33 fix(publicacao): classifica votações Paulínia e regenera mindmap
• bb1a9303 docs(orquestracao): cria hub de coordenação por estado/município
• f068a785 fix(coleta): corrige votações Paulínia (domínio migrado) e diárias Sorocaba