# Metodologia da integração

## Unidade e escopo

A unidade eleitoral é a localidade municipal do TSE, identificada pela combinação UF e código TSE. A tabela contém 5.571 localidades, com Fernando de Noronha separadamente. Brasília representa a agregação eleitoral do DF. A comparação municipal exclui votos no exterior. O catálogo de mobilização contém 1.177 registros com IDs distintos; cada linha é um registro de agendamento, não uma confirmação de realização ou de evento único.

## Conferência dos votos de Lula

O arquivo municipal original foi confrontado com a soma da votação por seção eleitoral, para cargo Presidente (`CD_CARGO=1`), número 13 e `SQ_CANDIDATO=280002542548`, identificado na própria fonte como LUIZ INÁCIO LULA DA SILVA. Foram conferidas as 11.142 células de 5.571 localidades × dois turnos. Resultado: zero divergências, localidades faltantes ou extras. Os votos territoriais somam 53.722.151 no primeiro turno e 64.056.078 no segundo.

## Denominadores e percentuais

Os votos válidos são a soma do campo oficial `QT_VOTOS_NOMINAIS_VALIDOS` para Presidente, município e turno, no arquivo `votacao_candidato_munzona_2026_BR.csv`. O inventário contém 12 candidaturas no primeiro turno e duas no segundo, todas com destinação “Válido”. A classificação válida não foi inferida de `SQ_CANDIDATO` positivo.

A fonte por seção contém “VOTO BRANCO” (95), “VOTO NULO” (96) e 13 nomes no primeiro turno. O número 28, LEONARDO ALVES DE ARAUJO, SQ 280002554479, soma 5.246 votos nacionais (5.123 territoriais e 123 no exterior), mas está ausente do inventário de votos válidos da fonte munzona. Por isso esses votos não integram o denominador. Não se atribui motivo jurídico à diferença sem documentação específica. A soma nominal da fonte por seção, após excluir branco, nulo e número 28, coincide com `QT_VOTOS_NOMINAIS_VALIDOS` em todas as 11.431 células disponíveis, incluindo o exterior: zero divergências.

Denominadores territoriais: 118.969.906 no primeiro turno e 123.710.622 no segundo. Totais nacionais com exterior: 119.300.788 e 124.082.273. A fonte por seção foi gerada em 26/10/2026, 12:07:25; a fonte munzona em 29/10/2026, 12:31:46. A equivalência dos denominadores utilizados foi conferida apesar das datas diferentes.

`percent1 = 100 × votos1/validos1`; `percent2 = 100 × votos2/validos2`; `deltaPP = percent2 − percent1`, calculado antes do arredondamento. O delta é expresso em pontos percentuais. Os campos preservam oito casas decimais; a interface pode arredondar para apresentação. Para percentuais agregados de grupos, UF ou Brasil, deve-se somar os votos e válidos antes de dividir; a média simples das porcentagens municipais representa outro indicador e precisa ser identificada como tal.

## Tratamento geográfico dos registros

Normalizaram-se acentos, espaços e pontuação dos nomes para procurar correspondência exata com a mesma UF. Foram 1.145 registros exatos. Não se utilizou aproximação automática ou fuzzy matching.

Os 32 registros sem correspondência inicial foram tratados com log individual: 25 receberam ajuste; dois foram identificados no exterior; cinco ficaram pendentes. Os ajustes de grafia/abreviação incluem Pindamonhagaba→Pindamonhangaba, Beo Horizonte→Belo Horizonte, Paraupebas→Parauapebas, Olhos d’Água das Cunhãs→Olho d’Água das Cunhãs, Ponta das Pedras→Ponta de Pedras e Águas Lindas→Águas Lindas de Goiás. Endereços e nomes explícitos permitiram atribuir Vera Cruz, Porto Seguro, Conceição da Barra, Rio de Janeiro, Recife e Itaitinga. Gama e São Sebastião, regiões administrativas do DF, foram agregadas a Brasília.

Oito registros tinham `city=Se`, `state=SP`, mas endereços explicitavam municípios de Sergipe. Cada linha foi atribuída individualmente ao município descrito no endereço e à UF SE, preservando os campos originais. “Se” não foi mapeado para São Paulo. As atribuições foram São Cristóvão, Aracaju (três registros), Campo do Brito, Neópolis, Nossa Senhora do Socorro e Simão Dias.

Os registros de Oslo/Noruega e Brno/República Tcheca foram separados como exterior, preservando as UFs originais inconsistentes. Permaneceram sem atribuição Povoado Machado/AL, Lagoa Grande/MA, Miranda/MA, Aramina/AL e Rio Branco/SP, pois não há evidência suficiente para inferir o município/UF pretendidos. Seus registros continuam no catálogo e nos downloads.

## Tempo, contagem e possíveis repetições

O recorte inicial de comparação é de 13/10 a 24/10/2026, inclusive, por data local agendada. Dos 1.177 registros, 1.176 caem no intervalo. Após retirar do cruzamento municipal os dois exteriores e cinco pendentes, restam 1.169 registros em 609 municípios. O registro de 29/10 é preservado no catálogo e excluído do recorte pré-voto. `incluidoComparacao` combina o intervalo e a atribuição municipal segura.

Verificou-se repetição exata na chave cidade original + UF original + data + hora + local, removendo apenas espaços das extremidades. Resultado: zero grupos exatos. Isso não garante ausência de duplicações semânticas: grafias, horários ou descrições diferentes podem representar o mesmo agendamento. Nenhuma linha foi removida. Filtros e somas devem contar registros e apresentar esse nome.

## Limites da comparação

“Sem registro na base” representa ausência de registro neste arquivo, não ausência real de atos. A cobertura de fontes pode variar entre municípios. Agendamento não comprova realização, adesão ou público. Contagens de registros não medem exposição individual. Votação municipal não permite inferir comportamento das pessoas que participaram de mobilizações. Diferenças entre grupos são descritivas, sujeitas a composição territorial e seleção de municípios; não estimam efeitos causais. As datas e textos do arquivo de atos foram preservados, sem auditoria externa de realização.

## Reprodutibilidade

`auditoria_integracao.json` inclui hashes SHA-256 dos insumos, inventários de votáveis, totais, versões das fontes, pendências, ajustes e conferências. Os arquivos leves originais acompanham o pacote. Os ZIPs oficiais grandes são referenciados por URL e hash. A geografia foi tratada por regras explícitas e log individual, sem exclusão silenciosa de registros.


## Complemento estatístico da versão 1.2.0

A participação eleitoral e as correlações estão documentadas em `metodologia_extra.md` e `metodologia_correlacoes.md`. Nulos técnicos foram conferidos com as contagens por seção, sem atribuição de motivo jurídico. Ver os relatórios complementares e o dicionário estatístico.


Autoria do painel e da integração: Arthur José Sales Aguiar Paixão e Guilherme Marques · LabHD UFOP · 2026.
