Files
clientflow_backend/docs/CLIENTFLOW_V490_OPERATIONS_NOISE_CLEANUP.md
2026-06-09 22:55:58 +01:00

1.9 KiB

ClientFlow v4.9.0 — Operations Noise Cleanup

Esta versão fecha a higiene da fila do Centro de trabalho. O objetivo é retirar da fila diária mensagens que pertencem à inbox/email, mas não ao fluxo operacional do ClientFlow.

O que muda

  • Mensagens de postmaster, mailer-daemon, Mail Delivery Subsystem, Mail Delivery System, Office 365 / Exchange NDR, Undeliverable, Returned mail, Delivery Status Notification, Unknown To address e erros semelhantes deixam de aparecer no Centro de trabalho.
  • Tasks novas de REVIEW_MANUALLY, REMOVE_FROM_LIST, MARK_NO_INTEREST, IGNORE_SPAM, NO_ACTION e IGNORE_BOUNCE não entram como prioridade alta por defeito.
  • A contagem visível de “A fazer agora” passa a refletir melhor o que aparece realmente na fila, em vez de contar lixo antigo ainda pendente.
  • Foi adicionado um detector partilhado em app/operation_noise.py para manter as regras de ruído consistentes entre triagem, Operations e limpeza.

Limpeza de dados antigos

A versão inclui o script:

python scripts/cleanup_operations_noise.py --limit 200

Por defeito é dry-run. Para aplicar:

python scripts/cleanup_operations_noise.py --apply

O script marca tasks pendentes claramente técnicas/sistema/bounce como skipped. Não apaga mensagens, eventos brutos nem conversas Chatwoot.

Depois da limpeza

É normal a fila cair bastante, por exemplo de dezenas de itens para apenas trabalho real:

  • faturas a emitir;
  • orçamentos a preparar;
  • respostas comerciais reais;
  • bloqueios de outbox/documentos;
  • revisões com identidade/contexto útil.

Sem migração

Não requer migração de base de dados.

O que não muda

  • Não altera Chatwoot.
  • Não altera auto-complete.
  • Não altera outbox worker.
  • Não altera regras de criação de oportunidades comerciais reais.
  • Não adiciona nova integração ou LLM.