Tá na Urna · Eleições 2026

No ar: https://www.tanaurna.com.br/

Site de transparência eleitoral que reúne somente dados públicos oficiais (TSE, Câmara dos Deputados e Senado Federal) sobre todas as candidaturas de 2026 e sobre os gastos de mandato de deputados federais e senadores. Não produz opinião, não exibe pesquisas e não recomenda votos.

O que tem

Página	Rota	Conteúdo
Início	/	Abas Resultados e Candidaturas. Nas noites de apuração (dia de votação, das 17h de Brasília à madrugada) abre em Resultados; nos outros dias, em Candidaturas (contagem regressiva, presidenciáveis, mapa)
Resultados	/resultados	Apuração ao vivo do TSE: mapa interativo por estado, 1º e 2º turnos, Presidente (padrão), Governador, Senado e deputados, UF do eleitor pela localização, busca por nome ou número e candidaturas "acompanhadas"
Candidatos	/eleicao/:uf/:cargo	Presidente, governador, Senado e deputados de todas as UFs, com filtros
Perfil	/candidato/:sq	Perfil, situação do registro, patrimônio (2026 × 2022), campanha, trajetória, mandato, plano de governo
Comparar	/comparar	Até 4 candidaturas lado a lado (link compartilhável ?c=sq1,sq2)
Minha cola	/cola	Números na ordem da urna, para imprimir. Fica só no aparelho
Simulador	/simulador	Urna educativa com fotos e números reais
2º turno	/segundo-turno	Apuração oficial e finalistas lado a lado (preenche sozinho com o feed do TSE)
Planos de governo	/planos	Busca por tema nos planos registrados no TSE pelos finalistas do 2º turno: trecho, página e link para o PDF oficial (texto extraído por .github/workflows/planos.yml)
Gastos de mandato	/gastos, /parlamentar/:id	Cota parlamentar (CEAP/CEAPS) desde 2023, ranking com comparação mensal justa por UF
Em números	/numeros	Perfil das candidaturas: gênero, idade, instrução, financiamento, concorrência por vaga
Fontes e método	/sobre	Todas as fontes com links e datas, metodologia e limitações

Estados Unidos (/eua)

Área própria, com seletor de país no topo (no celular estreito, no menu "Mais"). Mesmo método do Brasil: só dados públicos oficiais, cada bloco com a fonte, ordem alfabética, sem cores de partido (nem o vermelho e o azul americanos), informativo e sem pedido de voto. Base legal e limitações em /eua/sobre.

Página	Rota	Fonte
Início	/eua	contagem para a eleição geral, mapa dos estados (malha do Census Bureau)
Congresso	/eua/congresso, /eua/membro/:bioguide	Clerk da Câmara, Biographical Directory (retratos), congress-legislators (CC0)
Votações	/eua/votacoes, /eua/votacoes/:id	roll call votes do Clerk e do Senado (LIS)
Estado	/eua/estado/:uf	tudo do estado: bancada, candidaturas, resultados, gasto federal
Eleições	/eua/eleicoes	MIT Election Lab (CC0, desde 1976), Colégio Eleitoral (National Archives), órgãos eleitorais (USAGov)
Candidaturas	/eua/candidatos	FEC (cn/weball): só totais, nunca doadores (52 U.S.C. § 30111(a)(4))
Gastos	/eua/gastos	Statement of Disbursements da Câmara e USAspending.gov
Suprema Corte	/eua/suprema-corte, /eua/suprema-corte/:id	supremecourt.gov e uscourts.gov

Isolamento: coleta em backend/etl/eua/ (grava só api/eua/ e eua/ do site), interface em frontend/src/eua/ (carregada sob demanda), automação em .github/workflows/eua.yml. A agenda (em etl/eua/montar.py) acompanha cada fonte: passada diária completa, decisões da Suprema Corte nos dias úteis de outubro a julho, votações depois das sessões, e passadas reforçadas na eleição geral (novembro dos anos pares) e na posse do Congresso (janeiro dos ímpares). Rodar na hora: gh workflow run eua.yml (opcional: -f partes=votacoes,fec). O mapa vem de python -m etl.eua.malha (uma vez; as divisas não mudam).

Princípios de neutralidade (aplicados no código)

• Mesmos campos, mesmo layout e ordem alfabética para todos; outras ordenações só por escolha do usuário.
• Nenhuma cor de partido: gráficos com uma única cor neutra (paleta validada para daltonismo).
• Cada bloco de dados tem um selo Fonte oficial com o arquivo de origem, a data em que o órgão o gerou/publicou e a data da coleta (fontes no banco, alimentada pelo Last-Modified dos servidores).
• Dados ausentes = "Não informado". Valores autodeclarados são exibidos como publicados.
• CPF e título de eleitor ficam só no banco, para cruzamentos; um teste garante que nunca saem na API.
• Visão "partidos com 5+ parlamentares" (critério objetivo do art. 46 da Lei 9.504/97) com a opção "Todos na urna" sempre a um clique.

Arquitetura

backend/   Python: ETL (TSE + Câmara + Senado) → SQLite → API FastAPI somente leitura
  etl/tse.py            candidaturas, bens, histórico, redes, vagas, prestação de contas, fotos, planos
  etl/parlamentares.py  cota parlamentar da Câmara e do Senado (2023–2026)
  etl/derivados.py      vínculo parlamentar↔candidatura, bancadas, fontes e avisos
  etl/resultados.py     apuração oficial (resultados.tse.jus.br), só totalização final (para o 2º turno e os perfis)
  app/queries.py        formato público da API (uma função por endpoint)
  app/main.py           FastAPI (GET /api/*.json, /fotos, /propostas)
  app/export.py         grava a mesma API como arquivos estáticos
frontend/  React 19 + MUI 9 (template Faísca), login Google pronto mas desligado

A API tem formato estático: todo endpoint é um GET sem query string (/api/uf/SP.json). Por isso o mesmo site roda com o FastAPI (desenvolvimento) ou como arquivos estáticos em qualquer hospedagem.

Rodando localmente

Pré-requisitos: Python 3.11+, Node 20.19+.

make setup     # venv + npm install
make dados     # baixa e processa tudo (~4 min na primeira vez; cache em backend/data/raw)
make dev       # API em :8077 + site em http://localhost:5173
make testes    # pytest (privacidade, fontes, ordem, 2º turno) + typecheck + vitest

Apuração ao vivo

A apuração não depende de republicar o site: o navegador lê o arquivo oficial do TSE (resultados.tse.jus.br/oficial/ele2026/<eleição>/dados/<uf>/<uf>-c<cargo>-e<eleição>-u.json, o mesmo que o app Resultados do TSE usa; CORS liberado) a cada minuto (frontend/src/data/apuracao.ts). Códigos: 6257/6259 (1º turno, federal/estadual), 6258/6260 (2º turno). O calendário (17h de Brasília) fica em frontend/src/data/calendario.ts.

• A UF do eleitor vem da geolocalização do navegador, convertida em UF no aparelho com a malha do IBGE (frontend/src/data/localizacao.ts). Nada é enviado; só a sigla fica no localStorage.
• A posição de cada candidatura vem dos votos: o campo seq do TSE repete a ordem nacional nos arquivos por UF.
• O horário exibido é dg/hg (Brasília); dt/ht vêm no fuso local de cada UF.

O resultado final (arquivos com tf = s) vai sozinho para o site, no GitHub Actions, sem depender de nenhum computador: .github/workflows/apuracao.yml roda a cada 10 min, consulta o TSE e, se surgiu resultado final novo, reescreve só os JSON que dependem dele (perfis, resultados.json, segundo-turno.json, meta.json) direto na branch gh-pages (backend/etl/apuracao_remota.py, testado contra o caminho do banco). Desliga sozinho em 01/11/2026. Para rodar na hora: make apuracao-remota (ou "Run workflow" na aba Actions).

Interface publicada sozinha

.github/workflows/site.yml: a cada push na main que mexe no frontend, roda os testes, faz o build e troca só a interface no site publicado (assets e as ~22 mil páginas por rota, remontadas com o index.html novo por backend/app/frontend_remoto.py). Dados novos do TSE/Câmara/Senado (make dados) ainda pedem make publicar.

Publicando como site estático

make publicar  # build + export + push para gh-pages (GitHub Pages)

O export gera também uma página HTML por candidatura (título, descrição e foto oficial nas meta tags), para que links compartilhados abram com status 200 e prévia correta. Para outra hospedagem, make exportar gera frontend/dist (~600 MB); configure fallback de SPA (rota → index.html).

App Android (e iOS)

O mesmo frontend vira app nativo com Capacitor (frontend/android/), lendo os dados do site público. Permissões: internet e localização aproximada (opcional, só para achar o estado na apuração; a precisa é declarada apenas até o Android 11, que não oferece a aproximada). Política de Privacidade e Termos em /privacidade e /termos. Gerar o pacote: make app-release. Guia de publicação na Google Play (e caminho para a App Store) em loja/README.md, com kit de preenchimento em loja/kit-google-play.html.

Pesquisas eleitorais (pendente, fora do ar)

O código da aba de pesquisas e os dados curados (backend/curadoria/pesquisas.json) estão no repositório, mas a funcionalidade está desligada até que cada número de registro seja conferido no PesqEle/TSE. Passo a passo para religar em backend/curadoria/PESQUISAS_PENDENTE.md.

Backend no Cloud Run + banco no Neon

A API também roda contra Postgres (DATABASE_URL). make neon publica o banco (sem CPF, troca atômica) e backend/Dockerfile empacota a API para o Cloud Run. Passo a passo em DEPLOY.md.

Login (desligado)

Todo o site é público. Para ligar o login com Google: VITE_ENABLE_LOGIN=true e configure o adaptador (VITE_AUTH_PROVIDER=firebase ou backend) conforme frontend/docs/configuracao-google.md.

Limitações conhecidas

• Os arquivos anuais da Câmara não trazem passagens aéreas (SIGEPA) a partir de ago/2025; o ranking abre em 2024 e permite excluir passagens para comparar anos.
• Gastos de deputados estaduais, governadores e presidente não têm base aberta padronizada única.
• O Senado não publica o teto da cota por UF em formato aberto.
• Prestação de contas de campanha é parcial até a entrega final.

Interface construída com o template Faísca.