DataFirefly Specific Price Cleaner: limpar preços específicos expirados, duplicados e órfãos
Instalação, painel, assistente em 6 passos, categorias e proteções, histórico e restauro, agendamento, definições e resolução de problemas.
Instalação
Instale o módulo em Módulos > Gestor de módulos > Enviar um módulo, enviando o ficheiro ZIP. Na instalação, o módulo cria as suas tabelas e acrescenta o separador Catálogo > Limpeza de preços específicos. A instalação não altera nenhum preço.
Para atualizar a partir da 1.0.x, basta enviar o novo ZIP. O histórico e as cópias da 1.0.x são mantidos, assim como as definições da tarefa cron (ativação, modo, frequência). Abra o separador Agendamento após a atualização para verificar se lhe convêm.
O painel
A página Saúde analisa a tabela de preços específicos, em todo o catálogo ou num âmbito escolhido (loja, categoria, ID de produto). Mostra:
- o número de preços específicos, incluindo os ativos neste momento;
- o número de linhas que se podem limpar sem risco com a limpeza por defeito (expirados, duplicados, órfãos);
- o que nunca é apagado por defeito: preços ligados a um carrinho ativo, regras de preços do catálogo, preços futuros, preços sem data de fim, preços usados por outro módulo;
- o detalhe por categoria de problema, com as linhas elimináveis e protegidas de cada uma;
- os conflitos de prioridade e as regras de catálogo expiradas, para rever à mão;
- o tamanho atual da tabela, medido pela base de dados.

O painel indica quantas linhas a menos a tabela terá após a limpeza. O efeito na velocidade das páginas depende da sua loja: o módulo não o mede.
O assistente de limpeza em 6 passos
Clique em Iniciar o assistente de limpeza. Os passos são: Escolher, Simular, Verificar, Guardar, Limpar, Relatório. Nada é apagado antes do passo Limpar.
1. Escolher
Assinale as categorias a limpar. Cada contador indica as linhas que seriam apagadas com as proteções ativas. Defina o prazo dos preços expirados (por exemplo, expirados há pelo menos 7 dias) e o dos carrinhos terminados. As proteções ficam assinaladas por defeito; desmarque uma só se souber exatamente porque uma linha deve sair. Os filtros avançados limitam a limpeza a uma loja, uma categoria, ID de produto, um cliente, um grupo, um país, uma moeda, um tipo de valor ou uma data de expiração.

2. Simular
Executar a simulação calcula o plano sem apagar nada: linhas previstas e protegidas por categoria. O plano fica congelado: só essas linhas poderão ser apagadas. Uma linha que corresponde a várias categorias é planeada uma só vez, na primeira. Pode exportar o plano em CSV.

3. Verificar
A lista das linhas previstas mostra, para cada uma, o produto, o alvo, o valor, o período e os sinais úteis. Desmarque uma linha para a manter: uma linha excluída nunca é apagada.

4. Guardar
Criar a cópia copia cada linha prevista, coluna a coluna, para o histórico do módulo. Pode descarregar esta cópia em CSV antes de continuar. Se a cópia estiver desativada nas definições, o módulo indica-o claramente: a eliminação será definitiva.

5. Limpar
Assinale Verifiquei a simulação e quero eliminar estas N linhas. e clique em Eliminar N linhas. Sem cópia, também é preciso escrever o número de linhas. A eliminação avança por lotes, cada um na sua própria transação, e cada linha é verificada de novo mesmo antes de ser apagada: uma linha ligada entretanto a um carrinho, regenerada por uma regra ou usada por um módulo é ignorada. Pode pausar e retomar.

6. Relatório
O relatório dá, por categoria, as linhas previstas, apagadas, ignoradas, excluídas e protegidas, e a duração. Mostra também o que foi feito após a limpeza: caches de preços do PrestaShop limpas e índice de preços da pesquisa facetada atualizado para os produtos afetados. A partir do relatório pode restaurar, descarregar a cópia ou o relatório detalhado em CSV, ou enviar-se o relatório por e-mail.

Se o separador for fechado ou o servidor parar durante a limpeza, nada fica a meio. O painel mostra a limpeza inacabada com Abrir e retomar, ou pode abandonar o resto.
Categorias de limpeza
- Preços expirados: a data de fim já passou, estes preços já não se aplicam a ninguém.
- Duplicados exatos: mesmo produto, alvo, datas, quantidade e valor que uma linha mais antiga; fica a mais antiga. O índice único do PrestaShop normalmente impede-os: a verificação continua útil para dados importados.
- Órfãos: produto eliminado (ou ausente da loja do preço), combinação, cliente, grupo, país, moeda, loja ou grupo de lojas eliminado.
- Preços sem efeito: «manter o preço base» sem desconto. Os que podem anular outro desconto estão protegidos.
- Preços de carrinhos terminados: preços criados para um carrinho (orçamento, negociação, oferta…) encomendado ou sem alterações desde o prazo escolhido, ou eliminado.
- Prioridades de produtos eliminados e prioridades idênticas à global.
- Seleção manual: linhas escolhidas na lista de preços.
Proteções
- Gerado por uma regra de preços do catálogo: o PrestaShop regenera-o a partir da regra. Sempre protegido: altere ou elimine a regra.
- Ligado a um carrinho: criado para o carrinho de um cliente por um módulo de orçamentos, B2B, configurador ou oferta. Só a categoria Carrinhos terminados o pode remover.
- Começa no futuro: promoções agendadas.
- Sem data de fim (ilimitado): mantidos por defeito, mesmo que pareçam inúteis.
- Usado por outro módulo: um módulo ainda o referencia nas suas próprias tabelas. O painel lista os módulos detetados.
- Pode anular outro desconto: um preço sem efeito pode prevalecer sobre um desconto de grupo ou global e anulá-lo para o seu alvo.
A lista de preços
O separador Preços específicos mostra todos os preços específicos com os mesmos filtros do assistente, e sinais para os preços ligados a um carrinho, gerados por uma regra ou usados por um módulo de terceiros. Assinale linhas para lançar uma simulação só sobre essa seleção.

Histórico e restauro
O separador Histórico e restauro lista cada limpeza e cada simulação agendada, com o autor, o relatório e a cópia. As limpezas são conservadas com a sua cópia durante o prazo escolhido nas definições (90 dias por defeito) e depois purgadas automaticamente.

Restaurar repõe as linhas com o seu ID original e depois compara cada uma com a cópia. O relatório mostra então o número de linhas restauradas e a data.


Agendamento
O separador Agendamento configura uma limpeza automática chamada pela tarefa cron do seu alojamento. As proteções do assistente estão sempre ativas.
- Modo: Apenas simulação (relatório, nada é apagado), recomendado para começar, ou Limpeza com cópia automática.
- Frequência: a cada hora, dia, semana ou mês. As chamadas feitas antes da próxima data prevista são ignoradas.
- Categorias, prazo dos preços expirados e dos carrinhos terminados, limitação aos preços reservados a um cliente ou a uma loja.
- No máximo N linhas por execução: o resto é tratado na execução seguinte.
- Relatório por e-mail após cada execução, para o endereço escolhido ou o da loja.
Copie o URL do cron apresentado e chame-o a partir do seu alojamento, por exemplo a cada hora: o módulo aplica a frequência escolhida. Acrescente &dry=1 para forçar uma simulação. Mantenha este URL privado: o token protege-o e pode gerar um novo. Uma chamada com um token errado recebe um erro 403; se já houver uma execução em curso, a chamada recebe um erro 423.


Definições
- Cópia de segurança antes de cada eliminação: fortemente recomendada, permite o restauro num clique.
- Conservação das cópias em dias (0 = para sempre).
- Perfis autorizados a limpar e restaurar, além da permissão «Eliminar» do separador.
- Manter o histórico e as cópias ao desinstalar.
- Eliminar através dos objetos do PrestaShop: sim por defeito, para que os hooks de eliminação sejam executados (ERP, feeds e módulos de sincronização ficam informados). Não: SQL direto, mais rápido em volumes muito grandes.
- Linhas por lote (500 por defeito): cada lote é uma transação. Reduza o valor se o servidor cortar os pedidos longos.
- Atualizar o índice de preços da pesquisa facetada para os produtos afetados (até 300).
- Purgar agora o histórico antigo: remove as limpezas mais antigas do que o prazo de conservação e as simulações nunca executadas.

Blocos na ficha de produto e de cliente
Na ficha de produto, o bloco Saúde dos preços específicos indica o número de preços do produto, os que se podem limpar e o estado de cada um (ativo, expirado, futuro, carrinho, regra, módulo). O botão Simular uma limpeza deste produto abre o assistente já filtrado.

Na ficha de cliente, o bloco lista os preços reservados ao cliente e os carrinhos ligados, com uma limpeza dirigida a esse cliente.

Permissões dos funcionários
Consultar o módulo exige a permissão «Ver» do separador. Limpar e restaurar exigem a permissão «Eliminar» do separador em Parâmetros avançados > Equipa > Permissões, e que o perfil esteja assinalado nas definições do módulo. O perfil SuperAdmin está sempre autorizado. Um perfil sem estes direitos vê as páginas só em leitura.
Para programadores de módulos
Mesmo antes de apagar um lote, o módulo executa o hook actionDfSpecificPriceCleanerBeforeDelete com o ID da limpeza e a lista dos ID de preços. Um módulo pode acrescentar ao array veto os ID dos preços que quer manter: essas linhas são ignoradas e ficam no lugar.
Resolução de problemas
Algumas linhas são «ignoradas» durante a limpeza
Mudaram desde a simulação: ligadas a um carrinho, regeneradas por uma regra ou usadas por um módulo. É intencional. Lance uma nova simulação para as rever.
A simulação não prevê nenhuma linha
Todas as linhas correspondentes estão protegidas, ou nenhuma corresponde aos filtros. O contador «protegidas» de cada categoria indica o que é mantido e porquê.
A limpeza para num grande volume
Reduza Linhas por lote nas definições e retome a limpeza a partir do painel. Os lotes já tratados não são refeitos.
O URL do cron responde 403, 423 ou SKIPPED
403: token errado, copie de novo o URL a partir do separador Agendamento. 423: ainda há uma execução em curso. SKIPPED: agendamento desativado, data prevista ainda não atingida ou nenhuma categoria assinalada.
O relatório recomenda reconstruir o índice
Acima de 300 produtos afetados, o módulo não atualiza sozinho o índice de preços da pesquisa facetada. Reconstrua o índice a partir da configuração do módulo de pesquisa facetada.
Limitações
- Os conflitos de prioridade e as regras de catálogo expiradas são assinalados, nunca apagados automaticamente.
- O relatório por e-mail é enviado no idioma do funcionário (botão do relatório) ou no idioma por defeito da loja (cron).
- Sem cópia de segurança, uma eliminação não pode ser anulada.
Compatibilidade
- PrestaShop 1.7.8 a 9.x com o mesmo ZIP. Testado em 1.7.8.11, 8.2.1 e 9.1.5, com PHP 7.4, 8.1 e 8.5.
- Multiloja: a análise e a limpeza podem limitar-se a uma loja.
- Arquitetura ModuleAdminController, sem dependência Composer.
- Interface traduzida em francês, inglês, espanhol, alemão, italiano, neerlandês, polaco e português.