Metodologia

Escopo

A ferramenta permite informar votos hipotéticos para Presidente, Governador, Senador, Deputado Federal e Deputado Estadual. A soma dos campos é limitada pelo eleitorado apto disponibilizado para a abrangência. No Senado 2026, o eleitor pode registrar duas escolhas para candidatos diferentes: a capacidade máxima é o eleitorado apto multiplicado por dois, mas cada candidato individual permanece limitado ao eleitorado apto.

Os votos brancos, nulos e indecisos/abstenções respeitam o teto de preenchimento, mas não integram os votos válidos usados na distribuição proporcional.

Motor matemático

Presidente e Governador usam maioria absoluta dos votos válidos e podem indicar segundo turno. O Senado 2026 é uma exceção: são duas vagas por unidade federativa, os dois candidatos mais votados no ranking único são eleitos por maioria simples e não existe maioria absoluta, 50% + 1 ou segundo turno para essa disputa.

No Senado, abstenções são unidades de eleitores e reduzem os slots disponíveis; brancos e nulos são escolhas sem candidatura nominal e entram na capacidade global. O card e os relatórios exibem dois percentuais: votos nominais sobre a soma nominal dos candidatos e eleitores aptos sobre o eleitorado oficial. A soma do segundo pode ultrapassar 100% porque há duas escolhas por eleitor. A regra pedagógica da interface referencia a Resolução TSE nº 23.751/2026, art. 206, §2º.

Nos cargos proporcionais, o Quociente Eleitoral segue a regra normativa: fração igual ou inferior a 0,5 é desprezada e fração superior a 0,5 é elevada. O Quociente Partidário é calculado pela entidade proporcional — partido não federado ou federação — dividida pelo QE, mas cada vaga do QP só é ocupada quando há candidatura que atinja 10% do QE. Nas sobras do art. 11, a primeira etapa aplica 80% do QE para a entidade e 20% para a candidatura; esgotada essa etapa, o §4º do art. 11 permite a participação de todas as entidades sem transportar as barreiras anteriores. O art. 12-A é tratado separadamente como hipótese específica em que nenhum partido ou federação alcança o QE, com sequência própria.

As médias são comparadas exatamente. Em empate, prevalece a maior votação total da entidade; persistindo, a maior votação nominal da candidatura que disputa a vaga; dentro da mesma entidade, a maior idade.

Partidos que pertencem à mesma federação são tratados como uma entidade proporcional única para os cálculos de votos e sobras. A distribuição não cria uma afirmação sobre o resultado oficial do pleito.

Fontes e limitações

Os dados cadastrais e de eleitorado são derivados de bases abertas do Tribunal Superior Eleitoral, com indicação do ano, abrangência, cargo, data da base e data de compilação nos caches e relatórios.

As bases históricas de 2018 e 2022 aparecem como referência comparativa visual e, nos cargos proporcionais, podem alimentar o gerador de cenário fictício. O ETL informa separadamente se a candidatura foi localizada (MATCHED), não localizada (NOT_LOCATED) ou se o vínculo potencial foi rejeitado por ambiguidade (AMBIGUOUS). Na tela, ausência de candidatura histórica aparece como N/C, não como zero de votação.

Pesos de referência

O gerador de cenário fictício pode usar um catálogo estático local de pesquisas registradas, materializado em public/data/referencias_pesquisas/. O catálogo não é consultado por scraping em runtime e não recebe votos digitados, cenários salvos, preferências ou dados de usuários.

Quando elegíveis, as referências mais recentes por instituto formam uma âncora matemática agregada. O navegador cruza os nomes por ID TSE, alias explícito ou nome normalizado exato, combina os percentuais casados com um fallback sintético pequeno e aplica alocação inteira com variação controlada. O resultado não reproduz a pesquisa, não mede intenção de voto e não antecipa resultado eleitoral. No Senado, o campo obrigatório senate_percentage_semantics deve usar um enum conhecido — share_of_choices_normalized_100, share_of_electors_up_to_200, first_choice_only ou second_choice_only — e os percentuais são tratados conforme essa semântica.

Para Deputado Federal e Deputado Estadual, o botão Gerar cenário fictício — base histórica não usa catálogo de pesquisas. Ele calcula uma BHR individual a partir dos votos TSE localizados em 2018 e 2022: média dos dois anos quando ambos existem, ou o único ano localizado. Candidaturas sem histórico recebem, quando a amostra existe, perfil P25, mediana ou P75, com pesos 50%, 35% e 15%, e distribuição triangular entre 50% e 130% da base. A normalização fecha o alvo dentro dos limites quando viável e sinaliza eventual relaxamento. Votos de legenda são gerados separadamente e continuam editáveis. Se não houver qualquer observação histórica, a interface informa indisponibilidade e oferece explicitamente Gerar aleatório puro.

O cartão da fonte exibe período da coleta, margem de erro, confiança, amostra, instituto/contratante, método e registro TSE. A referência Datafolha pendente não participa do gerador até publicação e verificação manual.