Release v4928.1.4.2 stable

docs/CLIENTFLOW_V497_RECONCILIATION_PAGE_HOTFIX.md

@@ -0,0 +1,31 @@
+# ClientFlow v4.9.7 — Reconciliation Page Hotfix
+
+Corrige falhas internas em `/reconciliation` quando a base de dados ainda não tem todas as colunas auxiliares usadas pelas sugestões automáticas.
+
+## Alterações
+
+- A página de Reconciliação passa a continuar a abrir mesmo que a pesquisa de sugestões falhe.
+- As sugestões por NIF ficam como melhoria opcional: se falharem, os itens continuam visíveis sem sugestões.
+- `ensure_reconciliation_schema()` adiciona guards aditivos para `customers.tax_id`, `customers.email` e `opportunities.local_customer_id` quando necessário.
+- Não há alteração destrutiva de dados.
+
+## Validação
+
+```bash
+PYTHONPATH=. python -m compileall app scripts tests
+PYTHONPATH=. pytest -q
+```
+
+## Depois de instalar
+
+Reiniciar a API e abrir:
+
+```text
+/reconciliation
+```
+
+Se a página abrir sem erro, reexecutar a sincronização recente:
+
+```bash
+PYTHONPATH=. python scripts/sync_external_reconciliation.py --all --days 3 --limit 50
+```