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