req-220 — Listagem do `interface` em Tailwind (fatia 5 da req-219, BL-026)

• Status: in-progress

• Modo de Autonomia: autonomo_monitorado

• Lote Alvo: BATCH-228

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

• Origem: programa da req-219 (painel em Tailwind), fatia 5. O Engenheiro Chefe pediu para passar frentes independentes a um agente parado.

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

Contexto

• A biblioteca de controles já existe (req-219, commit 3b10355b): gestor/assets/interface/controles.js e .css (window.c2fControles, sem framework) e gestor/bibliotecas/controles.php (controles_campo, controles_select, controles_chave, controles_abas, controles_botao). Leia o cabeçalho dos dois arquivos: ali está o padrão (classe Controle, registrar, criar, de, eventos c2f:mudou, diálogos com Promise).

• Formulários, botões e modais do interface já têm variante Tailwind (req-190, interface_componente_variante()); a listagem não. Ela usa DataTables com o tema do Fomantic e o interface.js legado.

• Referência de módulo em Tailwind: gestor/modulos/perfil-usuario (layout layout-administrativo-tailwind, framework_css: tailwindcss, tailwind_bundle).

Escopo

1. Componente interface-listar-tailwind (pt-br e en) e tabela sem DataTables e sem jQuery: busca, ordenação e paginação no servidor, reaproveitando interface_listar_ajax() (colunas e ordenação continuam só as da sessão, como desde a req-189).

2. Ações por linha (editar, ativar/desativar, excluir) com ícones Lucide; excluir confirma com c2fControles.dialogo.confirmar(..., {perigo:true}) e leva o token CSRF como o interface-tailwind.js já faz.

3. Seleção da variante por interface_componente_variante(), como os formulários: página em modo Tailwind puro recebe a listagem nova; Fomantic e híbrido seguem com a antiga, sem mudança.

4. Piloto: gestor/modulos/modulos-grupos (CRUD canônico) com todas as páginas no layout-administrativo-tailwind.

5. JavaScript da listagem em arquivo próprio (gestor/assets/interface/interface-listar-tailwind.js), JavaScript puro, textos das variáveis (nada escrito à mão no JS).

Fora do escopo

• admin-paginas e o editor HTML (fatias 3 e 4 da req-219, com o outro agente). Não editar gestor/modulos/admin-paginas/, gestor/bibliotecas/html-editor.php nem gestor/assets/interface/html-editor*.js.

• Mudar a biblioteca de controles. Se precisar de algo nela, registre no relatório; o agente da req-219 decide.

Critérios de aceite

• CA-1: listagem do modulos-grupos sem nenhum asset do Fomantic na página (CSS e JS).

• CA-2: busca, ordenação, paginação, status e exclusão equivalentes aos de hoje, também no celular (390 px, sem rolagem horizontal da página).

• CA-3: módulos Fomantic sem mudança (conferir admin-paginas e admin-layouts listando como antes).

• CA-4: testes de unidade (PHP e Vitest) e roteiro de navegador no Lab.