Release v4928.1.4.2 stable

docs/CLIENTFLOW_V472_DOMAIN_ROUTES.md

@@ -0,0 +1,47 @@
+# ClientFlow v4.7.2 — Rotas por domínio
+
+Esta versão separa o registo de rotas da UI administrativa por domínio, reduzindo a responsabilidade de `app/admin_dashboard.py` e preparando a extração gradual de view models/componentes na v4.7.3.
+
+## Objetivo
+
+- Manter comportamento e URLs existentes.
+- Não alterar regras Chatwoot, auto-complete, oportunidades, outbox ou DB.
+- Criar módulos reais em `app/admin_ui/pages/`.
+
+## Estrutura
+
+```text
+app/admin_ui/router.py
+app/admin_ui/pages/
+  dashboard.py
+  operations.py
+  opportunities.py
+  tasks.py
+  customers.py
+  products.py
+  orders.py
+  finance.py
+  integrations.py
+  communications.py
+  outbox.py
+  events.py
+  runs.py
+  queues.py
+  conversations.py
+  system.py
+```
+
+## Compatibilidade
+
+As rotas públicas continuam iguais, incluindo aliases em português como `/operacoes`, `/oportunidades`, `/clientes`, `/produtos`, `/encomendas`, `/financeiro` e `/integracoes`.
+
+## Validação
+
+```bash
+PYTHONPATH=. python -m compileall app scripts tests
+PYTHONPATH=. pytest -q
+```
+
+## Migração de base de dados
+
+Não requer migração de base de dados.