Um painel de eleição pronto para milhões de pessoas

Três partes que só conversam por arquivos

A coleta fala com o TSE e grava arquivos. O contrato define o formato desses arquivos. O site só lê os arquivos e desenha a tela. Uma parte pode cair ou trocar de máquina sem mexer nas outras — foi o que aconteceu quando a operação inteira mudou para a VPS.

Do primeiro commit ao painel ao vivo: cerca de 37 horas

Tirado do histórico do repositório (git log), com noite de sono no meio. Tudo feito em sessões com o Claude Code; cada falha corrigida virou uma linha em FALHAS.md.

Por que aguenta milhões sem derrubar servidor

O segredo é não ter servidor nosso no caminho de quem visita.

A conta ESTIMATIVA

Cada pessoa com o painel aberto pede o manifesto a cada 15 segundos. Não foi testado com 1 milhão de pessoas reais: é quanto a borda precisa entregar.

Onde estão os limites de verdade

O custo não cresce com o número de visitantes

Na parte do painel, mais gente olhando não aumenta a conta. Só o chat e o contador têm custo por uso.

Uma VPS de reserva e a troca em um comando

Na noite da apuração, uma segunda máquina rodava tudo de verdade, pronta para assumir em minutos.

# na noite: mandar o tráfego para a VPS (sem --executar só mostra o que faria)
ferramentas/vps/trocar_dominios.sh vps --executar
# voltar para o Cloudflare
ferramentas/vps/trocar_dominios.sh volta --executar
# hoje (desde 26/10) a VPS é a principal; reinstalar a operação inteira:
ssh root@<IP-DA-VPS> 'cd /opt/eleicoes2026 && git pull && bash ferramentas/vps/operacao.sh --executar'

Em 26/10 os dados finais foram copiados para a VPS, as análises rodaram lá com resultado idêntico (conferido pela impressão digital sha256) e a máquina principal foi desligada. O site não saiu do ar.

O que deu a eficiência

Nada exótico: um punhado de decisões simples, aplicadas com disciplina.

1. Contrato primeiro. O formato dos arquivos foi escrito antes do código; coleta e site andaram em paralelo.
2. Separar quem coleta de quem mostra. O site nunca fala com o TSE; a coleta não sabe de tela.
3. Arquivo imutável + manifesto pequeno. Cache eterno no que não muda, consulta barata no que muda.
4. Perguntar "mudou?" ao TSE (ETag). Baixa só o estado que mudou.
5. Conferir antes de publicar. Soma que não fecha, voto que diminui, hora que volta: aquele estado não é publicado e fica o último valor válido.
6. Guardar o original com impressão digital (sha256). A página Conferência refaz as somas e confere a integridade de cada arquivo baixado.
7. Gravação atômica. Grava num arquivo temporário e troca de uma vez; ninguém lê arquivo pela metade.
8. Publicar só quando muda. O publicador compara uma assinatura dos dados; reiniciar não duplica nada.
9. Serviços com teto e horário. Reinício automático, limite de memória, timer para ligar às 17h e desligar as simulações às 16h, mesmo se a máquina reiniciar.
10. Ensaiar a noite. Simulação acelerada com nomes fictícios e um "TSE falso" com falhas de propósito.
11. Testar o modelo com dado antigo. A Projeção foi testada com dados de 2022 e com simulações: em 224 cenários, a faixa conteve o resultado final em 98,7%. É medido na mesma amostra que ajudou a definir a faixa, então não é garantia.
12. Reserva quente. A VPS rodou de verdade a noite toda, com outra série de versões.
13. Registro de falhas em uma linha. Exemplo da noite: o índice do TSE trazia o Brasil com a hora do exterior (16 horas no futuro) e o total não publicava; a correção foi ignorar hora no futuro.

Tudo aberto no repositório

O documento completo, com os detalhes técnicos e os nomes dos arquivos, está em ARQUITETURA.md.