Pular para conteúdo

Solução de Problemas

Encontrou um problema? Veja as soluções abaixo.

Problemas Comuns

Busca não retorna resultados

Sintoma: Busca vazia ou "Nenhum resultado encontrado"

Soluções:

  1. Verifique a ortografia
  2. Use 3+ caracteres
  3. Tente palavras diferentes
  4. Limpe o cache do navegador
  5. Recarregue a página

Problema temporário?

Se o problema persistir, pode ser uma questão temporária de indexação. Aguarde alguns minutos.

Página não carrega

Sintoma: Tela branca ou erro 500

Soluções:

  1. Recarregue a página (++ctrl+r++ ou ++cmd+r++)
  2. Limpe o cache: ++ctrl+shift+del++
  3. Tente outro navegador
  4. Desative extensões (modo anônimo)
  5. Verifique sua conexão de internet

Imagens não aparecem

Sintoma: Capas de hinários não carregam

Soluções:

  1. Aguarde carregamento completo
  2. Recarregue a página
  3. Verifique se extensões bloqueiam imagens (AdBlock)
  4. Limpe o cache

Login não funciona

Sintoma: "Email ou senha incorretos"

Soluções:

  1. Verifique o Caps Lock
  2. Tente recuperar senha
  3. Use login social (Google)
  4. Limpe cookies do site

Upload falha

Sintoma: Erro ao fazer upload de YAML

Soluções:

  1. Verifique tamanho do arquivo (máximo 10MB)
  2. Valide a estrutura do YAML em yamllint.com
  3. Verifique campos obrigatórios
  4. Tente navegador diferente

Erros comuns no YAML:

# ERRADO - falta campo name
owner_name: "João"
hymns: []

# CORRETO
name: "Hinário do João"
owner_name: "João"
hymns: []

Áudio não toca

Sintoma: Player não reproduz

Soluções:

  1. Verifique volume do sistema e do player
  2. Tente outro navegador
  3. Verifique se há bloqueador de áudio
  4. Recarregue a página
  5. Limpe o cache

Favoritos não salvam

Sintoma: Clico em favoritar mas não funciona

Soluções:

  1. Verifique se está logado
  2. Recarregue a página e tente novamente
  3. Verifique console do navegador (F12)

Notificações não aparecem

Sintoma: Não recebo notificações

Soluções:

  1. Verifique configurações de notificação no perfil
  2. Verifique se o navegador permite notificações
  3. Limpe o cache

Reportar Problema

Se nenhuma solução funcionou:

1. Verifique Issues Existentes

Acesse GitHub Issues e busque pelo problema.

2. Crie Novo Issue

Se não encontrou, crie um novo issue com:

Informações necessárias:

  • [ ] Descrição clara do problema
  • [ ] Passos para reproduzir
  • [ ] Comportamento esperado vs. atual
  • [ ] Screenshots (se aplicável)
  • [ ] Navegador e versão
  • [ ] Sistema operacional

Template:

## Descrição
[Descreva o problema]

## Passos para Reproduzir
1. Vá para '...'
2. Clique em '...'
3. Veja o erro

## Comportamento Esperado
[O que deveria acontecer]

## Comportamento Atual
[O que está acontecendo]

## Screenshots
[Anexe imagens se relevante]

## Ambiente
- Navegador: Chrome 120
- Sistema: macOS 14.0

Contato Direto

Para problemas urgentes:

Dicas Gerais

Limpar Cache

++ctrl+shift+del++ → Selecione "Imagens e arquivos em cache" → Limpar

++ctrl+shift+del++ → Selecione "Cache" → Limpar

Develop → Empty Caches

Modo Anônimo

Testar em modo anônimo ajuda a identificar se o problema é causado por extensões:

++ctrl+shift+n++

++ctrl+shift+p++

++cmd+shift+n++