Release v4928.1.4.2 stable

docs/CLIENTFLOW_V490_OPERATIONS_NOISE_CLEANUP.md

@@ -0,0 +1,48 @@
+# 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:
+
+```bash
+python scripts/cleanup_operations_noise.py --limit 200
+```
+
+Por defeito é dry-run. Para aplicar:
+
+```bash
+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.