{"v":{"area":"admin","slug":"dev-previews","path":"/home/tiixcom/public_html/sistema/docs/readme/admin/dev-previews.md","relative_path":"docs/readme/admin/dev-previews.md","title":"Ambientes de teste","html":"<h1>Ambientes de teste</h1><p>A rota <code>/adm/dev-previews</code> permite publicar uma branch autorizada em quatro slots isolados. Os três slots gerais abrem na raiz; <code>preview-app</code> identifica o perfil do app cliente e abre em <code>/cliente</code>. Escolha o repositório mapeado, a branch e a validade (24, 48, 72 ou 168 horas). O backend congela os SHAs da fonte e da base; o console mostra apenas logs sanitizados.</p><h2>Acesso dos desenvolvedores</h2><p>O desenvolvedor entra no painel com sua conta normal do Dashboard. A conta precisa das permissoes <code>dev-previews.ver</code> e <code>dev-previews.publicar-proprio</code>; as acoes administrativas possuem permissoes separadas. Se o menu nao aparecer ou a rota retornar acesso negado, um administrador deve revisar o perfil/permissoes da conta — nao compartilhe uma conta administrativa.</p><p>O login dentro de cada preview e isolado do Dashboard e da producao. Quando o slot estiver pronto, use <strong>Entrar como eu</strong>: o Dashboard emite um ticket descartavel com validade de 60 segundos e o preview cria ou reutiliza uma identidade tecnica local. Senhas, hashes, cookies e sessoes de <code>dash.tiix.com.br</code>, <code>teste.tiix.com.br</code> ou producao nunca sao copiados.</p><h2>Fluxo de uso</h2><ol><li>Abra <code>/adm/dev-previews</code>, escolha um slot disponivel e clique em <strong>Testar branch</strong>.</li><li>Nos slots <code>preview-01</code> a <code>preview-03</code>, selecione um repositorio mapeado. No <strong>App Cliente</strong>, somente <code>AM-TIIX/tiix-pages-cliente</code> e aceito.</li><li>Escolha a branch, a validade e publique. Use <strong>Console</strong> ate a execucao terminar como <code>success</code>.</li><li>Clique em <strong>Entrar como eu</strong> para abrir uma nova aba ja autenticada. O App Cliente segue para <code>https://preview-app.tiix.com.br/cliente</code>; os slots gerais seguem para <code>/adm</code>.</li><li>Ao terminar, clique em <strong>Liberar slot</strong>. Nao use dados pessoais ou credenciais reais durante o teste.</li></ol><p>O botao aparece para colaboradores autenticados que tenham <code>dev-previews.ver</code>, apenas quando o slot esta pronto. O perfil local <code>preview_developer</code> existe somente no banco isolado do slot. Para cenarios que dependam de contrato, corretora ou outra persona, use exclusivamente as fixtures sanitizadas de teste; a identidade tecnica nao concede contexto real de producao.</p><p><code>teste.tiix.com.br</code> continua sendo o ambiente integrado compartilhado. Ele pode validar uma alteracao depois que os componentes forem integrados, mas nao substitui os slots isolados para testar branches antes do merge.</p><p>O dono pode atualizar, abrir e liberar o próprio slot. Migrations ficam desligadas por padrão, exigem permissão específica e criam snapshot. Rollback, reset de banco e override de checks também dependem de permissões. O reset exige confirmação e usa somente o template sanitizado. Slots expiram automaticamente; o limite é sete dias.</p><p>Não é permitido informar repositório, caminho ou SHA livremente. Preview não envia e-mail, não usa Asaas de produção, não compartilha banco/cookies/filas e não substitui homologação ou produção.</p>"},"exp":1792622418}