1. Objetivo e neutralidade
O site organiza dados públicos para facilitar pesquisa e comparação. Não recomenda candidaturas, não calcula um “melhor voto” e não usa pontuação secreta. Um resultado aparece porque corresponde aos filtros escolhidos pelo usuário.
A ideia de que alinhamento partidário pode facilitar articulação e governabilidade é um fator de análise, não uma regra. Competência, integridade, independência entre Poderes, diversidade e fiscalização continuam relevantes.
2. Fontes e data de corte
O pipeline lê os arquivos das Eleições 2026 do Portal de Dados Abertos do Tribunal Superior Eleitoral: candidaturas, dados complementares, grupos políticos, histórico, redes declaradas, fundamentos de julgamento, fotos, planos de governo e certidões anexadas.
O arquivo nacional BRASIL é usado uma única vez. Os recortes por UF repetem as mesmas linhas e não são somados. A data exibida na interface vem do próprio CSV.
3. Cargos e dados pessoais
O explorador mostra presidente, governador, senador, deputado federal, deputado estadual e deputado distrital. Vices e suplentes não são misturados a esses resultados.
CPF, título eleitoral, e-mail, protocolo e número de processo não entram nos JSONs públicos. Links sociais passam por validação de protocolo e deduplicação.
4. Bandeiras e propostas
Os anexos contêm planos sobretudo para presidente e governador. A síntese identifica temas por recorrência de palavras no texto extraído e preserva pequenos trechos como evidência. É uma classificação temática automática, não uma interpretação integral.
Para deputados e senadores, não existe campo de bandeiras nesses anexos. O site não atribui posição com base apenas em partido, ocupação ou perfil. Uma bandeira legislativa só deve ser publicada com declaração ou curadoria acompanhada de fonte.
Ausência de tema significa “não localizado nas fontes consultadas”, não falta de interesse pelo assunto.
5. Histórico eleitoral
O histórico reproduz candidaturas anteriores relacionadas pelo TSE, com ano, cargo, partido, UF e resultado quando disponível. Ausência no arquivo aparece como “histórico não localizado”, nunca como “primeira candidatura”.
6. Registro e julgamento
O nome técnico do pacote motivo_cassacao pode induzir ao erro. Na fotografia anexada, seus registros são fundamentos para julgamento ou indeferimento; o campo estruturado de cassação está vazio. O site usa “fundamento de julgamento” ou “ocorrência no registro” e não chama automaticamente ninguém de cassado. Renúncia também não é tratada como problema jurídico.
atenção no registro = candidaturas com situação adversa ou fundamento localizado ÷ candidaturas do grupo × 100Cada caso precisa ser lido individualmente, inclusive quando há recurso.
7. Certidões criminais
Muitos documentos são imagens e exigem OCR. O modelo separa documento não localizado, análise pendente, ausência explícita de ocorrência, apontamento e revisão manual. Resultado adverso automatizado não deve ser publicado sem validação humana.
incidência = candidaturas com apontamento validado ÷ candidaturas com certidão analisável × 100cobertura = candidaturas com certidão analisável ÷ candidaturas do grupo × 100Sem base revisada, a interface mostra “análise indisponível” em vez de inventar percentual.
8. Partidos, federações e coligações
São estruturas diferentes e preservadas separadamente. Partidos são organizações permanentes; federações unem partidos nacionalmente por pelo menos quatro anos e valem para eleições majoritárias e proporcionais; coligações são alianças temporárias, restritas a cargos majoritários e a uma circunscrição.
Uma candidatura majoritária pode exibir ao mesmo tempo a federação de seu partido e a coligação da chapa. O filtro corresponde a qualquer um desses vínculos e consolida registros equivalentes pelo nome e pela composição, sem expor IDs técnicos duplicados.
O guia de partidos e federações separa informações oficiais do TSE de sínteses editoriais. Classificações ideológicas não são rótulos do TSE, simplificam correntes internas e devem ser conferidas em estatutos, programas, propostas e atuação parlamentar.
9. Formação acadêmica
O cadastro de candidaturas do TSE informa o grau de instrução declarado, com categorias como “superior completo”. Ele não possui campos próprios para pós-graduação, mestrado ou doutorado.
superior completo = candidaturas com DS_GRAU_INSTRUCAO igual a SUPERIOR COMPLETOtitulação verificada = candidaturas com SIM para a titulaçãocobertura = candidaturas com SIM ou NÃO ÷ candidaturas do grupo × 100Pós-graduação, mestrado e doutorado só podem ser contados por meio de enriquecimento individual verificável, vinculado ao código da candidatura, com URL pública, título da fonte e data de conferência. A compilação rejeita fonte local ou privada, URL malformada, data futura, ID ausente e linha sem nenhuma alegação.
“Pós-graduação” é a categoria abrangente: mestrado ou doutorado confirmado também conta como pós-graduação, mas doutorado não implica mestrado. Fora dessa relação classificatória, valor ausente permanece “não disponível”; nunca vira zero nem é inferido por ocupação, biografia ou escolaridade genérica.
Na visão por federação, partidos federados são consolidados e legendas sem federação permanecem em linhas próprias. Os indicadores respeitam o recorte ativo e mostram quantas candidaturas têm fonte para cada título.
10. Filtros de características e histórico
Gênero, raça ou cor, escolaridade, ocupação e idade são dados declarados no registro eleitoral. Titulações avançadas podem ser filtradas somente quando há fonte individual verificada; “sem fonte verificada” não significa que o título não exista. A busca textual também percorre federação, coligação, formação, ocupação e registros eleitorais anteriores. Os filtros não devem ser interpretados como avaliação de mérito.
“Histórico anterior” exclui registros de 2026 e consolida repetições da mesma disputa por ano, cargo, UF e número. “Já eleito” reconhece somente resultados iniciados por “Eleito”, evitando confundir “Não eleito” com vitória.
Em “disputou por outro partido”, renomeações inequívocas não contam como troca: PMDB→MDB, PPS→Cidadania, PTN→Pode, PRB→Republicanos, SD→Solidariedade, PTdoB→Avante, PSDC→DC, PMN→Mobiliza, PTC→AGIR e PMB→Democrata. Fusões e incorporações continuam distintas. Ausência de registro continua significando “não localizado na base”.
11. Limitações
- planos oficiais não cobrem a maioria das candidaturas legislativas;
- muitas certidões são digitalizações sem texto;
- situações de registro mudam durante o calendário;
- link declarado não garante que continue ativo;
- ocorrência documental não mede caráter, competência ou qualidade de governo;
- percentuais nunca devem virar ranking de reputação;
- títulos acadêmicos avançados dependem de fonte individual e podem ter cobertura parcial.