Import ClientFlow production v4928.1.5.132.4

RELEASE_NOTES_v4928_1_5_22.md

@@ -0,0 +1,24 @@
+# v4928.1.5.22 — Operator Workbench communication UX
+
+Esta versão inclui o hotfix v4928.1.5.21 de formatação Chatwoot e acrescenta melhorias operacionais no detalhe de tasks/follow-ups.
+
+## Correções incluídas
+
+- P1: alerta claro para tarefas de comunicação sem email nem conversa Chatwoot.
+- P2: fallback de nome/email no título e listas de tasks: cliente fiscal → oportunidade → contacto/email → título.
+- P3: ações práticas no rascunho: guardar, copiar mensagem e criar email na Outbox quando existe email.
+- P4: indicação/seleção de documentos da oportunidade antes de gerar rascunho IA; aviso quando há múltiplos documentos.
+- P5: notas de backfill passam para contexto interno recolhível; menos ruído técnico no fluxo normal.
+- Follow-up payment: prompt OpenAI reforçado para não chamar “pró-forma” a documentos Jasmin `quotation`.
+
+## Segurança operacional
+
+- Nada é enviado automaticamente por email.
+- “Criar email na Outbox” cria item `email.send_email` para revisão/processamento posterior.
+- Envio Chatwoot só aparece quando a task tem conversa Chatwoot associada.
+- Se não houver email nem conversa, a UI mostra bloqueio operacional de canal.
+
+## Validação
+
+- `python -m compileall -q app`
+- `python -m pytest -q` → 290 passed