Release v4928.1.4.2 stable

docs/CLIENTFLOW_V453_UI_POLISH.md

@@ -0,0 +1,49 @@
+# ClientFlow v4.5.3 — Semantic Icons + UI Polish
+
+Esta microversão corrige o acabamento visual da v4.5.2.
+
+## Objetivo
+
+Substituir os ícones genéricos dos cards KPI por ícones semânticos, mantendo a lógica operacional e as integrações intactas.
+
+## Alterações
+
+- Atualização do badge visual para `v4.5.3 UI`.
+- Sidebar passa a usar Bootstrap Icons semânticos.
+- Cards KPI passam a renderizar um elemento `.cf-kpi-icon` com ícone Bootstrap.
+- Ícones automáticos por tema:
+  - oportunidades/pipeline: funil;
+  - documentos/orçamentos: documento;
+  - finanças/pagamentos: euro;
+  - tasks: checklist;
+  - comunicações/email: envelope;
+  - erros/bloqueios: alerta;
+  - envios/logística: camião;
+  - clientes: cartão de cliente;
+  - produtos/Jasmin: caixa/artigo;
+  - integrações/sistema: puzzle.
+- Tons visuais por tipo: verde, laranja, vermelho e roxo quando aplicável.
+- Mantém Bootstrap 5 + Bootstrap Icons via CDN.
+
+## Não altera
+
+- Base de dados.
+- Migrações.
+- Jasmin.
+- Packlink.
+- Outbox worker.
+- Webhooks.
+- Lógica de documentos comerciais.
+
+## Validação
+
+```bash
+PYTHONPATH=. python -m compileall app scripts tests
+PYTHONPATH=. pytest -q
+```
+
+Resultado esperado:
+
+```text
+19 passed
+```