# Primeiros passos

O **Astrologic Go** é um ambiente de trabalho para criar mapas, consultar mapas públicos, pesquisar padrões, abrir técnicas, montar apresentações, exportar imagens/PDFs e organizar interpretações.

Se você está começando, não tente conhecer tudo de uma vez. O caminho mais simples é: configurar a base, criar ou abrir um mapa, conferir os dados e só depois decidir se vai seguir por versão completa, Feed ou Lousa.

## Use esta ordem

1. complete a **Configuração básica**;
2. crie ou abra um mapa;
3. valide data, hora e local;
4. escolha **versão completa**, **Feed** ou **Lousa**;
5. só depois abra técnicas, pesquisa e personalizações.

Se algo já parecer estranho nessa etapa, pare e confira os dados antes de seguir. O erro mais comum no começo é aprofundar leitura em mapa salvo com hora, local ou fuso errados.

## Como avançar daqui

- [Mapa completo](ajuda/novo-mapa) - Comece cadastrando um mapa corretamente.
- [Leitura inicial](ajuda/ler-o-mapa) - Valide cabeçalho, mandala e posicionamento antes de ampliar.
- [Problemas agora](ajuda/problemas-solucoes) - Se algo travar, aplique diagnóstico de 30 segundos antes de editar mais.

![Início do Astrologic Go](/img/inicio/geral.png)
_A Home reúne atalhos para mapa, arquivo, pesquisa, céu e fluxos recentes._

## Primeiro percurso recomendado

Faça este primeiro percurso:

1. Complete a **Configuração básica**.
2. Crie um mapa em **Novo mapa** ou abra um mapa pelo **Início**.
3. Confira os dados do mapa antes de interpretar.
4. Abra a **versão completa** quando precisar editar, usar técnicas ou exportar.
5. Use **Meu arquivo** para organizar seus mapas.
6. Use **Pesquisa** para encontrar padrões.
7. Use **Feed** quando quiser estudar vários mapas em sequência.
8. Use **Lousa** quando quiser apresentar mapas, comparar visualmente ou preparar uma explicação.

Esse fluxo evita dois problemas comuns: abrir técnicas demais antes de saber se os dados estão certos, ou perder mapas por não entender onde eles ficam salvos.

## Configuração básica

A configuração básica aparece até ser preenchida pelo menos uma vez.

Ela define três coisas importantes:

- **fuso horário padrão**;
- **localidade padrão**;
- **configuração base**.

![Configuração básica](/img/cfg/basic.png)
_A configuração básica define o padrão de cálculo usado por mapas e técnicas novas._

O fuso e a localidade padrão não substituem os dados de nascimento de um mapa. Eles são usados em telas que precisam de um ponto de partida, como céu local, mapas do momento, Lua nova vigente e cálculos ligados ao seu uso atual do app.

A **configuração base** define como o Go deve se comportar em padrões importantes, inclusive compatibilidade com referências como ABA ou Astro.com. Se você está migrando de outro sistema, revise essa parte antes de comparar resultados.

Veja também:

- [Ajustes e configuração](ajuda/config) - Revise preferências da conta, idioma, dados locais e comportamento do app.
- [Configuração base](ajuda/config-base) - Defina padrões técnicos usados nos cálculos e comparações.

## Áreas principais do Go

O Go tem áreas diferentes para tarefas diferentes.

**Início** é a tela para começar o dia: busca rápida, favoritos, últimos mapas, aniversários, céu vigente e atalhos para outras áreas.

**Novo mapa** cria mapas novos no seu arquivo. Use para cadastrar pessoas, eventos, empresas, países, ingressos, lunações ou qualquer mapa que você quer guardar.

**Meu arquivo** organiza os mapas salvos na sua conta. É onde você usa pastas, filtros, favoritos, aniversários, importação, exportação e ações em massa.

**Pesquisa** procura padrões astrológicos em conjuntos de mapas. Use quando a pergunta é “quem tem Sol em Áries?”, “quais mapas têm Lua em Capricórnio?” ou “quais mapas combinam estes filtros?”.

**Feed** mostra vários mapas em sequência. É bom para estudar, retomar mapas recentes e ir abrindo mapas sem sair do fluxo.

**Lousa** organiza mapas em um espaço visual. Use para aula, atendimento, apresentação, comparação e preparação de raciocínio.

**Técnicas** aparecem dentro dos mapas. Elas incluem trânsitos, progressões, sinastria, revolução solar, profecções, zodíaco local, astrocartografia e outras opções disponíveis no plano.

**Interpretação** reúne textos de consulta e, quando disponível, edição da sua própria base interpretativa.

**Info / Suporte** cuida de conta, plano, senha, backup, tickets e contato com suporte.

Se você só quer sair do zero sem se perder, guarde esta regra:

- **versão completa** para trabalhar em um mapa;
- **Feed** para circular por vários mapas em sequência;
- **Lousa** para comparar, explicar ou apresentar visualmente.

## Primeiro mapa

Para criar um mapa, abra **Novo mapa**.

No cadastro, preencha o tipo de mapa, nome, data, hora, local e demais campos relevantes. Depois de salvar, o mapa entra no **Meu arquivo** e pode ser encontrado pela Home, por pesquisa de nome, por pastas e por filtros.

Antes de interpretar, confira:

- se a data está correta;
- se a hora está correta ou se o mapa está marcado como sem hora;
- se a cidade/localidade escolhida é a desejada;
- se o fuso calculado faz sentido para o local e a época;
- se o tipo de mapa está correto.

Se você está importando mapas de outro sistema, use a parte de importação do Novo mapa ou do Meu arquivo. Arquivos importados podem precisar de revisão, principalmente quando a origem não traz cidade, país, qualidade da hora ou metadados completos.

Veja o passo a passo em [Novo mapa](../novo-mapa/).

## Meus mapas e Mapa do Céu

O Go trabalha com duas fontes principais.

**Meus mapas** são os mapas salvos na sua conta. Eles podem ter pastas, notas, aniversários, favoritos, informações adicionais e histórico de edição.

**Mapa do Céu** reúne mapas públicos, históricos ou de referência. Eles são úteis para consulta e estudo, mas não são a mesma coisa que o seu arquivo pessoal.

Na prática:

- use **Meus mapas** quando o mapa é seu, de cliente, de estudo próprio ou precisa ser organizado;
- use **Mapa do Céu** quando quer consultar um mapa público pronto;
- envie qualquer um deles para o **Feed** ou para a **Lousa** quando quiser comparar ou apresentar.

## Versão completa, prévia, Feed e Lousa

Nem toda abertura de mapa serve para a mesma coisa.

O **painel de prévia** aparece quando você clica em um mapa em buscas, listas ou menções. Ele serve para conferir rapidamente se aquele é o mapa certo e escolher o próximo passo: abrir completo, abrir no Feed ou mandar para a Lousa.

A **versão completa** é a área principal de um mapa. Use quando precisa editar dados, abrir técnicas, ajustar visualização, consultar interpretação, gerar imagem/PDF ou trabalhar com mais detalhe.

![Visualização do mapa](/img/cinfo/cinfo.png)
_O cartão do mapa resume dados principais e dá acesso à versão completa._

O **Feed** é melhor quando você vai circular por vários mapas. Ele mantém uma sequência de mapas abertos e ajuda a retomar o histórico recente.

![Feed de mapas](/img/feed/feed.png)
_O Feed organiza mapas abertos recentemente para continuar um estudo ou atendimento sem perder a sequência._

A **Lousa** é melhor quando você quer organizar mapas visualmente. Ela funciona bem para comparar, explicar, preparar uma aula ou montar uma cena de atendimento.

Veja também:

- [Início](ajuda/inicio) - Entenda a tela inicial, atalhos, favoritos e mapas recentes.
- [Feed de mapas](ajuda/feed-de-mapas) - Trabalhe com uma sequência de mapas sem sair do fluxo.
- [Lousa de mapas](ajuda/lousa-de-mapas) - Monte uma área visual para comparar, explicar ou apresentar mapas.

## Ações de mapa

Em vários lugares do Go, mapas têm um menu de **ações**.

As ações variam conforme o contexto, o tipo de mapa e o plano de acesso, mas normalmente incluem opções como:

- abrir a versão completa;
- abrir no Feed;
- abrir na Lousa;
- editar dados do mapa;
- favoritar;
- copiar ou compartilhar informações;
- gerar PDF ou imagem;
- consultar interpretação;
- acessar informações adicionais;
- remover da tela atual, quando o mapa está no Feed ou na Lousa.

Quando um mapa aparece em uma menção, busca ou lista, procure o botão de ações ou os botões diretos como **abrir**, **feed** e **lousa**. A ideia é levar o mapa para a área certa sem refazer a busca.

## Técnicas e opções da técnica

Depois que um mapa está aberto, você pode adicionar técnicas.

As técnicas são camadas de leitura: trânsitos, progressões, sinastria, revolução solar, profecções, direção, zodíaco local, astrocartografia e outras opções.

Cada técnica pode ter um menu próprio no canto superior direito.

![Menus de opções por técnica](/img/ctech/menuopt.png)
_O menu da técnica concentra ações como abrir opções, enviar para Feed/Lousa e gerar saída._

Esse menu costuma reunir:

- imagem e PDF daquela técnica;
- abrir em nova aba;
- abrir abaixo ou ao lado, conforme a tela;
- opções visuais da mandala;
- símbolos, retrógrados, estrelas fixas e outras preferências;
- consulta de interpretação, quando a técnica tem textos disponíveis;
- ações para remover, trocar ou reorganizar a técnica.

Use poucas técnicas no começo. Abra uma, entenda o que mudou no mapa e só depois adicione outra. Isso deixa a tela mais leve e a leitura mais clara.

Veja [Técnicas](../tecnicas/).

## Botões rápidos do mapa

Alguns controles aparecem diretamente no mapa.

![Botões mágicos](/img/destaque/bmagic.png)
_Destaques visuais ajudam a chamar atenção para um ponto do mapa durante estudo ou apresentação._

Os mais usados são:

- trocar a cor da mandala;
- abrir o seletor de cor com clique duplo, quando disponível;
- maximizar o mapa;
- mostrar apenas a mandala;
- abrir imagem/PDF pelo ícone da câmera em mapas SVG;
- ajustar visualização conforme a técnica.

O ícone da câmera abre a área de **PDF e imagem**. Dependendo do plano e do tipo de mapa, o app pode preservar o estado visual do clique, como destaque, técnica aberta ou modo de visualização.

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

## Controles extras

Alguns controles não são astrológicos, mas ajudam no uso diário.

**Menu principal** mostra ou esconde a navegação lateral.

**Tela cheia** deixa a interface mais limpa para aula, atendimento ou apresentação.

**Tela sempre ligada** ajuda quando você está usando tablet, projetor ou atendimento longo.

**Anotações na tela** permitem marcar pontos visualmente durante uma explicação.

**Modo claro/escuro** muda o tema da interface e pode afetar também imagens, capturas e leitura em telas diferentes.

## Atalhos de teclado

Atalhos podem variar conforme navegador, sistema operacional e foco da tela. Quando o navegador captura uma combinação, use o botão da interface.

Os atalhos mais úteis são:

- `Ctrl/Command + n`: criar novo mapa;
- `Esc`: fechar diálogos, menus, mapas maximizados e painéis;
- `Ctrl/Command + p`: abrir PDF/imagem do mapa ativo;
- `Ctrl/Command + o`: alternar “apenas mandala” no mapa ativo;
- `Ctrl/Command + m`: maximizar ou minimizar o mapa ativo;
- `Ctrl/Command + s`: alternar tela cheia do Astrologic;
- `g o d b`: abrir o Meu arquivo por sequência digitada.

Evite depender de `Command + d` no Mac, porque muitos navegadores usam esse atalho para favoritos.

## Ajudas visuais

O Go mostra ajudas pequenas e grandes em várias telas.

![Balões de ajuda](/img/destaque/helpinline.png)
_Ajuda contextual aparece perto da dúvida para explicar uma ação sem sair da tela._

Use essas ajudas quando um controle parece específico demais. Elas costumam explicar o que aquele botão faz, quando usar e se há alguma limitação.

Algumas influências aparecem com visual de alerta ou fundo rosado.

![Influências sem confirmação](/img/destaque/unsure.png)
_Quando uma informação parecer incerta, confira o detalhe antes de salvar ou interpretar._

Isso costuma indicar que a informação não é totalmente confirmada. É comum em mapas sem hora, horários aproximados ou dados em que Ascendente, casas, Lua ou aspectos dependem muito da precisão da hora.

Quando encontrar esse aviso, trate o ponto como hipótese de leitura, não como confirmação.

## Bons hábitos no começo

Salve mapas com nomes claros. Inclua sobrenome, evento ou contexto quando isso ajuda a encontrar depois.

Use pastas no Meu arquivo antes de acumular muitos mapas soltos.

Anote informações importantes no mapa. O Go fica mais útil quando você alimenta o arquivo com contexto real, não só com dados de nascimento.

Revise mapas sem hora. Eles podem ser úteis, mas exigem mais cuidado com casas, Ascendente, Meio do Céu e Lua.

Use o Feed para estudar sequência de mapas e a Lousa para apresentar ou comparar.

Não abra técnicas demais sem objetivo. A pergunta de estudo vem antes da técnica.

Quando um resultado parecer estranho, confira configuração base, fuso, localidade, tipo de mapa e qualidade da hora antes de concluir que há erro.

## Problemas comuns

### Não sei por onde começar

Abra o **Início**, crie ou procure um mapa e entre na versão completa. Depois siga para [Ler o mapa](../ler-o-mapa/).

### Criei um mapa e não acho mais

Abra **Meu arquivo** e procure pelo nome. Se não encontrar, tente parte do nome, confira filtros ativos e olhe as pastas. Veja [Meu arquivo](../meu-arquivo/).

### O mapa parece diferente de outro programa

Confira a **Configuração base**, o sistema de casas, zodíaco, orbes, fuso, localidade e dados do mapa. Veja [Configuração base](../config-base/).

### O mapa está sem Ascendente ou casas

Provavelmente a hora está ausente ou marcada como incerta. Edite o mapa e revise a hora. Veja [Editar mapa](../editar-mapa/).

### A tela ficou pesada

Feche técnicas que não está usando, reduza mapas abertos no Feed ou na Lousa e evite manter várias áreas pesadas abertas ao mesmo tempo.

### Um atalho não funciona

Use o botão da interface. Alguns atalhos são capturados pelo navegador ou pelo sistema operacional.

### Preciso de ajuda com um caso específico

Abra um ticket com o máximo de contexto: qual tela, qual mapa, o que você clicou, o que esperava e o que apareceu. Veja [Suporte](../suporte/).

## Próximas leituras

Depois desta página, leia:

- [Início](ajuda/inicio) - Entenda a Home, atalhos, favoritos, últimos mapas e céu vigente.
- [Novo mapa](ajuda/novo-mapa) - Crie mapas, revise dados de nascimento/evento e importe informações.
- [Meu arquivo](ajuda/meu-arquivo) - Organize mapas salvos, pastas, favoritos, filtros e ações em massa.
- [Ler o mapa](ajuda/ler-o-mapa) - Aprenda cabeçalho, mandala, posições, aspectos, pontuações e ações.
- [Pesquisa](ajuda/pesquisa) - Procure padrões astrológicos nos mapas salvos no seu arquivo.
- [Técnicas no mapa](ajuda/tecnicas) - Abra e controle trânsitos, progressões, revoluções e outras camadas.
- [Feed de mapas](ajuda/feed-de-mapas) - Trabalhe com vários mapas em sequência durante estudo ou atendimento.
- [Lousa de mapas](ajuda/lousa-de-mapas) - Monte uma área visual para comparar, explicar e apresentar mapas.
- [Problemas e soluções](ajuda/problemas-solucoes) - Resolva casos comuns de cache, login, dados locais, lentidão e suporte.