clientflow_backend/docs/CLIENTFLOW_V451_UI_ALIGNMENT.md

ClientFlow v4.5.1 — UI Alignment

Esta atualização alinha a UI real instalada com o mockup aprovado para a organização v4.5 Operational Core.

Objetivo

Manter a lógica e os endpoints da v4.5, mas tornar a interface mais próxima do mockup:

• sidebar clara e moderna;
• topbar com pesquisa global;
• cartões KPI mais legíveis;
• tabelas com linhas em formato de cartões;
• melhor responsividade em mobile;
• distinção visual mais clara entre Dashboard, Centro de trabalho, Comunicações, Oportunidades, Outbox e Integrações.

Escopo

Esta versão é essencialmente visual.

Não altera:

• migrações da BD;
• lógica Jasmin;
• lógica Packlink;
• outbox worker;
• webhooks;
• serviços de email;
• endpoints principais.

Páginas afetadas

Como o layout base é partilhado, a melhoria visual afeta a UI admin em geral:

• /
• /operations
• /communications
• /opportunities
• /outbox
• /integrations
• /products
• /customers

Atualização em campo

Não é necessário aplicar migração nova.

Procedimento recomendado:

cd /home/ricar/Transferências/clientflow_backend_v451_ui_alignment

rsync -avz --delete --dry-run \
  --exclude ".env" \
  --exclude ".venv/" \
  --exclude "venv/" \
  --exclude "__pycache__/" \
  --exclude ".git/" \
  --exclude "*.db" \
  --exclude "*.log" \
  --exclude "uploads/" \
  ./ plx@alarmsys:/mnt/ssd/home/plx/clientflow_backend/

Se o dry-run estiver correto:

rsync -avz --delete \
  --exclude ".env" \
  --exclude ".venv/" \
  --exclude "venv/" \
  --exclude "__pycache__/" \
  --exclude ".git/" \
  --exclude "*.db" \
  --exclude "*.log" \
  --exclude "uploads/" \
  ./ plx@alarmsys:/mnt/ssd/home/plx/clientflow_backend/

No servidor:

cd /mnt/ssd/home/plx/clientflow_backend
source .venv/bin/activate 2>/dev/null || true
PYTHONPATH=. python -m compileall app scripts tests
pytest -q
sudo systemctl restart clientflow-api
sudo systemctl status clientflow-api --no-pager
journalctl -u clientflow-api -n 80 --no-pager