Documentação: Limpeza Automática de Propostas Duplicadas (CPF)
1. Objetivo
Automatizar a identificação e remoção de posts duplicados no Custom Post Type (CPT) propostas. O critério de duplicidade é o campo de meta dado _cpf. O sistema deve manter sempre a versão mais recente e mover as anteriores para a lixeira.

2. Lógica de Funcionamento
O script executa os seguintes passos:

Busca Total: Consulta todos os posts do tipo propostas que possuem a chave _cpf.

Ordenação: A consulta é organizada por Data (Decrescente). Isso garante que o primeiro CPF encontrado em cada loop seja sempre o mais novo (o que deve ser preservado).

Comparação: O script armazena os CPFs já lidos em um "array de memória".

Ação: Se um CPF for lido e já existir no array, o post atual é identificado como duplicata antiga e enviado para a lixeira via wp_trash_post().

Log: Cada etapa e o resultado (quantidade de remoções) são registrados em um arquivo físico.

3. Componentes do Código
Agendamento (WP-Cron)
Foi criado um evento customizado no WordPress para garantir a autonomia do sistema.

Nome do Evento: limpeza_diaria_cpfs_duplicados

Recorrência: Diária (daily).

Dependência: O evento depende de acessos ao site para ser disparado (comportamento padrão do WP-Cron).

Monitoramento (Logs)
Os registros de execução são salvos no servidor para auditoria.

Caminho: /wp-content/uploads/log-limpeza-cpfs.txt

Conteúdo: Data, hora, início do processo e total de itens movidos para a lixeira.

4. Estrutura de Tabelas Afetadas
Abaixo, um diagrama do fluxo de dados que o código executa no banco de dados do WordPress:

5. Manutenção e Solução de Problemas
Como forçar uma execução manual?
Caso precise limpar o banco imediatamente sem esperar o cron:

Acesse Ferramentas > Eventos Cron (via plugin WP Control).

Procure por limpeza_diaria_cpfs_duplicados e clique em Executar Agora.

Por que o arquivo de log mostra caracteres estranhos?
Se você vir verificação, é apenas uma diferença de codificação (UTF-8 vs ANSI) do seu leitor de textos. O banco de dados e o funcionamento do código não são afetados por isso.

O que fazer se o log crescer demais?
Se daqui a alguns meses o arquivo de log estiver muito grande, você pode simplesmente deletá-lo via FTP. O sistema criará um novo automaticamente na próxima execução.

Dica de Segurança: Como agora o banco está limpo, se você notar que o número de duplicados continua subindo muito rápido, pode ser interessante revisarmos o formulário de entrada para validar o CPF antes mesmo do post ser criado.