Release v4928.1.4.2 stable

docs/CLIENTFLOW_V471_ADMIN_SIDEBAR_SCROLL_FIX.md

@@ -0,0 +1,30 @@
+# ClientFlow v4.7.1 — Admin Sidebar Scroll Fix
+
+Hotfix visual para a navegação lateral introduzida na v4.7.
+
+## Problema
+
+Em ecrãs com pouca altura, ao abrir o submenu **Admin**, os itens técnicos no final do menu podiam ficar fora da área visível sem scroll próprio no sidebar.
+
+## Correção
+
+- O sidebar desktop passa a ter `overflow-y: auto` e `max-height: 100vh`.
+- O scroll fica contido no menu lateral com `overscroll-behavior: contain`.
+- Foi adicionado `scrollbar-gutter: stable` para evitar saltos visuais quando o scrollbar aparece.
+- O footer e blocos de navegação deixam de encolher de forma imprevisível.
+- Em mobile, o menu continua horizontal com `overflow-x: auto` e sem scroll vertical no sidebar.
+
+## Impacto
+
+Não altera rotas, regras de negócio, base de dados, Chatwoot, outbox nem lógica de oportunidades.
+
+## Validação
+
+```bash
+PYTHONPATH=. python -m compileall app scripts tests
+PYTHONPATH=. pytest -q
+```
+
+## Rollback
+
+Reverter apenas `app/admin_ui/styles.py` para a versão v4.7.