{"v":{"area":"admin","slug":"ajudas-paginas","path":"/home/tiixcom/public_html/sistema/docs/readme/admin/ajudas-paginas.md","relative_path":"docs/readme/admin/ajudas-paginas.md","title":"Ajudas de Paginas","html":"<h1>Ajudas de Paginas</h1><h2>Rota</h2><ul><li><code>/adm/ajudas-paginas</code></li></ul><h2>O que e</h2><p>Console administrativo para inventariar e editar ajudas contextuais das paginas do sistema.</p><p>A tela consolida tres fontes:</p><ul><li>registros do Guia vinculados por <code>wpjy_guide_page_map</code>;</li><li>ajuda legada de <code>wpjy_telas.ajuda</code>;</li><li>READMEs contextuais em <code>docs/readme/{area}/{slug}.md</code>.</li></ul><h2>Para que serve</h2><ul><li>descobrir rapidamente quais paginas ja possuem ajuda no Guia;</li><li>localizar ajudas legadas que ainda precisam ser importadas;</li><li>identificar READMEs contextuais existentes;</li><li>editar uma ajuda sem abrir a pagina original;</li><li>importar ajudas legadas em lote por recorte;</li><li>criar ajuda do Guia a partir do README contextual quando a pagina ainda nao tiver base viva;</li><li>revisar ajuda legada no editor antes de salvar no Guia quando a fila pedir mais cuidado;</li><li>persistir status editorial, prioridade, responsavel e observacoes por fila da pagina;</li><li>reduzir a necessidade de entrar tela por tela e clicar em ajuda para auditar conteudo.</li></ul><h2>Layout</h2><ul><li>hero com indicadores de fontes encontradas e fila editorial aberta;</li><li>toolbar com busca livre, filtro de fonte, filtro de fila, contexto e limite;</li><li>filtros persistidos na URL para abrir filas editoriais diretamente do Guia;</li><li>lista densa de paginas, preparada para alto volume;</li><li>painel lateral com bloco proprio para governar a fila editorial da pagina selecionada;</li><li>painel lateral com preview da ajuda resolvida;</li><li>modal de edicao para salvar o conteudo como artigo do Guia e vincular ao page map.</li></ul><h2>Filas editoriais</h2><p>A tela tambem aceita filtros pela query string para abrir filas prontas a partir da governanca do Guia.</p><p>Exemplos uteis:</p><ul><li><code>/adm/ajudas-paginas?source=legacy_without_guide</code></li><li><code>/adm/ajudas-paginas?source=readme_without_guide</code></li><li><code>/adm/ajudas-paginas?source=guide_without_readme</code></li></ul><p>Os parametros suportados nesta camada sao:</p><ul><li><code>source</code></li><li><code>queue_status</code></li><li><code>q</code></li><li><code>context</code></li><li><code>limit</code></li><li><code>url</code></li></ul><p>Isso permite compartilhar recortes prontos e transformar o painel de governanca do Guia em fluxo de trabalho editorial real.</p><h2>Fontes e decisao editorial</h2><p>O modelo recomendado e hibrido:</p><ul><li>README fica como documentacao versionada, util para devs e manutencao;</li><li>banco do Guia fica como fonte viva para consulta dentro do produto;</li><li><code>wpjy_guide_page_map</code> conecta pagina, artigo, checklist, destaque e link;</li><li>seeds mantem conteudo essencial reproduzivel entre ambientes.</li></ul><h2>Endpoints usados</h2><ul><li><code>/adm/api/GuidePageHelpAdmin/inventory</code></li><li><code>/adm/api/GuidePageHelpAdmin/help</code></li><li><code>/adm/api/GuidePageHelpAdmin/upsertHelp</code></li><li><code>/adm/api/GuidePageHelpAdmin/saveQueue</code></li><li><code>/adm/api/GuidePageHelpAdmin/importLegacy</code></li><li><code>/adm/api/GuidePageHelpAdmin/importReadme</code></li><li><code>/adm/api/GuidePageHelpAdmin/importLegacyBatch</code></li></ul><h2>Observacoes</h2><ul><li>o contexto padrao exibido na UI e <code>help.modal</code>, normalizado internamente como <code>helpmodal</code>;</li><li>a importacao em lote nao sobrescreve ajudas que ja existem no Guia;</li><li>a criacao assistida por README usa o titulo e o HTML resolvido do Markdown contextual para gerar artigo e <code>page_map</code> com o minimo de retrabalho;</li><li>a revisao assistida de legado abre o editor ja preenchido com o conteudo do campo <code>wpjy_telas.ajuda</code>, permitindo limpar e publicar com mais criterio;</li><li>a fila editorial persistida usa a tabela <code>wpjy_guide_editorial_queue</code> para guardar status, prioridade, responsavel e observacoes por pagina, contexto e tipo de lacuna;</li><li>ao salvar ou importar ajuda para o Guia, as filas ligadas a ausencia de base viva (<code>without_guide</code>, <code>legacy_without_guide</code> e <code>readme_without_guide</code>) podem ser marcadas como resolvidas automaticamente;</li><li>o seed <code>sql/2026-04-23-seed-guia-ajudas-paginas.sql</code> adiciona orientacoes e page maps para esta area no Guia.</li></ul>"},"exp":1780849734}