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

```bash
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:

```bash
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:

```bash
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
```