Pasta de entrada para importação de dados eleitorais do TSE
=============================================================

Esta pasta NÃO é alimentada automaticamente pelo sistema. O portal
https://dadosabertos.tse.jus.br não pôde ser acessado de forma
automatizada durante o desenvolvimento desta integração (bloqueio de
borda / HTTP 403 em toda tentativa, inclusive para apenas consultar
metadados) -- por isso a primeira versão do importador não baixa nada
sozinha.

Como usar:

1. Baixe manualmente, no Portal de Dados Abertos do TSE
   (https://dadosabertos.tse.jus.br), o pacote "Candidatos" ou
   "Resultados" do ano/eleição desejado.
2. Extraia o ZIP. Localize o CSV da UF desejada (ex:
   "consulta_cand_2024_AL.csv" ou "votacao_secao_2024_AL.csv" --
   o nome exato pode variar; confira o "leiame" que vem dentro do ZIP).
3. Copie esse arquivo .csv para dentro desta pasta
   (storage/tse_import/) via SFTP/FTP/acesso ao servidor.
4. Acesse Admin > Inteligência Eleitoral > Importar Dados TSE,
   selecione o arquivo na lista e importe.

Importe sempre "Candidatos" antes de "Votação por seção" da mesma
eleição -- o resultado é ligado ao candidato pelo identificador oficial
(SQ_CANDIDATO), então o candidato precisa existir primeiro.

Rodar a importação do mesmo arquivo mais de uma vez não duplica dado
(processo idempotente, via UPSERT nas chaves únicas do banco).

Esta pasta é bloqueada para acesso direto pelo navegador (ver
.htaccess ao lado) -- os arquivos aqui não ficam publicamente
acessíveis por URL.