Release v4928.1.4.2 stable

docs/CLIENTFLOW_V42_NOTES.md

@@ -0,0 +1,59 @@
+# ClientFlow v4.2 — Operação Comercial e Logística
+
+Esta versão melhora a maturidade operacional do ClientFlow sem alterar a arquitetura principal.
+
+## Alterações principais
+
+- Nova página `/operations` / `/operacoes` para operação diária.
+- Nova página `/system/health` para saúde operacional.
+- Timeline da oportunidade passa a juntar eventos, produtos, documentos, outbox e envios.
+- API interna adiciona:
+  - `/api/internal/operations/summary`
+  - `/api/internal/system/health`
+- Navegação passa a separar:
+  - Operações
+  - Outbox
+  - Integrações
+- A página de operações destaca:
+  - oportunidades abertas
+  - outbox pendente/falhada
+  - faturas emitidas hoje
+  - orçamentos abertos
+  - envios pendentes
+  - clientes incompletos
+  - produtos sem Artigo Jasmin
+
+## Objetivo
+
+Reduzir a dependência do terminal para operação diária. A equipa deve conseguir abrir `/operations` e saber rapidamente o que precisa de ação.
+
+## Rotas novas
+
+```text
+/operations
+/operacoes
+/system/health
+/api/internal/operations/summary
+/api/internal/system/health
+```
+
+## Notas de deploy
+
+Depois do rsync:
+
+```bash
+cd /mnt/ssd/home/plx/clientflow_backend
+source .venv/bin/activate
+python scripts/apply_migrations.py --dry-run
+python scripts/apply_migrations.py
+python scripts/check_clientflow_health.py
+sudo systemctl restart clientflow-api
+```
+
+## Próximas melhorias sugeridas
+
+- Packlink com cotação antes de criar envio.
+- Guardar PDFs localmente.
+- Backups/restore via scripts próprios.
+- Duplicados de clientes por NIF.
+- Sincronização de preços Jasmin vs Odoo.