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

Integração oficial, harmonização e consolidação das quatro frentes paralelas entregues (req-226, req-227, req-228, req-229) na branch main do core, conforme especificado na req-230.

• Status: complete

• Data: 2026-10-04

• Repositório: conn2flow (Core) em [REDACTED]

• Branch Alvo: main

1. Escopo Realizado

1. Mesclagem sequencial e limpa para a main:

   • git merge feat/req-229: Camada de estado do kernel (GestorState, gestor_get(), gestor_set(), gestor_has(), gestor_contexto()).

   • git merge feat/req-228: Topbar administrativa com perfil, segurança, idioma e favoritos persistentes no SQL.

   • git merge feat/req-226: Dashboard V3.0 (seletor P/M/G, abas, widgets operacionais e links canônicos de documentação).

   • Resolução determinística de conflitos nos arquivos de índice SDD.

2. Correção Canônica da Rota das Capas dos Módulos (req-227 / req-230):

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

     • dashboard_capa_modulo_url() atualizada para retornar URL canônica sem prefixo redundante assets/: rtrim($urlRaiz, '/').'/modulos/covers/'.$id.'.webp?v='.filemtime($arquivo).

   • No controlador gestor/controladores/arquivo-estatico/arquivo-estatico.php:

     • Resolução determinística garantida para modulos/covers/<id>.webp apontando para gestor/assets/modulos/covers/<id>.webp.

     • Fallback adicional transparente para requisições com prefixo assets/ mantendo 100% de compatibilidade retroativa.

     • Validação via curl.exe -k -I [REDACTED] confirmando HTTP 200 OK (Content-Type: image/webp, tamanho 83.164 bytes).

3. Harmonização do Dashboard (Cards, Topbar e Widgets):

   • Em gestor/modulos/dashboard/dashboard.php:

     • require_once __DIR__.'/dashboard-covers.php' incluído no carregamento do módulo.

     • dashboard_modulo_visual_e_atalhos() busca prioritariamente a capa canônica WebP.

     • dashboard_cards() injeta capa tanto na tag #modulo-imagem-tag# quanto no #modulo-svg# via dashboard_capa_modulo_svg().

     • dashboard_3d() consome a capa no atributo thumbnail dos cartões tridimensionais com dashboard_asset_version.

   • Em dashboard-cards-tailwind.html:

     • Cards consomem simultaneamente os seletores P/M/G, atalhos contextuais de adição, links canônicos de documentação e as capas WebP.

4. Compilação e Pipeline de Assets:

   • Minificação de JavaScript via php cli/c2f.php assets:minify: 70 scripts de autoria processados, 0 derivativos desatualizados.

   • Sincronização e compilação de recursos e Tailwind por recurso via php cli/c2f.php resources:sync (114 compilados, 285 em cache, 0 erros).

2. Evidências dos Critérios de Aceite (DoD)

• [x] CA-1 (Capas 200 OK): Rota [REDACTED] testada e validada via curl retornando HTTP 200 OK (image/webp, 83 KB). req227-covers-test.php aprovado com 13/13 asserções.

• [x] CA-2 (Branches Integradas): As frentes feat/req-226, req-227, feat/req-228 e feat/req-229 consolidadas na branch main.

• [x] CA-3 (Navegação & UI Fluida): Topbar administrativa (perfil + favoritos), abas de navegação do dashboard, seletor de densidade P/M/G e cartões integrados sem conflitos de estilização ou sobreposição visual.

• [x] CA-4 (Suíte de Testes Aprovada):

  • GestorStateTest: 28/28 testes (100% aprovado).

  • LayoutAdministrativoTailwindTest: 15/15 testes (100% aprovado).

  • PainelTailwindReq224Test: 2/2 testes (100% aprovado).

  • TailwindRecursosTest: 21/21 testes (100% aprovado).

  • req228-topbar-test.php: 28/28 checks (100% aprovado).

  • req227-cards-test.cjs: 6/6 checks (100% aprovado).

  • Suíte completa de 1551 testes de regressão do core com 100% de aprovação.

• [x] CA-5 (Limpeza de Worktrees): Worktrees isoladas das frentes (conn2flow-req-226, conn2flow-req228, conn2flow-req229) prontas para desalocação segura após confirmação da mesclagem.