Release v4928.1.4.2 stable

docs/CLIENTFLOW_V485_BOUNCE_IGNORE_CARD_UX.md

@@ -0,0 +1,74 @@
+# ClientFlow v4.8.5 — Bounce Ignore & Card UX Cleanup
+
+Objetivo: fechar o ciclo de estabilização operacional com uma correção pequena e conservadora.
+
+## O que muda
+
+### 1. Emails bounce/NDR não entram no fluxo operacional
+
+Mensagens automáticas como Office 365 / Exchange NDR, Mail Delivery Subsystem, postmaster e mailer-daemon deixam de criar trabalho no ClientFlow.
+
+Exemplos tratados como bounce/NDR:
+
+- `Undeliverable:`
+- `Your message couldn't be delivered`
+- `Recipient wasn't found`
+- `Unknown To address`
+- `Delivery Status Notification`
+- `Non-Delivery Report`
+- `Remote Server returned`
+- `550 5.1.1`
+- `5.1.10`
+
+Comportamento:
+
+- não cria task;
+- não cria oportunidade;
+- não cria cliente fiscal;
+- não aparece em Operations;
+- não exige cliente fiscal.
+
+O email continua disponível na inbox original, como Chatwoot, Thunderbird ou servidor de email.
+
+### 2. Cards de Operations mais leves
+
+O card principal passa a priorizar informação útil para decidir:
+
+- identidade legível do contacto/cliente;
+- contexto curto;
+- próxima ação;
+- bloqueio atual apenas quando existe;
+- botões principais.
+
+IDs técnicos do Chatwoot deixam de ser título principal. Quando não existe nome/email/telefone útil, o card mostra `Contacto sem identificação`, e não `Contacto Chatwoot #123`.
+
+O bloco `Ver detalhes` só aparece quando houver informação realmente útil, como cliente fiscal, oportunidade ligada, bloqueio ou contexto de integração.
+
+### 3. Cards de oportunidades mais simples
+
+O card da oportunidade deixa de mostrar informação de baixo valor no primeiro nível, como valor `0,00 €`, data/hora completa e contadores técnicos.
+
+O CTA passa a ser específico sempre que possível:
+
+- `Preparar resposta`
+- `Emitir pró-forma`
+- `Emitir fatura`
+- `Confirmar pagamento`
+- `Ver tarefa pendente`
+- `Ver oportunidade`
+
+## O que não muda
+
+- Sem migração de base de dados.
+- Sem nova integração.
+- Sem nova lógica LLM.
+- Sem alteração ao outbox worker.
+- Sem alteração ao auto-complete Chatwoot.
+- Sem alteração às regras documentais/fiscais já existentes.
+
+## Validação
+
+```bash
+PYTHONPATH=. python -m compileall app scripts tests
+PYTHONPATH=. pytest -q
+```