clientflow_backend/RELEASE_NOTES_v4928_1_5_60.md

v4928.1.5.60 — Company Workflow Profiles + Opportunity Flow Engine Foundation

Esta versão introduz a primeira fundação estrutural para tornar o ClientFlow menos rígido e mais adaptável por empresa, sem alterar o modelo de dados nem exigir migrations.

Principais alterações

• Novo pacote app/domain/opportunity_flow/ com:
  • OpportunityEvidence: leitura normalizada da oportunidade.
  • OpportunityDecision: decisão operacional única.
  • decide_opportunity_next_action: motor de decisão isolado de HTML/SQL.
  • regras BLIF isoladas em rules.py.
• Novo perfil configurável em config/company_profiles/blif/:
  • defaults de pagamento/entrega;
  • fases comerciais;
  • labels de ações;
  • cards da oportunidade;
  • intents de email.
• opportunity_next_action_service.py passa a delegar no motor de fluxo.
• Página inicial de configuração do workflow:
  • /settings/workflow
  • /configuracao/fluxo-operacional
• Ajustes de labels operacionais para reduzir exposição de “pró-forma” na UI principal BLIF.
• Testes de cenários reais do fluxo BLIF:
  • orçamento → confirmar pagamento → fatura;
  • pagamento confirmado + fatura + Odoo em produção → aguardar produção;
  • pagamento pós-entrega → follow-up pagamento;
  • conflito fiscal bloqueia ações financeiras.

Compatibilidade

• Sem migrations.
• Sem alteração de tabelas.
• Mantém aliases legados para dados antigos, incluindo proforma, mas a UI principal passa a privilegiar Orçamento/Fatura.
• Regras críticas continuam em código testado; configuração altera labels/defaults/ordem/visibilidade, não segurança operacional.

Validação

• python3 -m compileall -q app tests
• PYTHONPATH=. pytest -q
• Resultado: 343 passed