Voto Aberto

Os registros oficiais da Câmara dos Deputados são abertos, mas difíceis de consultar: cerca de 1 GB de arquivos anuais mais uma API REST, com vocabulário próprio. O Voto Aberto os torna pesquisáveis e compreensíveis, sempre com link para a fonte oficial em cada dado.

Um processo Node e um arquivo de banco: não há fila, cache externo nem serviço separado de API.

• Página por votação nominal, com a pergunta votada, o resultado oficial, o placar e a orientação das bancadas.
• Perfil de cada deputado, com histórico de votações filtrável, propostas, mandato, comissões e despesas.
• Comparação de dois a quatro deputados lado a lado, com a lista das votações usadas em cada cálculo.
• Propostas com a etapa atual em linguagem simples: centenas de situações oficiais agrupadas em nove etapas.
• Busca única por deputados, propostas e votações, usando o FTS5 do SQLite.

A sincronização grava no banco com upsert pela chave oficial e as páginas leem o banco diretamente. Só tramitação, comissões e despesas são buscadas na Câmara sob demanda, com cache.

• Banco vazio: carga inicial em 227 s, cerca de 1 GB baixado, banco de 265 MB.
• Banco carregado: rodada incremental de 10 a 14 s, sem baixar arquivos.
• Reconciliação: reconfere os arquivos anuais depois de 30 dias sem conferir ou 60 sem sincronizar.

• Regras de negócio isoladas: funções puras em src/domain/, sem banco, HTTP ou React. A ausência de voto nunca é tratada como falta física, e indicadores sem base de cálculo devolvem "sem dado", não zero.
• Camadas verificadas pelo lint: cada pasta só importa de uma lista fixa de outras; uma importação fora dela quebra o npm run lint e o CI.
• Sincronização incremental e idempotente: toda gravação é upsert pela chave oficial, então reprocessar não duplica.
• Tolerância a falhas da fonte: downloads cortados são retomados com Range, registros inválidos são contados (não "consertados") e uma resposta vazia nunca apaga dados já gravados.

A base reúne 648 deputados da 57ª legislatura, 1.597 votações nominais, 471.978 votos individuais e 94.480 proposições. O projeto tem 232 testes automatizados, 94% de cobertura fora da interface e um teste de ponta a ponta que roda a sincronização inteira contra uma Câmara simulada, offline.