Release v4928.1.4.2 stable

docs/CLIENTFLOW_V4924_RECONCILIATION_PROCESS_REVIEW.md

@@ -0,0 +1,32 @@
+# ClientFlow v4.9.24 — Reconciliation Process Review
+
+Esta versão evolui a Reconciliação para uma área de revisão de processos, não apenas de matching de documentos.
+
+## Alterações principais
+
+- Cartões de processo candidato passam a mostrar **Motivos** e **Riscos**.
+- Cada candidato recebe um estado visual de revisão: `pronto`, `rever` ou `conflito`.
+- A UI permite marcar processos/itens como `needs_review` ou `historical`.
+- A tabela `reconciliation_decisions` guarda decisões do operador para auditoria e aprendizagem futura.
+- O resumo da página passa a contar `needs_review`, `conflict` e `historical`.
+
+## Regras preservadas
+
+- A sincronização externa continua a não criar oportunidades automaticamente.
+- O botão de reconstrução continua a apagar apenas candidatos gerados sem oportunidade ligada.
+- Cliente fiscal continua separado de processo/compra.
+- Oportunidades continuam a ser criadas/ligadas apenas por ação explícita do operador.
+
+## Objetivo operacional
+
+Cada cartão deve responder rapidamente:
+
+1. Quem é o cliente fiscal?
+2. Que compra/processo é este?
+3. Porque é que o sistema agrupou estes documentos?
+4. Que riscos existem antes de aplicar?
+5. Qual a ação certa: ligar, criar, rever ou arquivar como histórico?
+
+## Validação
+
+Suite completa: `173 passed`.