Release v4928.1.4.2 stable

docs/CLIENTFLOW_V451_UI_ALIGNMENT.md

@@ -0,0 +1,89 @@
+# 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
+```