Import ClientFlow production v4928.1.5.132.4

RELEASE_NOTES_v4928_1_5_7.md

@@ -0,0 +1,46 @@
+# ClientFlow v4928.1.5.7 — Email Reply Agent readability format
+
+## Objetivo
+
+Melhorar a legibilidade comercial das respostas geradas pelo agente de email OpenAI/file_search, mantendo a Fase 1 em modo seguro: rascunho editável, sem envio automático.
+
+## Alterações
+
+- Reforço do prompt para gerar respostas com parágrafos curtos e estrutura visual mais clara.
+- Pedidos de preço/proposta passam a seguir uma estrutura comercial quando aplicável:
+  - cumprimento/agradecimento;
+  - proposta/equipamento solicitado;
+  - preço s/IVA;
+  - funcionalidades incluídas;
+  - prazo de entrega;
+  - próximo passo;
+  - assinatura `Com os melhores cumprimentos, Sérgio Araújo, Blif`.
+- O agente só deve usar nome, `Sr.`/`Sra.` ou referência de terceiros quando essa informação estiver disponível no email ou no contexto ClientFlow.
+- A descrição JSON de `resposta_sugerida` foi afinada para pedir respostas com listas e melhor leitura.
+- `prompt_version` atualizado para `blif-email-agent-phase1-readability-20260613`.
+
+## Segurança preservada
+
+- O agente continua a gerar apenas rascunhos.
+- Não há envio automático.
+- Casos de desconto, pagamento, encomenda, reclamação, exceção comercial, stock/envio e condições especiais continuam a poder ser marcados para revisão humana.
+- O fluxo antigo continua disponível se `CLIENTFLOW_EMAIL_REPLY_AGENT_ENABLED=false`.
+
+## Deploy recomendado
+
+Este pacote deve ser aplicado sobre a raiz atual do backend, evitando criar uma pasta nested.
+
+```bash
+cd /mnt/ssd/home/plx/clientflow_backend
+mkdir -p /tmp/clientflow_v4928_1_5_7
+unzip -q /caminho/clientflow_backend_v4928_1_5_7_email_reply_agent_readability.zip -d /tmp/clientflow_v4928_1_5_7
+rsync -a /tmp/clientflow_v4928_1_5_7/ /mnt/ssd/home/plx/clientflow_backend/
+
+PYTHONPATH=. python -m compileall app scripts tests
+PYTHONPATH=. pytest -q
+
+sudo systemctl restart clientflow-api
+curl -i http://127.0.0.1:8020/health
+sudo nginx -t
+sudo systemctl reload nginx
+```