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

1.5 KiB

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

/operations
/operacoes
/system/health
/api/internal/operations/summary
/api/internal/system/health

Notas de deploy

Depois do rsync:

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.