Conn2Flow
Navegação das docs

SDD

req-223 — Módulos de administração em Tailwind (fatia 6 da req-219)

Módulos admin-arquivos, admin-categorias, admin-ia, admin-modos-ia, admin-prompts-ia, admin-plugins, admin-atualizacoes, admin-environment e variables (o admin-cron já é…

  • Status: ready-for-intake

  • Modo de Autonomia: autonomo_monitorado

  • Lote Alvo: BATCH-232

  • Data de Criação: 2026-10-04

  • Origem: programa da req-219. O Engenheiro Chefe pediu para dividir os demais módulos entre os agentes disponíveis: "quero usar [vocês] o máximo que der… depois eu venho tudo de uma vez testando".

  • Executor: agente paralelo. O agente da req-219 mantém os índices e revisa.

Contexto

  • Programa da req-219 (painel em Tailwind), fatia 6. As fatias 1 a 4 estão prontas no BATCH-227: biblioteca de controles sem framework com ponte para a API do Fomantic, editor HTML e admin-paginas em Tailwind. A fatia 5 (listagem sem DataTables) está na req-220 / BATCH-228.

  • Leia primeiro a skill c2f-tailwind-module-migration (passo a passo, regras e trava do Lab) e use o admin-paginas como referência viva (commits 7cf44d27 e 435fd83c).

  • O Engenheiro Chefe pediu as frentes em paralelo e faz os testes manuais todos no fim: valide com testes automatizados e navegador no Lab e registre o roteiro humano em conn2flow-site/sdd/PENDENCIAS-HUMANAS.md (item do roteiro único da req-219).

  • Trabalhe numa worktree própria (git worktree add ../conn2flow-req223 -b feat/req-223 origin/main). Commit por caminho explícito; nada de git add -A.

Escopo

  1. Módulos admin-arquivos, admin-categorias, admin-ia, admin-modos-ia, admin-prompts-ia, admin-plugins, admin-atualizacoes, admin-environment e variables (o admin-cron já é Tailwind).

  2. Atenção ao admin-arquivos: ele também abre dentro do iframe do seletor de imagem (?paginaIframe=sim) e responde por postMessage (moduloId: 'admin-arquivos', dados com tipo, id, caminho, imgSrc, nome, data). Esse contrato é o que o imagepick do interface e o do editor HTML esperam: não pode mudar.

  3. Widget configuracao_administracao (gestor/bibliotecas/configuracao.php e o JS dele): usado por variables, admin-environment e pela tela de variáveis do modulos (modulos-variaveis, deixada pela req-224). Migre o widget uma vez, com variante, e as três telas juntas.

  4. admin-atualizacoes e admin-environment mexem em configuração do sistema: nada de executar atualização real ou gravar .env para validar; use as telas e os testes de unidade.

Fora do escopo (pedir no relatório ao dono da req-219)

  • Biblioteca de controles (gestor/assets/interface/controles.*, gestor/bibliotecas/controles.php), gestor/bibliotecas/interface.php e a listagem (req-220).

  • Página raiz (listagem) de cada módulo: migra só depois do BATCH-228 em main. Se ele chegar antes do fim do seu lote, migre a raiz também.

  • Módulos de outras frentes: req-221 (publisher), req-222 (menus, galerias, formulários, cookies), req-223 (administração), req-224 (usuários e módulos), BATCH-229 da req-219 (admin-layouts, admin-componentes, admin-templates).

Critérios de aceite

  • CA-1: páginas de incluir, editar e demais opções de cada módulo no layout-administrativo-tailwind, sem JavaScript nem CSS do Fomantic no documento do painel.

  • CA-2: tudo o que a tela faz hoje continua funcionando (salvar sem 403, selects, chaves, abas, modais, uploads e AJAX do módulo), também a 390 px sem rolagem horizontal.

  • CA-3: nenhum alert, confirm ou prompt nativo nos módulos da frente.

  • CA-4: teste PHP de contrato (variantes x originais, metadados, HTML sem class="ui), Vitest se mexer em JS e roteiro Playwright no Lab; suíte completa sem regressão nova.

  • CA-5: relatório do lote em sdd/implementation/BATCH-232.md e pendência humana no arquivão do site.

O Futuro é Híbrido: Humano + IA.

O Conn2Flow é a ferramenta. Se você precisa do Arquiteto para desenhar a estratégia da sua empresa usando essa tecnologia...

Contrate Consultoria Especializada