P-17
Raio X Eleitoral
Do Brasil à urna: um modelo territorial único para 2018, 2022 e 2026, apuração ao vivo coletada do TSE e acesso por equipe com links presos a um candidato.
clienteConsultoria de inteligência política atendendo uma campanha majoritária nacional e gabinetes parlamentares
Desenvolvedor responsável pelo sistema inteiro: banco de dados e ETL, rotas de backend, frontend e a reforma visual
Painel fechado sobre os dados públicos do TSE para as Eleições Gerais de 2026. Um servidor Linux próprio baixa os arquivos por seção, reconcilia locais de votação, decodifica boletins de urna em ASN.1 e coleta a apuração da noite com ETag e pausa coordenada; um Postgres no Supabase guarda 700 mil territórios e 13 milhões de linhas de resultado numa tabela particionada por nível, com RLS em tudo e nenhum acesso pelos papéis públicos; um site Next.js 16 serve a ficha do candidato, o explorador com mapa em canvas, a comparação entre eleições, a apuração ao vivo e a aba de abstenção, atrás de login com cookie HMAC, scrypt e bloqueio de força bruta. Seis relatórios bilíngues saíram da mesma base na semana seguinte ao 1º turno.
- ssr
- react
- postgres
- supabase
- etl
- rls
- lgpd
01Visão geral
O Raio X Eleitoral é um painel fechado, usado por uma consultoria de inteligência política que atende uma campanha majoritária nacional e um grupo de mandatos parlamentares. Ele responde a uma pergunta que toda campanha faz na noite da eleição e nas semanas seguintes: onde cada candidato foi bem ou mal, e o que mudou em relação à eleição anterior, descendo o mais fundo que os dados públicos permitem (região, estado, cidade, zona eleitoral, bairro, local de votação e seção).
Tudo o que aparece na tela vem de fontes abertas: os arquivos de votação por seção do portal de dados abertos do TSE, os JSONs de divulgação da noite da eleição, o boletim de cada urna (publicado em ASN.1) e as malhas territoriais do IBGE. O sistema não infere perfil de eleitor nem atribui intenção a ninguém. A regra registrada no projeto é "sem inventar nem pressupor nada": quando o TSE ainda não publicou um dado, a tela diz isso em vez de estimar.
O produto foi construído em nove dias de commits, entre o fim de setembro e a semana seguinte ao primeiro turno. Um servidor Linux dedicado faz a coleta e as cargas; um Postgres no Supabase guarda o modelo territorial; um site Next.js, publicado na Vercel e no próprio servidor, serve a equipe com login, links de acompanhamento para equipes de campo e um painel de administração com logs.
02O problema
Os dados eleitorais brasileiros são públicos, mas não são fáceis de usar em campanha:
- Volume e formato. O portal de dados abertos entrega ZIPs com CSVs em Latin-1 separados por
;, um por estado, com centenas de milhares de linhas por arquivo. O download completo do portal, feito no segundo dia do projeto, somou 18 GB. Nada disso é consultável sem um modelo de dados por trás. - Território fragmentado. Zona eleitoral e bairro não têm contorno oficial, o cadastro de locais de votação diverge entre o arquivo de votos e o de totais, e a divulgação da noite da eleição só desce até o município. Comparar 2022 com 2026 no mesmo recorte exige reconciliar tudo isso.
- Tempo. O primeiro turno foi em 4 de outubro de 2026. O sistema precisava estar pronto para coletar a apuração em tempo real nesse dia, com os dados de 2022 e 2018 já carregados para comparação, e virar relatórios para a equipe no mesmo fim de semana.
- Acesso controlado. O painel serve a uma campanha. Precisava de login por pessoa, de uma forma de dar a equipes de campo só a apuração de um candidato sem criar contas, e de um registro de quem viu e exportou o quê.
03A solução
- Ficha do candidato (presidente, governador, senador e um grupo de deputados acompanhados) com explorador territorial: mapa, tabela e barras, com a escala escolhida pelo usuário e o botão Voltar refazendo os passos.
- Comparação entre eleições no mesmo território: o candidato contra ele mesmo em 2022 (1º ou 2º turno) e contra o adversário do 2º turno, com quatro grupos de ação (recuperar, defender, empurrar, manter).
- Comparar candidatos livremente (2026, 2022 e 2018), com uma apresentação lúdica no estilo dos fliperamas de luta, sons gerados no navegador e rostos recortados das fotos oficiais.
- Buscar locais: todos os candidatos de um cargo num território, do estado à seção.
- Apuração ao vivo: placar, seções apuradas, curva da noite e mapa atualizando sozinhos a partir do coletor; para deputados, os dez mais votados de cada cidade e os acompanhados com o lugar real.
- Direto das urnas: leitura dos boletins de urna publicados antes da totalização, decodificados do ASN.1 com a especificação do TSE.
- Aba Abstenção: abstenção por grupo (idade, gênero, escolaridade, estado civil, voto obrigatório ou facultativo, deficiência) do Brasil à zona, e o total até a urna, em 2014, 2018, 2022 e 2026.
- Relatório final por candidato, com exportação em PDF e CSV, e seis relatórios bilíngues (PT/EN) publicados como páginas estáticas com senha para a equipe e parceiros.
- Administração: usuários (criar, trocar senha, desativar), links de acompanhamento por equipe com validade e contagem de aberturas, e logs de login, atividade, exportações, importações e ações do admin.
- Um modelo territorial só, em 8 níveis, para todas as eleições: 700.822 territórios e 13 milhões de linhas de resultado numa tabela particionada por nível, com a chave começando pelo código do território e CLUSTER depois de cada carga.
- Coletor da apuração com ETag/304, pausa coordenada em 403/429/503, duas fases por rodada (placar em segundos, cidades depois), cada JSON guardado em gzip e modo de ensaio com rollback contra o simulador oficial.
- Boletim de urna lido direto do TSE: bu.dat em ASN.1 decodificado com a especificação oficial versionada no repositório.
- Links de equipe sem login presos a um candidato: cookie assinado + allowlist de rotas e parâmetros no middleware + conferência no banco a cada atualização do placar.
- RLS ligado e revoke all de anon/authenticated em todas as tabelas, funções e sequences; o navegador nunca fala com o Supabase.
- Cargas que param em coluna desconhecida e validação ao fim de toda carga (seção, local e bairro somam a zona); CPF e título de eleitor conferidos como ausentes do banco.
- eleicoes_de reescrita para usar o índice: 47 s → 0,03 s.
04Arquitetura
Ler o diagrama como lista (26 componentes, 26 conexões)
Componentes
- Fontes públicas: TSE · dados abertos<br>ZIPs por seção (Latin-1, ';'), TSE · divulgação<br>JSON por BR/UF/cidade (ETag), TSE · boletim de urna<br>bu.dat em ASN.1, IBGE · malhas<br>TopoJSON
- Servidor Linux próprio (coleta e cargas): baixar_* .py<br>downloads retomáveis, carregar_* .py<br>psycopg 3 + DuckDB<br>validar_territorio.py, coletar_apuracao.py<br>timer systemd · 60 s · ETag/304<br>pausa em 403/429/503, coletar_bu.py<br>asn1tools · spec bu.asn1, vigiar_abertos_2026.py<br>timer 5 min dia / 30 min noite, gerar_malhas.py<br>IBGE → códigos TSE
- Supabase Postgres · schema tse: territorio (8 níveis)<br>br → regiao → uf → municipio<br>→ zona → local → secao · bairro, resultado<br>particionada por nível (6)<br>+ territorio_total, funções SQL/plpgsql<br>explorar · locais_disputa<br>abstencao_filhos · trajetoria, usuario · link_acesso<br>log_evento · etl_execucao, RLS em toda tabela<br>revoke all anon/authenticated<br>sem CPF/título
- Next.js 16 · React 19 (SSR + ISR): proxy.ts<br>cookie HMAC-SHA256 · timingSafeEqual<br>allowlist dos links de equipe, 20 rotas /api<br>allowlist de parâmetros<br>gzip + cache em memória, 18 páginas<br>ficha · explorador · apuração<br>comparar · abstenção · logs, mapa em canvas<br>d3-geo + topojson-client
- Hospedagem: Vercel (gru1)<br>transaction pooler · DB_PREPARE=0, Servidor próprio<br>systemd user · só na VPN
- Relatórios estáticos: pipeline DuckDB → JSON/binário, páginas PT/EN na Vercel<br>middleware com senha em env
Conexões
- TSE · dados abertos<br>ZIPs por seção (Latin-1, ';') → baixar_* .py<br>downloads retomáveis
- baixar_* .py<br>downloads retomáveis → carregar_* .py<br>psycopg 3 + DuckDB<br>validar_territorio.py
- carregar_* .py<br>psycopg 3 + DuckDB<br>validar_territorio.py → resultado<br>particionada por nível (6)<br>+ territorio_total
- TSE · dados abertos<br>ZIPs por seção (Latin-1, ';') → vigiar_abertos_2026.py<br>timer 5 min dia / 30 min noite
- vigiar_abertos_2026.py<br>timer 5 min dia / 30 min noite → carregar_* .py<br>psycopg 3 + DuckDB<br>validar_territorio.py
- TSE · divulgação<br>JSON por BR/UF/cidade (ETag) → coletar_apuracao.py<br>timer systemd · 60 s · ETag/304<br>pausa em 403/429/503
- coletar_apuracao.py<br>timer systemd · 60 s · ETag/304<br>pausa em 403/429/503 → resultado<br>particionada por nível (6)<br>+ territorio_total
- TSE · boletim de urna<br>bu.dat em ASN.1 → coletar_bu.py<br>asn1tools · spec bu.asn1
- coletar_bu.py<br>asn1tools · spec bu.asn1 → resultado<br>particionada por nível (6)<br>+ territorio_total
- IBGE · malhas<br>TopoJSON → gerar_malhas.py<br>IBGE → códigos TSE
- gerar_malhas.py<br>IBGE → códigos TSE → mapa em canvas<br>d3-geo + topojson-client
- carregar_* .py<br>psycopg 3 + DuckDB<br>validar_territorio.py → territorio (8 níveis)<br>br → regiao → uf → municipio<br>→ zona → local → secao · bairro
- territorio (8 níveis)<br>br → regiao → uf → municipio<br>→ zona → local → secao · bairro → resultado<br>particionada por nível (6)<br>+ territorio_total
- resultado<br>particionada por nível (6)<br>+ territorio_total → funções SQL/plpgsql<br>explorar · locais_disputa<br>abstencao_filhos · trajetoria
- funções SQL/plpgsql<br>explorar · locais_disputa<br>abstencao_filhos · trajetoria → 20 rotas /api<br>allowlist de parâmetros<br>gzip + cache em memória
- usuario · link_acesso<br>log_evento · etl_execucao → proxy.ts<br>cookie HMAC-SHA256 · timingSafeEqual<br>allowlist dos links de equipe
- proxy.ts<br>cookie HMAC-SHA256 · timingSafeEqual<br>allowlist dos links de equipe → 20 rotas /api<br>allowlist de parâmetros<br>gzip + cache em memória
- 20 rotas /api<br>allowlist de parâmetros<br>gzip + cache em memória → 18 páginas<br>ficha · explorador · apuração<br>comparar · abstenção · logs
- 18 páginas<br>ficha · explorador · apuração<br>comparar · abstenção · logs → mapa em canvas<br>d3-geo + topojson-client
- SITE → Vercel (gru1)<br>transaction pooler · DB_PREPARE=0
- SITE → Servidor próprio<br>systemd user · só na VPN
- Equipe<br>login → proxy.ts<br>cookie HMAC-SHA256 · timingSafeEqual<br>allowlist dos links de equipe
- Link de equipe<br>sem login → proxy.ts<br>cookie HMAC-SHA256 · timingSafeEqual<br>allowlist dos links de equipe
- Admin → proxy.ts<br>cookie HMAC-SHA256 · timingSafeEqual<br>allowlist dos links de equipe
- resultado<br>particionada por nível (6)<br>+ territorio_total → pipeline DuckDB → JSON/binário
- pipeline DuckDB → JSON/binário → páginas PT/EN na Vercel<br>middleware com senha em env
O sistema tem três camadas físicas: um servidor Linux próprio que fala com o TSE (do computador de desenvolvimento o TSE responde 403), o Postgres no Supabase como banco de publicação, e o site Next.js, que lê o banco só pelo servidor.
Pontos de decisão que o diagrama resume:
- Coleta separada da publicação. O servidor próprio baixa, valida e carrega; o Supabase só publica. Cargas grandes rodam em transações separadas e, depois de recarregar seções, o processo roda
CLUSTERpela chave do território eVACUUM ANALYZE, porque a ordem física é o que deixa o explorador rápido. - Um modelo territorial só. Toda eleição (2018, 2020, 2022, 2024, 2026) entra na mesma tabela
tse.resultado, particionada por nível, com o código do território como primeiro campo da chave. Comparar anos vira uma consulta sobre a mesma estrutura. - Site sem acesso direto ao banco pelo navegador. Nenhuma chave do Supabase vai para o cliente. As páginas e as rotas de API usam a conexão do servidor; o navegador só recebe JSON compacto.
05Por dentro
Modelo territorial. A tabela tse.territorio guarda todo lugar onde se conta voto, em oito níveis (br, regiao, uf, municipio, zona, bairro, local, secao), com um código por nível desenhado para busca por prefixo (collate "C"): mun:zona, mun:BAIRRO, mun:zona:local, mun:zona:secao. Segundo a documentação do modelo (03/10), são 700.822 territórios. tse.resultado é particionada por nível em seis partições (agregados, município, zona, bairro, local, seção), com 13 milhões de linhas reais na mesma data; tse.territorio_total guarda os denominadores (aptos, comparecimento, válidos, brancos, nulos) por território, cargo, ano e turno.
Funções de leitura. O site não monta SQL por conta própria para o explorador: chama funções no banco. tse.explorar devolve os filhos de um território com votos, lugar, principal adversário e totais, e, com os parâmetros p_cmp_*, o mesmo território em outro resultado para a aba Comparação. tse.locais_disputa lista todos os candidatos de um cargo num território; tse.abstencao_filhos faz o mesmo com a abstenção por grupo. As funções que recebem o nível como parâmetro rodam com plan_cache_mode = force_custom_plan, porque o plano genérico não poda as partições.
Migrations. 26 arquivos SQL aplicados em ordem (2.097 linhas), com DDL, funções e comentários em cada coluna. A migration 011 registra uma decisão de escopo: o banco de publicação ficou só com presidente, governador e senador, mais os deputados acompanhados; bens, financiamento, pesquisas e perfil do eleitorado saíram, com backup antes do corte.
ETL em Python. 26 scripts ativos em etl/ (psycopg 3 e DuckDB), rodando no servidor próprio:
baixar_*: downloads retomáveis dos ZIPs do portal.carregar_territorio.pyecarregar_secao_ano.py: carga de um ano inteiro a partir dos arquivos por seção. A lista de colunas que a carga lê é fixa: se o TSE renomear uma, a carga para em vez de adaptar em silêncio.validar_territorio.py: ao fim de toda carga, confere que seção, local e bairro somam a zona, que nenhum território tem votos válidos acima dos válidos e que nenhum fica sem total.coletar_apuracao.py: o coletor da noite da eleição (detalhe em Desafios técnicos).coletar_bu.py: boletins de urna, decodificados de ASN.1 comasn1toolse a especificação oficial versionada emetl/spec/2026/bu.asn1, gravados emtse.bu_secao.vigiar_abertos_2026.py: monitor dos dados abertos de 2026, que detecta a publicação de arquivos novos e dispara a carga sozinho.
Agendamento. Seis unidades systemd de usuário versionadas em servidor/systemd/: um timer liga o coletor dez minutos antes do início da divulgação, outro apaga os dados de simulação antes da apuração real (o coletor se recusa a gravar enquanto houver simulação marcada no banco), e um terceiro roda o monitor a cada 5 minutos de dia e 30 de madrugada.
Rastreabilidade. Toda carga registra início, fim, linhas, erros e um detalhe em tse.etl_execucao, inclusive a lista de territórios que ela criou. A regra do projeto é nunca apagar território "vazio" por critério genérico, só o que a própria carga anotou que criou.
Next.js 16 com React 19 e TypeScript, no App Router: 18 páginas, 29 route handlers (20 deles sob /api), 28 componentes e 26 módulos em lib/. Dependências de runtime são poucas: postgres (cliente do banco), d3-geo e topojson-client para o mapa, e server-only para impedir que módulos do servidor sejam importados no cliente.
- Mapa em canvas. As malhas do IBGE (TopoJSON, qualidade mínima) são convertidas por
scripts/gerar_malhas.py, que troca os códigos do IBGE pelos do TSE e descarta o que não tem correspondência. O site serve 27 arquivos por estado mais os de regiões e UFs (4,7 MB no total) e desenha em canvas comd3-geo, lendo as cores dos tokens CSS porgetComputedStyle, para o mesmo mapa funcionar nos temas claro e escuro. - Respostas compactas. A rota
/api/territoriodevolve os nomes dos campos uma vez e uma lista por linha, comprime com gzip no próprio handler (o servidor do Next não comprime rotas de API) e guarda o resultado num cache em memória com TTL de 6 horas para anos fechados e 60 segundos para 2026. - ISR na ficha. A página do candidato é regenerada a cada 10 minutos; páginas que dependem do usuário (logs, links, conta) são dinâmicas.
- Apuração ao vivo com polling que cancela corretamente ao trocar de território, e placar no padrão das emissoras.
- Reforma visual (07/10): barra lateral que abre ao passar o mouse e fixa com um clique, tema claro e escuro por tokens, quatro fontes carregadas por
next/font(Newsreader nos títulos, Source Sans 3 no texto e nos números tabulares, Martian Mono nos dígitos da urna, Saira Condensed no palco do comparador), componentes compartilhados (painéis sem sombra, cabeçalho de página único) e movimento com tokens--dur-*e--ease. - Exportação em PDF e CSV a partir da própria tela, com o evento registrado nos logs por
sendBeacon.
| Peça | Como |
|---|---|
| Servidor próprio | Ubuntu, Python 3.14 em venv, acessível só pela VPN (Tailscale). Roda cargas, coletores e os timers systemd de usuário. Também serve uma cópia do site como serviço systemd na porta interna. |
| Banco | Supabase Postgres (plano Pro), schema tse. Session pooler no servidor próprio; transaction pooler na Vercel, com DB_PREPARE=0 e DB_MAX=10. |
| Site | Vercel, região gru1 (São Paulo), framework Next.js. O vercel.json fixa a região; poweredByHeader desligado. |
| Deploy no servidor próprio | admin/deploy.sh: rsync, npm install, build com as credenciais carregadas do ambiente, reescrita da unidade systemd e espera ativa pelo HTTP 200. Se o build falhar, o serviço não é reiniciado. |
| Relatórios | Sete projetos estáticos na Vercel, cada um com middleware.js de senha e vercel.json com noindex e no-store; desligados do GitHub depois do primeiro deploy. |
| Código | GitHub privado, branch única, commits pequenos em português. |
Regras aprendidas e documentadas no repositório: processo longo sempre com nohup e log, porque a sessão SSH cai; nunca descompactar arquivo grande no /tmp do servidor (é memória); no máximo 4 conexões ao TSE para boletins de urna e nunca junto com o coletor da apuração, porque o TSE devolve 429.
06Segurança
8 ataques considerados, 8 defesas em produção.
Pular a interface e falar direto com o banco ou a API, com a chave pública na mão.
Ler as tabelas direto pela API pública do Supabase com a chave anon
RLS ligado em todas as tabelas do schema e revoke all de anon e authenticated em tabelas, funções e sequences; sem nenhuma política, esses papéis não leem nada. O site lê só pelo servidor, com a URL do pooler em variável de ambiente
Força bruta, criação de contas indevidas, redefinição de senha e tomada de conta.
Continuar usando uma sessão depois de a senha ser trocada ou a conta desativada
A versão do usuário entra no cookie e sobe a cada troca de senha ou desativação; as páginas conferem no banco que o usuário existe, está ativo e tem a mesma versão
Força bruta ou enumeração de e-mails no login
6 erros em 15 min bloqueiam por 15 min, por e-mail e por endereço; 800 ms de espera a cada erro; e-mail inexistente e senha errada dão a mesma mensagem; senhas só como scrypt (N=16384, sal de 16 bytes)
Quem tem algum acesso tentando ganhar mais: virar admin, ler o que não deve, manter acesso revogado.
Usar um link de equipe para navegar o painel inteiro ou outro candidato
Código de 18 bytes aleatórios (144 bits) validado por regex antes do banco; o cookie do link é assinado e preso a um candidato e cargo; o middleware só libera a página de acompanhamento, as fotos e as consultas daquele candidato em 2026, parâmetro por parâmetro; o resto responde 403; o placar reconfere o link no banco a cada atualização
CSRF, webhooks falsos, tokens reaproveitados, links assinados e redirecionamento aberto.
Forjar ou alterar o cookie de sessão
Cookie id.versao.validade.assinatura assinado com HMAC-SHA256 por segredo de ambiente e comparado com timingSafeEqual; httpOnly, sameSite=lax, secure em produção, 14 dias
Redirecionar a pessoa para outro site depois do login (open redirect)
O parâmetro de retorno só é aceito se começar com / e não com //; senão, a pessoa volta para a página inicial
XSS, iframe, fórmula em CSV, upload disfarçado e manipulação do prompt da IA.
Injetar SQL ou parâmetros inesperados nas rotas de API
Toda consulta passa pelos tagged templates do postgres.js (parametrizada); anos, turnos, cargos e níveis vêm de listas fechadas e códigos e identificadores de expressões regulares; o que não bate responde 400 antes de tocar o banco
Enumerar quem está na base, raspar dados pessoais, ligar perguntas a pessoas, extrair segredos.
Vazar CPF ou título de eleitor no banco de publicação
Regra do projeto e script de validação que confere que nenhuma ficha JSONB tem essas chaves, que nenhuma coluna do schema tem esse nome e que anon não enxerga o schema
Perímetro. Todo o site exige login. O proxy.ts (middleware do Next) intercepta tudo que não é arquivo estático e só deixa passar quem tem um cookie de sessão válido ou um cookie de link de equipe válido. Rotas de API sem sessão respondem 401 em JSON; páginas redirecionam para /entrar com o destino em volta=, que só aceita caminhos começando com / e não com // (sem open redirect).
Sessão. O cookie raiox_sessao carrega id.versao.validade.assinatura, assinado com HMAC-SHA256 por um segredo de ambiente (SESSAO_SEGREDO) e comparado com timingSafeEqual. A verificação da assinatura acontece no middleware sem tocar o banco; quem é o usuário, se continua ativo e se é admin, as páginas conferem no banco. A versao entra no cookie e sobe quando a senha é trocada ou a conta é desativada, o que derruba as sessões abertas. Cookie httpOnly, sameSite=lax, secure em produção, 14 dias.
Senhas. Só como hash scrypt (N=16384, r=8, p=1, sal de 16 bytes, 64 bytes de saída), com a senha normalizada em NFKC antes do hash, mínimo de 8 caracteres. O mesmo algoritmo está no script de linha de comando que cria o primeiro admin.
Força bruta no login. Seis erros em 15 minutos bloqueiam por 15 minutos, contados por e-mail e por endereço; cada erro espera 800 ms antes de responder; e-mail sem cadastro e senha errada dão a mesma mensagem na tela (o motivo real vai para o log). Tentativas bloqueadas são registradas no máximo uma vez por minuto por chave, para um robô não encher a tabela de logs.
Links de acompanhamento. O admin cria um link por equipe (/l/<código>), com código de 18 bytes aleatórios em base64url, validade e rótulo. Abrir o link grava um cookie separado (raiox_link), assinado do mesmo jeito e preso a um candidato e a um cargo. O middleware tem uma allowlist explícita do que esse cookie libera: a página /acompanhar, as fotos e só as consultas que a apuração daquele candidato faz, com os parâmetros conferidos um a um (o sq tem de ser o do candidato, o ano tem de ser 2026, o cargo tem de ser o dele). Qualquer outra rota responde 403. O placar confere no banco a cada atualização se o link continua ativo, então desativar corta em segundos. Códigos recusados vão para o log no máximo 10 vezes por hora por endereço.
Banco. Todas as tabelas do schema tse têm RLS ligado e revoke all dos papéis anon e authenticated, assim como as funções e as sequences; sem política alguma, esses papéis não leem nada pela API do Supabase. O site lê exclusivamente pelo servidor, com a URL do pooler em variável de ambiente, e usa os tagged templates do cliente postgres, que parametrizam toda consulta. Nas rotas de API, os parâmetros passam por allowlists antes de chegar ao SQL: anos e cargos numa lista fechada, nível numa lista fechada, códigos e identificadores por expressão regular; o que não bate responde 400.
Dados pessoais (LGPD). CPF e título de eleitor nunca entram no Supabase: o script validar_candidaturas.py confere que nenhuma ficha em JSONB contém essas chaves e que nenhuma coluna do schema tem esse nome, e confirma que anon não enxerga o schema. O log de eventos grava e-mail, IP e navegador para auditoria do painel, nunca senha. Os testes apagam os próprios eventos ao fim.
Segredos. Credenciais só em variáveis de ambiente (arquivos .env fora do git no servidor; variáveis na Vercel, as de senha marcadas como sensíveis). O repositório tem a regra escrita de que senha nunca vai para .md, mensagem de commit ou ferramenta de registro.
Abuso das APIs internas. O endpoint que recebe os eventos de atividade do navegador exige sessão, aceita só caminhos começando com / e limita a 120 avisos por minuto por pessoa. Os relatórios estáticos ficam atrás de um middleware na borda que compara a senha com a variável de ambiente, grava um cookie httpOnly e Secure e responde 503 se a variável não existir (falha fechada).
Hardening operacional. O coletor da apuração se recusa a gravar no ambiente oficial enquanto houver simulação marcada no banco. As cargas param em coluna desconhecida ou código novo do TSE. Gravar log nunca derruba a requisição (o erro vai só para o console). Apagar em tabelas grandes sempre com a chave inteira.
07Desafios técnicos
Reconciliar o território do TSE
O arquivo de votos por seção e o de totais por seção às vezes discordam do local de uma seção (seção agregada, mudança de local entre turnos, linhas repetidas). A regra adotada foi que vale o local onde os votos foram registrados, e os totais são ligados linha a linha por casar_locais: primeiro os locais iguais nos dois arquivos; se sobrar exatamente um de cada lado, eles se casam; senão, o local cuja soma de votos é igual aos nominais. Zonas e bairros não têm contorno oficial, então no mapa são círculos no centro dos locais de votação, dentro do contorno da cidade; coordenadas de local só valem dentro da caixa do contorno do município no IBGE. A validação ao fim de cada carga é o que dá confiança para descer até a seção.
Coletar a apuração sem derrubar nem ser derrubado
O coletor lê os arquivos de situação do TSE e baixa só o que mudou, usando ETag (o TSE responde 304 quando o arquivo não mudou). Se o TSE recusar (403, 429 ou 503), todas as conexões esperam juntas e o ritmo cai, em vez de insistir arquivo por arquivo. A rodada tem duas fases: Brasil e estados primeiro (poucos arquivos, o placar atualiza em segundos), cidades depois, com um teto por rodada. Cada JSON novo é guardado em gzip para conferência ou reprocessamento, e o modo --ensaio roda tudo contra o simulado oficial e desfaz a gravação com rollback. Mesmo assim, na noite da eleição o coletor encerrou dizendo "completo" com cidades faltando; a conferência da soma das cidades contra o estado por cargo virou procedimento obrigatório e foi documentada, com a recoleta.
Fazer o explorador responder rápido sobre dezenas de milhões de linhas
A chave primária de tse.resultado começa pelo código do território, as partições são por nível e as tabelas são reorganizadas fisicamente (CLUSTER) depois de cada carga grande. As funções de leitura rodam com plano custom forçado, porque o plano genérico não podava as partições. No site, a resposta vai comprimida e cacheada em memória com TTL por ano. Um caso concreto registrado no histórico: a função eleicoes_de, usada no Buscar locais, passou de 47 segundos para 0,03 segundo ao ser reescrita para usar o índice.
Ler o boletim de urna
O TSE publica o bu.dat de cada urna em ASN.1 assim que ela é recebida, antes da totalização. A solução foi versionar a especificação oficial no repositório e decodificar com asn1tools, em dois passos (envelope genérico e depois o boletim), gravando os votos por cargo em JSONB. O limite de conexões simultâneas ao TSE (4) foi aprendido na prática, quando 28 conexões derrubaram uma rodada do coletor da apuração.
08Resultados
Só o que o repositório e a documentação comprovam:
| Medida | Valor | Fonte |
|---|---|---|
| Commits | 148 em 9 dias (29/09 a 07/10/2026) | git log |
| Migrations SQL | 26 arquivos, 2.097 linhas | ls sql, wc -l |
| Territórios no modelo | 700.822 | docs/MODELO.md (03/10) |
Linhas em tse.resultado |
13,0 milhões reais | docs/MODELO.md (03/10) |
| Urnas de 2026 por seção | 497.897 | CHANGELOG.md (Relatório 4) |
| Banco | ~9,3 GB | docs/ESTADO-E-PLANO.md (07/10) |
| Apuração do 1º turno | coletada a 100% na noite de 04/10 | CHANGELOG.md, docs/ESTADO-E-PLANO.md |
eleicoes_de |
47 s → 0,03 s | commit a479de9 |
| Relatórios publicados | 6 relatórios + 1 painel, PT/EN | relatorios/README.md |
- 148
- commits
- 9 dias
- período ativo
- 26
- migrations SQL
- 2.097
- linhas SQL
- 11
- funções de banco vivas
- 6
- partições de resultado
- 0 (deny-all)
- políticas RLS
- 700.822
- territórios
- 13,0 mi
- linhas de resultado
- 497.897
- urnas de 2026
- ~9,3 GB
- banco
- 18
- páginas
- 29 (20 em /api)
- route handlers
- 28
- componentes React
- 26
- scripts ETL Python
- 6 (3 timers, 3 services)
- unidades systemd
- 27 UFs + regiões + UFs, 4,7 MB
- malhas do mapa
- 9.328
- linhas TypeScript/TSX
- 6.259
- linhas Python
- 6 + 1 painel
- relatórios publicados
como medimos
git log --oneline | wc -l
como medimos
git log: primeiro commit 2026-09-29, último 2026-10-07
como medimos
ls sql/*.sql
como medimos
wc -l sql/*.sql
como medimos
create function em sql/ menos as removidas em sql/011_corte.sql
como medimos
sql/009_territorio.sql (partition by list (nivel))
como medimos
grep 'create policy' sql/ = 0; RLS ligado + revoke all em todas as tabelas (sql/001, 009, 012…)
como medimos
docs/MODELO.md, tabela tse.territorio (03/10)
como medimos
docs/MODELO.md, tse.resultado linhas reais (03/10)
como medimos
CHANGELOG.md, base do Relatório 4
como medimos
docs/ESTADO-E-PLANO.md (07/10)
como medimos
git ls-files admin/src/app/**/page.tsx
como medimos
git ls-files admin/src/app/**/route.ts
como medimos
git ls-files admin/src/components
como medimos
git ls-files etl/*.py (sem etl/legado)
como medimos
servidor/systemd/
como medimos
ls admin/public/geo; du -sh
como medimos
wc -l de git ls-files '*.ts' '*.tsx'
como medimos
wc -l de git ls-files '*.py'
como medimos
relatorios/README.md
09Linha do tempo
- 29 set 2026
Estrutura do projeto, downloader retomável dos dados abertos do TSE, DDL do schema e carga de 20.062 candidaturas; primeiro site com busca e ficha
- 30 set 2026
Rota recalculada para o desempenho por território, sem inferência de perfil; modelo unificado do Brasil à seção, malhas do IBGE com códigos do TSE e corte do escopo do banco
- 01 out 2026
Prévia fechada na Vercel, comparação do 2º turno, comparar candidatos, buscar locais e abstenção por idade
- 02 out 2026
Login por usuário, apuração ao vivo e coletor ensaiado contra o simulador do TSE e agendado por timers systemd
- 03 out 2026
Links de acompanhamento por equipe, logs do admin e revisão para celular
- 04 out 2026
Dia da eleição; apuração coletada, boletins de urna decodificados do ASN.1, 2018 carregado e primeiro relatório publicado
- out 2026
05–06/10: 2026 por seção no banco, relatório final na ficha, monitor dos dados abertos, aba Abstenção, eleicoes_de de 47 s para 0,03 s e relatórios 2 a 5
- 07 out 2026
Reforma visual (barra lateral, tipografia, componentes, páginas) integrada e publicada; relatório 6
10Stack
- Next.js 16 (App Router, SSR, ISR)
- React 19
- TypeScript 5
- CSS com tokens (tema claro/escuro)
- next/font (Newsreader, Source Sans 3, Martian Mono, Saira Condensed)
- d3-geo + topojson-client em canvas
- Web Audio API
- Route handlers do Next.js (20 rotas /api)
- postgres.js (tagged templates)
- gzip no handler
- cache em memória com TTL
- server-only
- PostgreSQL (Supabase), schema tse
- 26 migrations SQL
- tabela particionada por nível (6 partições)
- funções plpgsql com force_custom_plan
- Python 3.14 (psycopg 3, DuckDB, asn1tools)
- CSV/JSON do TSE
- malhas TopoJSON do IBGE
- Parquet e binários compactos para os painéis
- Servidor Linux próprio (Ubuntu) via VPN
- systemd timers e serviços de usuário
- Vercel (gru1, transaction pooler)
- GitHub privado
- Chromium headless para capturas e PDFs
- Cookie HMAC-SHA256 com timingSafeEqual
- scrypt (N=16384)
- versão de sessão
- bloqueio por e-mail e IP
- allowlist de rotas para links de equipe
- RLS + revoke em todo o schema
- allowlist de parâmetros nas APIs
- logs de auditoria
- segredos só em ambiente
- checagem automática de ausência de CPF/título
11Ficha técnica
- type
- plataforma de dados + painel eleitoral ao vivo
- stack
- Next.js 16 · React 19 · TypeScript · Python 3.14
- db
- Postgres (Supabase) · 6 partições · RLS deny-all
- etl
- psycopg 3 · DuckDB · asn1tools · timers systemd
- auth
- cookie HMAC-SHA256 · scrypt · links de equipe
- deploy
- Vercel gru1 + servidor Linux próprio
- modules
- ficha · explorador · apuração · comparar · abstenção · logs
- status
- concluído
A plataforma que pôs milhares de criadores de conteúdo na campanha pelo fim das bets: cadastro nacional, contador público à prova de inflação e painel blindado contra força bruta.
Mobilização de voluntários com prazo legal e público hostil: toda regra vale no banco.
A plataforma da campanha pelo fim da escala 6x1: adesão nacional, rede de voluntários e defesa anti-bot em 7 camadas
Quer um sistema assim para a sua operação?
A Node projeta, constrói e protege plataformas sob medida para campanhas, mandatos e movimentos.

TECNOLOGIA E INTELIGÊNCIA POLÍTICA
© 2026 NODE. Todos os direitos reservados.