clientflow_backend/docs/CLIENTFLOW_V4924_RECONCILIATION_PROCESS_REVIEW.md

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.