Release v4928.1.4.2 stable

docs/CLIENTFLOW_V499_PROCESS_TIMELINE_RECONSTRUCTION.md

@@ -0,0 +1,33 @@
+# ClientFlow v4.9.9 — Process Timeline Reconstruction
+
+Esta versão melhora a Reconciliação para deixar de tratar documentos/vendas/comprovativos como ligações soltas.
+
+## Objetivo
+
+Quando o ClientFlow encontra evidências externas, tenta agrupá-las por NIF, email ou nome e propõe um processo provável:
+
+- orçamento Jasmin encontrado;
+- pró-forma/fatura Jasmin encontrada;
+- venda/encomenda Odoo encontrada;
+- comprovativo recebido;
+- envio Packlink encontrado.
+
+A UI mostra uma timeline reconstruída e o operador decide se deve criar uma oportunidade reconstruída ou ligar todos os itens a uma oportunidade existente.
+
+## Segurança
+
+A versão não confirma pagamentos, não emite faturas, não fecha oportunidades e não altera documentos externos automaticamente.
+
+## Fluxo
+
+1. Sincronizar Jasmin/Odoo/Packlink.
+2. Abrir `/reconciliation`.
+3. Rever "Processos candidatos".
+4. Escolher uma ação:
+   - ligar processo à sugestão;
+   - ligar a outra oportunidade;
+   - criar oportunidade reconstruída.
+
+## Notas
+
+Eventos reconstruídos ficam registados como `reconciliation_evidence_imported` e a criação como `opportunity_reconstructed_from_reconciliation`.