Release v4928.1.4.2 stable

docs/CLIENTFLOW_V495_RECONCILIATION_OPERATION_SUGGESTIONS.md

@@ -0,0 +1,42 @@
+# ClientFlow v4.9.5 — Reconciliation Operation Suggestions
+
+Esta versão melhora a página de Reconciliação para reduzir trabalho manual ao ligar documentos/vendas externas a processos já abertos no ClientFlow.
+
+## Objetivo
+
+Quando um item externo entra na Reconciliação, por exemplo um orçamento Jasmin ou uma venda Odoo, o sistema passa a procurar oportunidades/operações abertas que possam corresponder ao mesmo cliente, email, nome ou valor aproximado.
+
+O sistema **não liga automaticamente**. Apenas sugere uma ligação pré-preenchida para o operador confirmar.
+
+## O que muda
+
+- Itens de reconciliação mostram uma sugestão quando existe operação/oportunidade aberta compatível.
+- A sugestão aparece com o botão `Ligar a esta operação`.
+- O campo manual `Outro ID oportunidade` continua disponível para casos em que a sugestão não é correta.
+- `Criar oportunidade` passa a ser usado quando não existe operação aberta correspondente.
+
+## Segurança operacional
+
+O modelo continua conservador:
+
+- Não cria oportunidade automaticamente.
+- Não confirma pagamentos.
+- Não emite documentos.
+- Não liga documentos sem confirmação do operador.
+
+## Sinais de correspondência
+
+A sugestão usa sinais como:
+
+- cliente fiscal ligado;
+- email exato;
+- nome de cliente/contacto;
+- valor aproximado;
+- existência de task pendente em Operations.
+
+## Fluxo esperado
+
+1. Sync externo cria item de reconciliação.
+2. Reconciliação procura operações abertas compatíveis.
+3. UI mostra sugestão pré-preenchida.
+4. Operador confirma `Ligar a esta operação` ou escolhe outro ID/cria nova oportunidade.