Puxa Ficha
Plataforma cívica de consulta pública sobre candidatos das eleições brasileiras
de 2026. Ficha pública, comparador lado a lado e pontos de atenção com fontes
visíveis. Os dados vêm de bases oficiais (TSE, Câmara dos Deputados, Senado
Federal, Portal da Transparência) sob a Lei de Acesso à Informação.
A cobertura pública inclui candidaturas à Presidência da República e aos
Governos estaduais, incluindo os vices das chapas. Candidaturas ao Senado são
exibidas quando SENADO_ENABLED está habilitado; nesse caso, a composição da
chapa pode apresentar suplentes.
Site: https://puxaficha.com.br
Como conferir um número do site
Este repositório é público por um motivo específico: qualquer pessoa deve poder
pegar uma afirmação do site e rastrear até a fonte oficial, sem precisar
acreditar em nós. Esta seção mostra como, com casos reais.
O caminho é o script que coletou (quando está neste repositório) e a URL oficial
que ele leu.
Patrimônio declarado
O valor vem do DivulgaCand, o sistema de divulgação de candidaturas do TSE.
- Coleta:
scripts/gerar-backfill-patrimonio-tse-2026.ts,
que lê o pacote oficial bem_candidato_2026 do portal de dados abertos do
TSE. Nenhum valor é digitado à mão.
- Conferência por candidato, sem depender de nós: a API pública do DivulgaCand em
divulgacandcontas.tse.jus.br/divulga/rest/v1/candidatura/buscar/2026/{UF}/20322002026/candidato/{SQ}
devolve os bens e o totalDeBens daquela pessoa. O SQ está na ficha.
- A soma dos bens tem que fechar com o total que o TSE devolve. Se não fecha, o
dado não sobe.
Em 18/08/2026 essa conferência encontrou 46 fichas publicando o dobro do
patrimônio declarado, por erro de leitura nosso, e as corrigiu. O histórico do
conserto está no log de commits, de propósito: um projeto de transparência que
apaga o rastro dos próprios consertos pede uma confiança que não oferece.
Lacuna conhecida, 18/08/2026. Nem todo script de coleta e auditoria que
gerou o dado publicado está neste repositório; parte vive no repositório de
trabalho. Enquanto isso não fecha, a API oficial acima é o caminho de
conferência que não depende de nós.
Espectro do partido no quiz
Cada eixo em src/data/quiz/espectro-partidario.ts
declara sua própria procedência. Quando o tipo é programa,
carta_de_principios ou manifesto, o registro traz trecho literal, URL e
data: abra a URL e procure o trecho.
Quando o tipo é curadoria, não existe documento ainda. É julgamento editorial
e está rotulado como tal, para que ninguém o confunda com fonte.
Duas coisas que este arquivo deliberadamente não faz: usar o estatuto
registrado no TSE, que é carta de organização interna e não diz o que o partido
defende; e citar a home do site do partido, que muda sem aviso.
Posição de partido nunca é escrita como declaração do candidato. Ela não entra em
posicoes_declaradas.
Votações nominais
Vêm das APIs abertas da Câmara e do Senado, com o identificador da proposição
preservado, para que o link leve à votação nominal original.
Doadores
O CPF do doador nunca é gravado em texto claro, nem neste repositório nem no
banco. Vira SHA-256(sal + ":" + cpf). O que fica visível é o padrão agregado
por setor, não a pessoa física.
Achou um erro?
Abre uma issue com o link da ficha e a fonte que contradiz. Erro de dado é o tipo
de contribuição mais útil que este projeto pode receber. Para falha de segurança,
use o canal privado em SECURITY.md, não uma issue pública.
Stack
- Next.js 16 (App Router, renderização sob demanda)
- TypeScript
- Tailwind CSS 4 + shadcn/ui
O HTML público é renderizado sob demanda porque o layout raiz lê o nonce CSP
específico de cada requisição. O cache de dados do Supabase continua separado
desse ciclo, por meio de unstable_cache.
Pré-requisitos
- Node.js 24.x (ver
.nvmrc)
Setup
npm ci
Para rodar a aplicação ou um script que usa integrações, copie somente as
chaves necessárias de .env.example para .env.local. O
inventário completo, com obrigatoriedade e fallback, fica em
Settings/AUTOMATIONS_AND_ENVIRONMENTS.md.
Credenciais reais nunca entram no Git.
Os gates de um PR não pedem banco, conta de nuvem nem arquivo .env:
npm run lint
npm run typecheck
npm test
npm run build
Scripts
npm run lint # ESLint
npm run typecheck # tsc --noEmit
npm test # testes unitários (node --test)
npm run build # build
npm run test:visual # testes visuais (Playwright: rode `npx playwright install` antes)
npm run validate:seed # valida a integridade do seed de candidatos
Os gates obrigatórios de um PR (lint, typecheck, test, build) não
dependem do Playwright. Os testes visuais são opcionais e exigem
npx playwright install para baixar os browsers.
Estrutura
src/ aplicação Next.js (rotas, componentes, libs)
scripts/ pipeline de ingestão e utilitários de dados
lib/ biblioteca compartilhada do pipeline
supabase/
migrations/ schema + seeds (SQL sequencial)
data/ seeds de produto (candidatos.json e afins)
tests/ testes unitários, de contrato e visuais
public/ estáticos (fotos de candidatos, ícones)
Privacidade
O CPF nunca é exposto no cliente; é usado apenas como chave de cruzamento no
servidor, durante a ingestão. Veja SECURITY.md. Se identificar
qualquer dado pessoal chegando ao browser, reporte pelo canal privado.
Contribuindo
Veja CONTRIBUTING.md e o
Código de Conduta. Toda contribuição roda pelo CI
(lint, typecheck, testes e build), que funciona em PRs de fork sem segredos.
Licença
Código sob Apache License 2.0: você pode usar, modificar, redistribuir
e hospedar livremente, inclusive comercialmente, preservando o aviso de copyright
e o NOTICE. A licença inclui concessão explícita de patente.
Os dados são públicos (Lei de Acesso à Informação) e não estão cobertos pela
licença do código. O NOTICE detalha isso e traz as ressalvas de
dependências de terceiros, em especial o GSAP, que tem licença própria e não
acompanha a permissão comercial da Apache 2.0.
