Release v4928.1.4.2 stable

docs/CLIENTFLOW_V4922_REBUILD_RECONCILIATION_UI.md

@@ -0,0 +1,38 @@
+# ClientFlow v4.9.22 — Rebuild Reconciliação pela UI
+
+A página de Reconciliação passa a ter uma ação operacional para reconstruir a janela ativa.
+
+## Botão
+
+`Apagar e correr novamente`
+
+O botão executa:
+
+1. Apaga apenas candidatos gerados por `jasmin`, `odoo` e `packlink`.
+2. Limita aos estados `open`, `needs_review` e `ignored`.
+3. Protege sempre `opportunity_id IS NULL`.
+4. Cria uma tabela de backup antes do delete.
+5. Volta a sincronizar APIs externas para a mesma janela ativa.
+
+## Segurança
+
+Não apaga:
+
+- clientes
+- oportunidades
+- documentos reais Jasmin/Odoo/Packlink
+- itens já ligados a oportunidades
+- comprovativos manuais
+- tarefas ou operações
+
+## Endpoint
+
+`POST /reconciliation/rebuild`
+
+Recebe `days` pela UI e mantém a mesma janela ativa: 1, 3, 7 ou 30 dias.
+
+## Função de serviço
+
+`reset_generated_reconciliation_items(...)`
+
+É a versão reutilizável e segura do script `scripts/reset_reconciliation_generated.py`.