Release v4928.1.4.2 stable

docs/CLIENTFLOW_V494_RECONCILIATION_RECENT_WINDOW.md

@@ -0,0 +1,45 @@
+# ClientFlow v4.9.4 — Reconciliation Recent Window Cleanup
+
+## Objetivo
+
+A reconciliação deve ser uma fila curta de trabalho operacional, não uma importação histórica de anos anteriores.
+
+Esta versão muda o comportamento por defeito para trabalhar apenas com os últimos 3 dias e adiciona uma ação de limpeza para retirar da fila aberta candidatos antigos já sincronizados.
+
+## Alterações
+
+- `sync_external_reconciliation.py` passa a usar `--days 3` por defeito.
+- O botão "Sincronizar APIs externas" usa os últimos 3 dias.
+- Jasmin, Odoo e Packlink passam a respeitar a janela recente de 3 dias por defeito.
+- A página `/reconciliation` mostra uma ação "Limpar fora dos 3 dias".
+- O script `cleanup_stale_reconciliation_items.py` passa a usar 3 dias por defeito e pode limpar todas as fontes, ou apenas uma fonte.
+
+## Comandos úteis
+
+Dry-run:
+
+```bash
+PYTHONPATH=. python scripts/cleanup_stale_reconciliation_items.py --days 3
+```
+
+Aplicar:
+
+```bash
+PYTHONPATH=. python scripts/cleanup_stale_reconciliation_items.py --days 3 --apply
+```
+
+Limpar só Odoo:
+
+```bash
+PYTHONPATH=. python scripts/cleanup_stale_reconciliation_items.py --source odoo --days 3 --apply
+```
+
+Sincronizar apenas últimos 3 dias:
+
+```bash
+PYTHONPATH=. python scripts/sync_external_reconciliation.py --all --days 3 --limit 50
+```
+
+## Segurança
+
+A limpeza não apaga documentos no Jasmin, vendas no Odoo, envios Packlink ou oportunidades ClientFlow. Apenas marca candidatos antigos de reconciliação como `ignored` para não aparecerem na fila aberta.