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

2.2 KiB

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

PYTHONPATH=. python -m compileall app scripts tests
PYTHONPATH=. pytest -q