Execução da req-186.
Status: implemented. Validado no Lab; falta o commit do repositório conn2flow-site (o stage dos ~195 arquivos foi barrado pela política de permissões da sessão e ficou para o Humano).
Entregas
-
Core,
c2f docs:build:-
lê a configuração de
modulos/documentation/documentation.json(chavedocs) quando existir; senão, odocs.config.jsonantigo; -
com
docs.moduledefinido, as páginas geradas levammodule(dono no banco) e os templates são procurados primeiro nos recursos do módulo; -
grava
modulos/<modulo>/documentation.status.jsoncom o resumo da geração (commit do core, data, contagens, avisos), só quando algo mudou.
-
-
Site, módulo
documentation:-
manifesto com a configuração das docs;
-
templates
docs-article/docs-sidebarmovidos para o módulo; -
página administrativa
documentation/(estado da última geração, sem regenerar), com os textos em variáveis; -
registro em
ModulosData(grupoadministracao-sistema) eUsuariosPerfisModulosData(administradores); -
docs.config.jsonremovido.
-
-
Site, migração
20260926120000_move_docs_to_documentation_module.php:-
UPDATE paginas SET modulo='documentation'nas páginas globaisdocs/docs-*, preservandoid_paginase edições; mesmas URLs; -
a tabela
templatesnão tem colunamodulo: oresources:syncpublica os templates do módulo como globais de mesmo id, e não há o que migrar. A primeira versão da migração tentava atualizá-la e falhou no Lab (Unknown column 'modulo').
-
Commits
-
Core:
bd1b184d(docs:build com módulo dono e status),615170b7(guia e referência),7c480e5e(correções achadas no deploy, ver BATCH-191). -
Site (
feat/req-055): pendente. Arquivos:gestor/modulos/documentation/, a migração, os templates movidos,docs.config.jsonremovido,resources/*/templates.json,db/data/*, páginas e publicações regeneradas,assets/docs/llms*.txt.
Validação
-
PHPUnit das docs: 24 testes / 393 asserções OK (inclui
testModuloDonoConfiguracaoTemplatesEStatus). -
docs:build: "Configuration: modulos/documentation/documentation.json", 320 páginas, status gravado. -
Lab
[REDACTED]:-
project:update-all8/8 OK, depois de dois contornos: migração corrigida e, uma vez,project:sync-filesseguido deproject:sync-db, por causa da colisão emmenusdescrita no BL-023; -
banco: 184 páginas de docs em pt-br e 136 em en, todas com
modulo='documentation'euser_modified=0; páginadocumentationnos dois idiomas; módulo e permissão aplicados; templatesdocs-*presentes; -
/documentation/(autenticado) 200, sem erros de console: 320 páginas geradas, 305 publicações, 5 páginas de entrada, 26 avisos, commit615170b7com link, 169 arquivos alterados, 184 páginas no banco (pt-br), 0 editadas; -
/en/documentation/200, título "Documentation", 136 páginas.
-
-
Achados no deploy e corrigidos no BATCH-191:
auth:cookiepor [REDACTED] a partir do Windows, e o título da tela mostrando "Checkout" (variável de outro módulo).