docs: manuais, mockups e CI do Navegador HTML5

docs/AI.md

@@ -38,6 +38,7 @@ Valores são persistidos em `config/ai.yaml`.
 | Superfície | Detalhe |
 |------------|---------|
 | Portal → **Análise → Insights IA** (e preview na Visão geral) | Resumo, lista de insights e gráficos sugeridos |
+| Portal → **Navegador** → Grafana (`ciem-insights`) | Mesma pasta de insights no Grafana embutido |
 | Portal → Visão Geral | Linha de status dos insights |
 | Grafana → dashboard `ciem-insights` | Tabelas via Infinity (`/grafana/insights/table` e `/charts`) |
 | Grafana → Visão Geral NOC | Painel “Insights de IA” |

docs/CHANGELOG_FEATURES.md

@@ -20,7 +20,7 @@ Resumo das capacidades adicionadas ao CIEM para operação pelo portal (administ
 | Switch ON/OFF | Admin ativa/desativa cada coletor em **Configuração** |
 | Formulário de opções | Com o módulo ativo, aparecem URL, credenciais e opções específicas |
 | Persistência | Valores gravados em `config/modules.yaml` |
-| Grafana embutido | Aba Grafana no portal com visão NOC via API |
+| Consoles no Navegador | Com o módulo ativo, `options.url` aparece como atalho no **Navegador HTML5** (admin) |
 
 **Documentação:** [MODULES.md](MODULES.md), [PORTAL.md](PORTAL.md)
 

docs/CI_CD.md

@@ -31,6 +31,15 @@ CONFIG_PATH=./config PYTHONPATH=shared:services/core pytest tests -v
 docker compose -f deploy/docker/docker-compose.yml config --quiet
 ```
 
+Testes do portal cobrem o **Navegador HTML5** (`tests/test_portal_browser.py`: sidebar para todos, chrome, normalização de URL, assets/docs) e lembretes/calendário (`tests/test_portal_reminders_calendar.py`).
+
+Regenerar diagrama e mockups (incl. tela do Navegador):
+
+```bash
+python3 scripts/generate_architecture_diagram.py
+python3 scripts/generate_portal_mockups.py
+```
+
 ## Releases versionadas
 
 ```bash

docs/DASHBOARDS.md

@@ -2,6 +2,8 @@
 
 O CIEM provisiona **13 dashboards** na pasta **CIEM** do Grafana (`grafana/dashboards/`).
 
+No dia a dia do NOC, abra-os pelo **Navegador HTML5** do portal (sidebar **Navegador** → atalho Grafana), sem sair do CIEM. Detalhes: [GRAFANA.md](GRAFANA.md) · [PORTAL.md](PORTAL.md).
+
 ## Visão geral dos dashboards
 
 ### Plataforma (6)

docs/GRAFANA.md

@@ -2,6 +2,19 @@
 
 O CIEM provisiona automaticamente **13 dashboards** (6 da plataforma incluindo Insights IA + 6 por módulo + visão de módulos).
 
+## Acesso recomendado: Navegador HTML5 do portal
+
+Preferência operacional (observer e admin):
+
+1. Login no portal → sidebar **Navegador**
+2. Atalho **Grafana** (ou digite `/grafana/` na barra)
+3. Dashboards embutidos no iframe same-origin; use **↗** se precisar de tela cheia em nova aba
+
+Atalhos equivalentes: Visão geral → **Abrir navegador**; Análise → **No navegador**.  
+URL direta: `https://seu-dominio/grafana/` (via proxy ZTNA).
+
+![Navegador com Grafana](assets/ciem-portal-browser.jpg)
+
 ## Dashboards por módulo
 
 Cada sistema de monitoramento tem um dashboard dedicado:
@@ -43,7 +56,7 @@ python3 scripts/generate-grafana-dashboards.py
 | **Módulos Coletores** | `ciem-modules` | Saúde de Zabbix, Cacti, Nagios, etc. |
 | **Sessões e Auditoria** | `ciem-sessions` | Alvos de manutenção + log de sessões |
 
-Acesse: `https://seu-dominio/grafana/` → pasta **CIEM**
+Acesse pelo **Navegador** do portal ou em `https://seu-dominio/grafana/` → pasta **CIEM**
 
 ## Fontes de dados provisionadas
 

docs/MANUAL_ADMIN.md

@@ -76,6 +76,8 @@ Além do Grafana e URLs, o admin usa o **Navegador** para:
 
 ![Navegador HTML5](assets/ciem-portal-browser.jpg)
 
+O mockup mostra o item **Navegador** na sidebar (sem restrição de papel), chrome completo e atalhos Grafana / Guacamole / módulos.
+
 ## Sessões de manutenção
 
 ![Sessões](assets/ciem-portal-sessions.jpg)

docs/MANUAL_USER.md

@@ -92,7 +92,7 @@ Se Insights estiverem desabilitados, a aba informa que um administrador precisa
 
 ![Navegador HTML5](assets/ciem-portal-browser.jpg)
 
-Disponível para **todos** os papéis desde o login:
+Disponível para **todos** os papéis desde o login (mockup acima: sidebar com **Navegador** ativo, chrome e Grafana embutido):
 
 - Sidebar **Navegador** (barra de endereço, voltar/avançar, recarregar, início)
 - Atalhos: Grafana (`/grafana/`), URLs recentes

docs/PORTAL.md

@@ -142,6 +142,7 @@ services/portal/public/
 
 1. **Branch** — `cursor/portal-<descricao>` ou fluxo do time  
 2. **Mockup** — se a UI mudar de forma visível, atualize o JPG em `docs/assets/`  
+   (`python3 scripts/generate_portal_mockups.py` regenera login, dashboard, **navegador**, alarmes, análise, sessões e config; `python3 scripts/generate_architecture_diagram.py` regenera o diagrama)  
 3. **PR** — inclua screenshot ou diff do mockup  
 4. **Teste manual** — login com `admin` / `admin123`  
 

docs/PROCESSES.md

@@ -6,6 +6,8 @@ Descrição dos processos de ponta a ponta: coleta, alarmes, visualização e ma
 
 ![Arquitetura e fluxos](assets/ciem-architecture-diagram.jpg)
 
+O diagrama destaca o **Portal Web + Navegador HTML5** (Grafana / URLs / SSO Guacamole) atrás do proxy ZTNA. Mockup da tela: [ciem-portal-browser.jpg](assets/ciem-portal-browser.jpg).
+
 ## 1. Autenticação no portal
 
 ```

docs/README.md

@@ -67,6 +67,8 @@ Imagens em `docs/assets/` para alinhar times de produto, UX e desenvolvimento:
 | [ciem-architecture-diagram.jpg](assets/ciem-architecture-diagram.jpg) | Arquitetura ZTNA (Portal + Navegador HTML5) |
 
 > Ao alterar o portal (`services/portal/`), atualize o mockup correspondente (incl. `ciem-portal-browser.jpg`) e referencie o PR na descrição da mudança.
+>
+> Regenerar: `python3 scripts/generate_portal_mockups.py` · `python3 scripts/generate_architecture_diagram.py`
 
 ## Manifests Kubernetes