clientflow_backend/RELEASE_NOTES_v4928_1_5_10.md

ClientFlow v4928.1.5.10 — Reply recipient from email signature

Objetivo

Corrigir a saudação dos rascunhos quando a oportunidade/cliente fiscal é uma empresa, mas a última mensagem está assinada por uma pessoa.

Alterações

• Novo helper app/reply_recipient_utils.py.
• Extrai nome pessoal da assinatura da última mensagem do cliente.
• Prioriza a pessoa que assinou a mensagem sobre nome da empresa, cliente fiscal ou oportunidade.
• Evita cumprimentos como Boa tarde Amorasub, quando existe Alexandra Silvestre na assinatura.
• Expõe ao LLM/OpenRouter contexto separado:
  • recipient.person_name
  • recipient.company_name
  • preferred_greeting
  • greeting_source
• Expõe ao agente OpenAI/file_search contexto separado:
  • destinatario_resposta.nome_pessoa
  • destinatario_resposta.nome_empresa
  • destinatario_resposta.cumprimento_preferido
• Reforça prompt para follow-ups sobre morada/endereço: confirmar receção da morada e indicar próximo passo concreto, em vez de resposta vaga.
• Badge UI atualizado para v4928.1.5.10.

Validação

• python -m compileall -q app scripts tests
• pytest -q
• Resultado local: 275 passed.