# Problemas e soluções

Use esta página quando algo parou, sumiu ou ficou estranho.

## Use esta ordem

Quando algo parar:

1. identifique se o erro é de login, leitura, lente de mapa ou atualização;
2. atualize a parte certa no **Ajuda e suporte**;
3. reduza contexto e teste novamente.

Evite começar por ação destrutiva. Em geral, o caminho certo é: atualizar a área, testar com menos contexto e só então pensar em dados locais ou ticket.

## Ir para

- [Ir para suporte](ajuda/suporte) - Siga o fluxo de atualização e abertura de ticket com contexto.
- [Checar ambiente](ajuda/requisitos) - Cheque ambiente, navegador e instalação antes de escalar.
- [Reiniciar dados locais](ajuda/suporte#reiniciar-dados-locais) - Último recurso quando o app fica inconsistente.

## Diagnóstico rápido

Quando o erro aparece, faça este mapa rápido:

1. **Mensagem de erro aparece?**
   - Clique em **Atualizar Astrologic** se o texto continuar repetindo após recarregar.
2. **Tela não abre ou fica branca?**
   - Troque de rede, teste aba anônima, feche e abra novamente.
3. **Falta de mapa, filtro ou botão?**
   - Confirme pasta, filtros e plano antes de assumir bug.

Se passou de 2 tentativas sem resposta estável, siga este plano:

- reduzir contexto (menos técnicas, menos mapas abertos);
- validar fluxo de plano (limite de mapas/técnicas);
- abrir só a ação essencial e confirmar caminho em uma alternativa (Minha interpretação / Feed / Lousa).

Esse fluxo curto evita perder tempo em ações destrutivas (como dados locais) antes do necessário.

> Atualize o Astrologic pelo comando **Atualizar Astrologic** quando a tela parecer desatualizada.

## Antes de mexer em tudo

Antes de editar configurações ou resetar dados, passe por esta checagem curta:

1. **Escopo**: o erro acontece em uma única tela ou em tudo?
2. **Ambiente**: muda em outra rede/dispositivo/navegador?
3. **Atualização**: melhora com `Atualizar Astrologic` ou atualização da área?

Se for escopo único, siga atualização específica da área antes de reiniciar dados locais.

![Seção ajuda](/img/issues/ajuda.png)
_Use Ajuda para atualizar áreas do app, abrir ticket e reunir contexto antes de falar com o suporte._

Use esta página como uma ordem de tentativa. Comece pelas soluções leves. Só reinicie dados locais quando as opções simples não resolverem.

## Regra rápida

- Erro reaparece em uma só página: atualize essa área e não mexa em tudo.
- Lentidão só em celular: reduza técnicas abertas e teste no computador.
- Login inconsistente: teste cookies e domínio correto antes de abrir ticket.

## Antes de abrir ticket

Só vale escalar quando você já consegue responder:

- o erro acontece no mesmo passo toda vez?
- o plano atual inclui esse recurso?
- outra tela na mesma conta funciona?
- rede, extensão, antivírus ou navegador mudaram desde a última sessão estável?

## Primeiro tente isto

1. Feche e abra o Astrologic de novo.
2. Troque a conexão: Wi-Fi para dados móveis, ou dados móveis para Wi-Fi.
3. Veja se outros sites também estão lentos.
4. Atualize o navegador.
5. Use **Ajuda e suporte > Atualizar Astrologic**.
6. Se o problema está só em uma área, use a atualização específica: Feed, Meu arquivo, Mapa do Céu, Pesquisa ou Interpretação.
7. Se continuar, abra um ticket com o caminho para reproduzir o problema.

Evite começar apagando tudo. Em muitos casos, atualizar o app ou a parte afetada já resolve.

## Lentidão

Lentidão pode vir do app, mas também pode vir de rede, memória ou aparelho.

Sintomas comuns:

- mapas demoram para abrir;
- técnicas carregam parcialmente;
- Feed ou Meu arquivo ficam esperando;
- PDF/imagem demora para gerar;
- rolagem fica pesada depois de abrir muitos blocos.

Se for lentidão crítica em consulta, o caminho mais útil é reduzir contexto: feche técnicas, limpe seleção de filtros e reabra apenas a primeira técnica necessária.

Tente:

- fechar abas e apps em segundo plano;
- remover slots e técnicas que não está usando naquele momento;
- abrir menos mapas pesados ao mesmo tempo;
- trocar de rede;
- usar o app em tablet ou computador quando for atender, estudar ou projetar;
- atualizar o app pela área de Ajuda.

Mapas com muitas técnicas, efemérides, linhas de tempo, PDF/imagem e visualizações abertas exigem mais do navegador. Isso pesa mais em celular.

## Não carrega ou fica em branco

Se a tela não abre, fica vazia ou trava logo no início:

1. espere alguns segundos e tente recarregar;
2. feche o app e abra de novo;
3. teste em outra rede;
4. teste em aba privativa/anônima;
5. atualize o navegador;
6. use **Atualizar Astrologic**;
7. se nada resolver, use **Reiniciar dados locais**.

Quando a aba privativa funciona, mas a aba normal não funciona, a causa provável é cache ou dado local preso.

## Prioridade de resposta

- **Alta**: app não entra, área inteira quebrada, perda de mapa importante.
- **Média**: falha de atualização de uma área, PDF/imagem sem gerar, erro de filtro.
- **Baixa**: rótulo, legenda ou comportamento visual pontual.

Use esse nível para explicar o impacto no seu ticket inicial.

## Parece que não atualizou

![Botão de atualizar manualmente na seção ajuda do app](/img/issues/update.png)
_Quando algo parece desatualizado, use Atualizar Astrologic ou atualize apenas a área afetada antes de resetar dados._

O navegador guarda arquivos para abrir o app mais rápido. Às vezes ele segura uma versão antiga por mais tempo do que deveria.

Use **Ajuda e suporte > Atualizar Astrologic** quando:

- uma tela parece diferente da versão atual;
- um botão novo não aparece;
- uma correção já feita não chegou para você;
- o app fica insistindo no mesmo erro;
- a interface parece misturar coisas antigas e novas.

Depois de atualizar, feche e abra o app de novo se a tela continuar estranha.

## Uma área específica está desatualizada

Nem sempre precisa atualizar o app inteiro. Na área de suporte existem ações para partes específicas.

Use:

- **Atualizar feed** quando o Feed não mostra mapas recentes ou fica vazio.
- **Atualizar meu arquivo** quando mapas, nomes, pastas ou buscas do arquivo parecem errados.
- **Atualizar mapa do céu** quando a base pública do Mapa do Céu parece incompleta.
- **Atualizar dados para pesquisa** quando filtros, contagens ou resultados não batem.
- **Atualizar minha interpretação** quando a interpretação editável não recarrega como esperado.

Se a dúvida é sobre ticket, veja [Suporte](suporte).

## Login não entra ou sai sozinho

Confira:

- se o navegador aceita cookies;
- se você não está em uma aba privativa que apaga sessão ao fechar;
- se o relógio do aparelho está correto;
- se a conexão não está oscilando;
- se você está usando o domínio correto do app;
- se extensões de privacidade, bloqueadores ou antivírus não estão interferindo.

Se o login funciona em outro navegador, o problema provavelmente está no navegador original: cache, cookies, extensão ou permissão.

## Dados do mapa parecem errados

Antes de abrir ticket, confira se o problema está no cálculo ou nos dados usados.

Veja no cabeçalho do mapa:

- data;
- hora;
- aviso de **sem hora**;
- local;
- longitude e latitude;
- fuso aplicado;
- fonte do horário;
- se o local veio do Atlas ou foi digitado manualmente.

Se data, hora, local ou fuso estiverem errados, edite o mapa. Se os dados estão corretos, mas o resultado parece errado, abra ticket com o nome do mapa, o que você esperava e o que apareceu.

Veja também:

- [Ler o mapa](ajuda/ler-o-mapa) - Confira dados, mandala, posições, aspectos e origem do cálculo.
- [Editar mapa](ajuda/editar-mapa) - Corrija data, hora, local, fuso, pasta e dados do mapa.
- [Atlas](ajuda/atlas) - Entenda cidade, coordenadas, fuso e fonte do horário.

## Pesquisa não mostra o que eu esperava

Em Pesquisa, confira:

- se está pesquisando no **Meu arquivo**;
- se os filtros ativos fazem sentido juntos;
- se usou filtro demais ao mesmo tempo;
- se está usando busca por nome ou filtros astrológicos;
- se a base foi atualizada em **Atualizar dados para pesquisa**.

Algumas combinações de filtros retornam poucos mapas mesmo quando a base é grande.

Veja [Pesquisa](pesquisa).

## Feed ou Lousa não abriram o mapa

Se você usou **abrir no feed** ou **lousa** e não viu o mapa:

- confirme se a área abriu na mesma conta;
- veja se o limite do plano foi atingido;
- atualize o Feed ou a Lousa;
- tente abrir o mapa pela versão completa e repetir a ação;
- confira se o mapa não foi apagado, movido ou perdeu acesso.

Veja também:

- [Feed de mapas](ajuda/feed-de-mapas) - Use o fluxo de mapas em sequência e entenda limites por plano.
- [Lousa de mapas](ajuda/lousa-de-mapas) - Organize mapas em uma área visual e veja ações disponíveis.

## PDF ou imagem falhou

PDF e imagem dependem do navegador, do tamanho do mapa e do plano.

Tente:

- fechar técnicas que não precisam entrar na imagem;
- gerar primeiro uma imagem mais simples;
- usar tablet ou computador em mapas grandes;
- atualizar o app;
- conferir se o recurso está disponível no seu plano.

Veja [PDF e imagem](pdf-e-imagem).

## Reiniciar dados locais

![Reiniciar os dados locais](/img/issues/wipe.png)
_Reiniciar dados locais é último recurso: use quando atualização da área e recarregamento não resolverem._

Use **Reiniciar dados locais** só quando o app estiver realmente instável: telas quebradas, erros repetidos, módulos que não carregam ou comportamento estranho mesmo depois de atualizar.

Essa ação limpa dados guardados no aparelho, como cache, preferências locais e conteúdos baixados para acelerar o app. Ela não apaga seus mapas salvos no servidor, mas pode obrigar o app a baixar tudo de novo.

Caminho:

**Ajuda e suporte > Suporte > Reiniciar dados locais**

Se você está usando direto pelo navegador, também pode acessar:

https://astrologicgo.app/pt/go/login/wipe

Depois disso, entre novamente e teste o caminho que falhava.

## Internet e horários de pico

À noite, especialmente entre o fim do expediente e o horário nobre, redes móveis e Wi-Fi doméstico podem ficar mais congestionados.

Se o app fica lento só nesses horários:

- teste outra rede;
- carregue mapas e técnicas antes do atendimento ou aula;
- evite abrir muitas técnicas novas durante a sessão;
- mantenha os mapas importantes já preparados.

Técnicas e visualizações já abertas podem ficar disponíveis mais rápido no aparelho, dependendo do cache local.

## Quando pode ser instabilidade externa

O Astrologic usa serviços externos de rede e proteção, como Cloudflare. Em falhas desse tipo, o app pode parecer fora do ar mesmo quando o problema é temporário e afeta vários sites.

Sinais:

- outros sites também falham;
- erro aparece antes mesmo do login;
- a página mostra mensagem de rede, proteção ou indisponibilidade;
- o problema some depois de alguns minutos.

Nesses casos, aguarde um pouco, teste outra rede e tente novamente.

## Abrir ticket

Abra ticket quando:

- o problema continua depois de atualizar;
- você consegue repetir o erro;
- há diferença entre o cálculo esperado e o resultado;
- uma ação salva errado;
- uma área importante ficou inacessível;
- você precisa que o suporte veja seu caso.

No ticket, envie:

- onde aconteceu;
- o caminho do clique;
- nome ou número do mapa, se houver;
- o que você esperava;
- o que apareceu;
- navegador e aparelho;
- imagem da tela, se a opção estiver disponível.

Veja [Suporte](suporte) para aprender a abrir e acompanhar tickets.