req-230 — Integração Oficial da V3.0: Consolidação das Branches (req-226 a req-229), Ajuste Canônico de Rota das Capas e Homologação E2E

As quatro requisições que compõem o ecossistema do Dashboard V3.0 e da Arquitetura de Estado foram finalizadas com sucesso pelos seus respectivos agentes executores: - req-226…

Status: in-review
Modo de Autonomia: autonomo_monitorado
Lote Alvo: BATCH-239
Data de Criação: 2026-10-04
Repositório: conn2flow (Core) em [REDACTED]
Origem: Engenheiro Chefe / Arquiteto Master: Unificação e consolidação das quatro frentes paralelas entregues (req-226, req-227, req-228, req-229) na branch main.
Aviso de Concorrência: As branches das frentes paralelas (feat/req-226, feat/req-228, feat/req-229) já finalizaram suas execuções isoladas em worktrees. Este lote é a integração harmoniosa no branch main do Core.

1. Contexto e Objetivos

As quatro requisições que compõem o ecossistema do Dashboard V3.0 e da Arquitetura de Estado foram finalizadas com sucesso pelos seus respectivos agentes executores:

req-226 (BATCH-235): Grid interativo de módulos P/M/G, grid flexível de widgets com catálogo e persistência no banco de dados, e links canônicos de documentação.
req-227 (BATCH-236): 37 imagens/covers em WebP 1024x1024 (< 98 KB) com identidade visual 3D isométrica unificada.
req-228 (BATCH-237): Topbar administrativa Tailwind com menu dropdown de perfil do usuário e barra persistente de favoritos.
req-229 (BATCH-238): Camada de estado controlado GestorState (gestor_get(), gestor_set(), dot-notation, allowlist imutável e suíte de 28 testes no PHPUnit).

Esta requisição req-230 executa a mesclagem coordenada, resolve a rota estática das capas WebP (eliminando o 404 observado no ambiente local) e roda a validação integrada.

2. Escopo Detalhado da Integração

2.1. Correção Canônica da Rota das Capas dos Módulos

No gestor/modulos/dashboard/dashboard-covers.php:

A função dashboard_capa_modulo_url() deve gerar a URL pública sem o prefixo redundante assets/:
- Retornar: rtrim($urlRaiz, '/').'/modulos/covers/'.$id.'.webp?v='.filemtime($arquivo)
No controlador gestor/controladores/arquivo-estatico/arquivo-estatico.php:
- Assegurar que requisições para modulos/covers/<id>.webp resolvam deterministicamente para o arquivo físico em gestor/assets/modulos/covers/<id>.webp.
- Testar via curl local confirmando HTTP 200 OK na rota [REDACTED].

2.2. Integração e Harmonização dos Componentes do Dashboard

Consolidar a montagem do card em dashboard-cards-tailwind.html:
- Integrar os cards gerados pela req-226 com a tag #modulo-svg# / #modulo-imagem-tag# consumindo a URL corrigida da req-227.
- Assegurar que os atalhos "Adicionar", os links canônicos de docs e os seletores P/M/G funcionem harmonicamente.

2.3. Mesclagem Git das Branches das Frentes

Executar a mesclagem sequencial e limpa para a main:
1. git merge feat/req-229 (camada de estado do kernel)
2. git merge feat/req-228 (topbar e favoritos)
3. git merge feat/req-226 (dashboard P/M/G e widgets)
Resolver eventuais conflitos pontuais em arquivos de índice (CURRENT.md, BATCH-INDEX.md, VALIDATION-CHECKLIST.md).
Atualizar versões em asset-versions.json e executar php cli/c2f.php assets:minify.

2.4. Validação e Execução de Testes

Rodar a suíte completa de testes no PHPUnit: php cli/c2f.php test:run (ou vendor/bin/phpunit).
Confirmar 0 erros de sintaxe (php -l) em todos os arquivos modificados.
Testar no navegador ou via script HTTP se o dashboard carrega sem erros 404 e sem erros de script no console.

3. Critérios de Aceite (Definition of Done)

[x] CA-1 (Capas 200 OK): Todas as capas dos módulos carregam com sucesso (HTTP 200 OK) no Dashboard sem qualquer erro 404.
[x] CA-2 (Branches Integradas): As alterações de req-226, req-227, req-228 e req-229 estão perfeitamente consolidadas na branch main.
[x] CA-3 (Navegação & UI Fluida): A topbar com perfil e favoritos, o seletor P/M/G e as abas do dashboard operam conjuntamente sem sobreposição visual ou quebra de layout.
[x] CA-4 (Suíte de Testes Aprovada): GestorStateTest e os demais testes de regressão do Core passam com 100% de sucesso.
[x] CA-5 (Limpeza de Worktrees): Remoção segura das worktrees temporárias após confirmação da mesclagem limpa.

# req-230 — Integração Oficial da V3.0: Consolidação das Branches (req-226 a req-229), Ajuste Canônico de Rota das Capas e Homologação E2E
- **Status:** `in-review`
- **Modo de Autonomia:** `autonomo_monitorado`
- **Lote Alvo:** `BATCH-239`
- **Data de Criação:** 2026-10-04
- **Repositório:** `conn2flow` (Core) em `[REDACTED]`
- **Origem:** Engenheiro Chefe / Arquiteto Master: Unificação e consolidação das quatro frentes paralelas entregues (`req-226`, `req-227`, `req-228`, `req-229`) na branch `main`.
- **Aviso de Concorrência:** As branches das frentes paralelas (`feat/req-226`, `feat/req-228`, `feat/req-229`) já finalizaram suas execuções isoladas em worktrees. Este lote é a integração harmoniosa no branch `main` do Core.
---
## 1. Contexto e Objetivos
As quatro requisições que compõem o ecossistema do **Dashboard V3.0** e da **Arquitetura de Estado** foram finalizadas com sucesso pelos seus respectivos agentes executores:
- **`req-226` (BATCH-235)**: Grid interativo de módulos P/M/G, grid flexível de widgets com catálogo e persistência no banco de dados, e links canônicos de documentação.
- **`req-227` (BATCH-236)**: 37 imagens/covers em WebP 1024x1024 (< 98 KB) com identidade visual 3D isométrica unificada.
- **`req-228` (BATCH-237)**: Topbar administrativa Tailwind com menu dropdown de perfil do usuário e barra persistente de favoritos.
- **`req-229` (BATCH-238)**: Camada de estado controlado `GestorState` (`gestor_get()`, `gestor_set()`, dot-notation, allowlist imutável e suíte de 28 testes no PHPUnit).
Esta requisição **req-230** executa a mesclagem coordenada, resolve a rota estática das capas WebP (eliminando o 404 observado no ambiente local) e roda a validação integrada.
---
## 2. Escopo Detalhado da Integração
### 2.1. Correção Canônica da Rota das Capas dos Módulos
No [`gestor/modulos/dashboard/dashboard-covers.php`](file:///[REDACTED]):
- A função `dashboard_capa_modulo_url()` deve gerar a URL pública sem o prefixo redundante `assets/`:
  - Retornar: `rtrim($urlRaiz, '/').'/modulos/covers/'.$id.'.webp?v='.filemtime($arquivo)`
- No controlador [`gestor/controladores/arquivo-estatico/arquivo-estatico.php`](file:///[REDACTED]):
  - Assegurar que requisições para `modulos/covers/<id>.webp` resolvam deterministicamente para o arquivo físico em `gestor/assets/modulos/covers/<id>.webp`.
  - Testar via curl local confirmando `HTTP 200 OK` na rota `[REDACTED]`.
### 2.2. Integração e Harmonização dos Componentes do Dashboard
- Consolidar a montagem do card em [`dashboard-cards-tailwind.html`](file:///[REDACTED]):
  - Integrar os cards gerados pela `req-226` com a tag `#modulo-svg#` / `#modulo-imagem-tag#` consumindo a URL corrigida da `req-227`.
  - Assegurar que os atalhos "Adicionar", os links canônicos de docs e os seletores P/M/G funcionem harmonicamente.
### 2.3. Mesclagem Git das Branches das Frentes
- Executar a mesclagem sequencial e limpa para a `main`:
  1. `git merge feat/req-229` (camada de estado do kernel)
  2. `git merge feat/req-228` (topbar e favoritos)
  3. `git merge feat/req-226` (dashboard P/M/G e widgets)
- Resolver eventuais conflitos pontuais em arquivos de índice (`CURRENT.md`, `BATCH-INDEX.md`, `VALIDATION-CHECKLIST.md`).
- Atualizar versões em `asset-versions.json` e executar `php cli/c2f.php assets:minify`.
### 2.4. Validação e Execução de Testes
- Rodar a suíte completa de testes no PHPUnit: `php cli/c2f.php test:run` (ou `vendor/bin/phpunit`).
- Confirmar 0 erros de sintaxe (`php -l`) em todos os arquivos modificados.
- Testar no navegador ou via script HTTP se o dashboard carrega sem erros 404 e sem erros de script no console.
---
## 3. Critérios de Aceite (Definition of Done)
- [x] **CA-1 (Capas 200 OK):** Todas as capas dos módulos carregam com sucesso (HTTP 200 OK) no Dashboard sem qualquer erro 404.
- [x] **CA-2 (Branches Integradas):** As alterações de `req-226`, `req-227`, `req-228` e `req-229` estão perfeitamente consolidadas na branch `main`.
- [x] **CA-3 (Navegação & UI Fluida):** A topbar com perfil e favoritos, o seletor P/M/G e as abas do dashboard operam conjuntamente sem sobreposição visual ou quebra de layout.
- [x] **CA-4 (Suíte de Testes Aprovada):** `GestorStateTest` e os demais testes de regressão do Core passam com 100% de sucesso.
- [x] **CA-5 (Limpeza de Worktrees):** Remoção segura das worktrees temporárias após confirmação da mesclagem limpa.