Release v4928.1.4.2 stable

docs/CLIENTFLOW_V4926_8_3_NOTES.md

@@ -0,0 +1,44 @@
+# ClientFlow v4926.8.3 — Jasmin current document consistency
+
+## Objetivo
+
+Corrige inconsistências observadas em oportunidades que já têm orçamento Jasmin importado:
+
+- não mostrar orçamentos antigos ainda abertos como candidatos principais quando já existe um orçamento Jasmin mais recente associado;
+- não sugerir `Criar orçamento Jasmin` no cockpit quando a oportunidade já tem `commercial_documents` Jasmin;
+- reduzir risco de duplicar orçamentos por engano.
+
+## Regras novas
+
+### Current document wins
+
+Se a oportunidade já tem um documento Jasmin `quotation` ou `proforma`, candidatos encontrados em `reconciliation_items` com data/série menor ou igual ao documento atual são ocultados por defeito.
+
+Candidatos mais recentes continuam a aparecer como substituição possível.
+
+### Workflow awareness
+
+O plano de ação passa a considerar também `commercial_documents`, não apenas `operation_links`:
+
+- `commercial_documents.system='jasmin' AND document_kind='quotation'` conta como orçamento existente;
+- `document_kind='proforma'` conta como pró-forma;
+- `document_kind='invoice'` conta como fatura.
+
+Assim o cockpit deixa de mostrar `Depois: Criar orçamento Jasmin` quando já existe orçamento importado.
+
+### Botão criar orçamento
+
+Quando já existe documento Jasmin, o botão principal deixa de ser `Criar orçamento` e passa para uma ação secundária:
+
+`Novo orçamento adicional`
+
+com confirmação explícita.
+
+## Validação recomendada
+
+Na oportunidade SEMENTENERGIAS:
+
+- ORC.ORC2026.158 deve continuar importado;
+- ORC.ORC2026.137 não deve aparecer como candidato acionável por defeito;
+- cockpit deve deixar de mostrar `Depois: Criar orçamento Jasmin`;
+- botão de orçamento deve ser secundário e com confirmação se já existir documento.