Troubleshooting

Problemas de Ambiente

Ambiente não está acessível

Sintoma: Não consigo acessar o ambiente de testes.

Possíveis causas:

1. VPN não conectada
2. Ambiente em manutenção
3. Credenciais expiradas

Soluções:

1. Verifique conexão VPN
2. Consulte canal de status/infra
3. Renove credenciais de acesso

---

Dados de teste não encontrados

Sintoma: Usuário/dados de teste não existem no ambiente.

Possíveis causas:

1. Ambiente foi resetado
2. Dados foram limpos
3. Ambiente errado

Soluções:

1. Execute script de seed de dados
2. Crie dados manualmente
3. Verifique se está no ambiente correto

Problemas de Automação

Teste falha por timeout

Sintoma: Teste falha esperando elemento que não aparece.

Possíveis causas:

1. Elemento mudou de seletor
2. Página está lenta
3. Fluxo do sistema mudou

Soluções:

1. Verifique se o seletor está correto
2. Aumente o timeout (com moderação)
3. Revise o fluxo e atualize o teste

---

Teste passa localmente mas falha no CI

Sintoma: Teste funciona na máquina local mas falha no pipeline.

Possíveis causas:

1. Diferença de ambiente
2. Diferença de resolução/viewport
3. Race condition
4. Dados diferentes

Soluções:

1. Verifique variáveis de ambiente
2. Configure viewport fixo nos testes
3. Adicione esperas explícitas
4. Use dados de teste isolados

---

Elemento não encontrado

Sintoma: Element not found ou similar.

Possíveis causas:

1. Seletor incorreto
2. Elemento está em iframe
3. Elemento é renderizado dinamicamente
4. Elemento está oculto

Soluções:

// 1. Verifique o seletor no DevTools
// 2. Para iframes:
cy.iframe('[data-testid="my-iframe"]').find('[data-testid="element"]')

// 3. Para elementos dinâmicos:
cy.get('[data-testid="element"]', { timeout: 10000 })

// 4. Para elementos ocultos:
cy.get('[data-testid="element"]').should('exist') // não precisa estar visível

Problemas de Documentação

Sidebar não mostra novo roteiro

Sintoma: Criei um roteiro mas não aparece no menu.

Solução:

1. Adicione a entrada em docs/.vitepress/config.ts
2. Reinicie o servidor dev (npm run dev)

---

Busca não encontra conteúdo

Sintoma: Busca não retorna resultados esperados.

Possíveis causas:

1. Índice de busca desatualizado
2. Conteúdo em frontmatter (não indexado por padrão)

Soluções:

1. Faça build e preview (npm run build && npm run preview)
2. Coloque termos importantes no corpo do documento, não só no frontmatter

---

Frontmatter não renderiza

Sintoma: aparece como texto.

Solução: Verifique se o arquivo está em .md e se a sintaxe do frontmatter está correta (três hífens no início e fim).

Contatos

Área	Canal
Infra/Ambientes	#infra-suporte
Automação	#qa-automacao
Dúvidas gerais	#qa-geral