{"v":{"area":"admin","slug":"ferramentas","path":"/home/tiixcom/public_html/sistema/docs/readme/admin/ferramentas.md","relative_path":"docs/readme/admin/ferramentas.md","title":"Ferramentas Admin","html":"<h1>Ferramentas Admin</h1><h2>O que e</h2><p>Tela tecnica para acompanhar e executar migrations SQL versionadas do sistema.</p><h2>Para que serve</h2><ul><li>Consultar migrations encontradas em <code>sql/</code>.</li><li>Ver quais foram aplicadas, quais estao pendentes e quais possuem alerta.</li><li>Simular execucao sem aplicar SQL.</li><li>Registrar baseline quando SQL antigos ja foram executados manualmente.</li><li>Rodar migrations pendentes com controle e historico.</li></ul><h2>Blocos da tela</h2><ul><li>Hero: contextualiza o controle operacional de migrations.</li><li>KPIs: mostram total, aplicadas, pendentes e alertas.</li><li>Migrations SQL: tabela operacional com status, arquivo, tentativas, ultima execucao e erro.</li><li>Log de execucoes: tabela operacional com historico por tentativa, batch, inicio, fim e erro.</li><li>Modal de resultado: exibe retorno detalhado de simulacao, baseline ou execucao.</li></ul><h2>Botoes</h2><ul><li>Atualizar: recarrega status e historico.</li><li>Rodar pendentes: executa migrations pendentes apos confirmacao.</li><li>Simular: faz dry-run sem aplicar SQL.</li><li>Baseline: marca arquivos anteriores a uma data como aplicados.</li><li>Primeira execucao: aparece apenas quando o controle esta vazio e existem pendencias.</li><li>Atualizar log: recarrega somente o historico de execucoes.</li></ul><h2>Observacoes</h2><ul><li>As duas tabelas usam DataTable e sao recriadas somente quando existem linhas reais.</li><li>Estados vazios continuam renderizados como mensagem simples para evitar erro de colspan no DataTable.</li><li>Use baseline com cuidado: ela registra aplicacao sem executar SQL.</li></ul>"},"exp":1780849801}