Files
clientflow_backend/docs/CLIENTFLOW_V494_RECONCILIATION_RECENT_WINDOW.md
2026-06-09 22:55:58 +01:00

46 lines
1.5 KiB
Markdown

# 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.