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

60 lines
1.5 KiB
Markdown

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