clientflow_backend/RELEASE_NOTES_v4928_1_5_20.md

v4928.1.5.20 — Dedicated OpenAI follow-up draft prompt

Objetivo

Corrige o botão de geração de rascunho de follow-up para usar um modo LLM/OpenAI específico de follow-up, em vez de reutilizar o agente genérico de resposta ao cliente.

Alterações principais

• Novo agente OpenAI/file_search dedicado a follow-ups em email_reply_agent_service.py.
• Novo schema JSON FOLLOW_UP_SCHEMA para forçar resposta estruturada.
• Prompt específico para FOLLOW_UP_PAYMENT, FOLLOW_UP_QUOTE, FOLLOW_UP_PROFORMA, FOLLOW_UP_CUSTOMER_REVIEW e FOLLOW_UP_GENERIC.
• Para FOLLOW_UP_PAYMENT, o prompt proíbe explicitamente frases que mudem o objetivo para confirmação interna de pagamento.
• generate_reply_draft usa o agente dedicado para templates reply_type="follow_up".
• Se o agente OpenAI de follow-up falhar ou estiver desligado, mantém o template seguro determinístico e não cai no agente genérico.
• UI atualizada para deixar claro que o botão chama OpenAI: “Gerar rascunho personalizado com IA”.
• Em follow-ups, “Pedido do cliente” passa a “Contexto da tarefa”.
• Em follow-ups, “Concluir” passa a “Marcar follow-up como feito”.
• Badge atualizado para v4928.1.5.20.

Segurança

• Nada é enviado automaticamente.
• O operador continua a rever, editar/copiar e marcar a task como feita.
• O rascunho não deve incluir notas internas, backfill, metadata, ClientFlow ou informação fiscal incompleta.
• O rascunho não deve inventar preços, documentos, URLs, stock, prazos, descontos ou estado de pagamento.

Validação

• python -m compileall -q app
• python -m pytest -q → 288 passed