clientflow_backend/docs/CLIENTFLOW_V453_UI_POLISH.md

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

PYTHONPATH=. python -m compileall app scripts tests
PYTHONPATH=. pytest -q

Resultado esperado:

19 passed