Location

title: "Location" module: "location"

Visão geral

O módulo Location do Zora7 foi criado para transformar “lugares importantes” em informação útil e organizada — de forma simples, rápida e totalmente previsível.
Ele permite cadastrar e manter seus locais (Casa, Trabalho, Academia, etc.) e prepara o terreno para recursos futuros do ecossistema (como rotinas e alertas por localização), sempre respeitando o princípio central do Zora7: nada acontece sem você pedir.

Quando usar

• Para registrar lugares frequentes com apelidos curtos e fáceis.
• Para manter seu catálogo pessoal de locais sempre disponível no app.
• Para organizar o módulo desde o MVP, garantindo um crescimento sólido quando recursos avançados forem liberados.

Quando NÃO usar

• Se você espera GPS ativo, rastreamento em segundo plano ou solicitações automáticas de permissão.
• Se você quer alertas por localização funcionando agora (no MVP, a área de alarme é stub/placeholder).
• Se você quer integração direta com outros módulos (o Location é isolado por design).

Como usar

• Abra o Location pelo app (rota oficial do projeto: /location).
• No menu do módulo, escolha:
  • Meu perfil: visualizar e editar dados do perfil do Location.
  • Meus lugares: listar lugares cadastrados e criar novos.
  • Histórico: consultar registros de uso (quando houver).
  • Alarme por localização: área reservada (placeholder no MVP).
• Para cadastrar um lugar:
  • Entre em Meus lugares
  • Toque em +
  • Preencha Apelido (obrigatório) e, se quiser, o endereço
  • Salve

Boas práticas

• Use apelidos curtos e consistentes: “Casa”, “Trabalho”, “Mercado”.
• Evite duplicar locais com nomes parecidos (ex.: “Trabalho” e “Meu Trabalho”).
• Cadastre pelo menos 2–3 lugares principais para ter um módulo pronto para evoluir.
• Trate o Location como base de organização: quanto mais claro estiver, melhor para futuras automações do Zora7.

Erros comuns

• Criar lugar sem apelido (o cadastro exige apelido).
• Esperar que o módulo “adivinhe” localização ou peça permissões sozinho.
• Procurar “alarme por localização” funcionando no MVP (a tela existe como preparação, mas não executa alarme).

Histórico

O histórico do Location é funcional: ele representa ações e uso real do módulo (quando habilitado/registrado).

Regras importantes:

• O histórico não carrega automaticamente.
• Se estiver vazio, o módulo mostra estado vazio (sem erros).
• Não depende de internet.

Configurações

O Location pode oferecer preferências próprias (ex.: preferências de som ou voz como dados, duração padrão), mas:

• Configurações não são obrigatórias.
• Valores padrão são sempre válidos.
• O módulo não executa som ou voz: são apenas preferências para o sistema central usar no futuro.

Limitações (MVP atual)

• Sem solicitações automáticas de permissão.
• Sem GPS ou Geolocator nesta fase.
• Sem rede.
• Sem voz ou áudio.
• “Alarme por localização” ainda é placeholder.
• O módulo abre vazio e não carrega nada sozinho sem ação explícita do usuário.

FAQ

O Location funciona sem internet?
Sim. O módulo foi projetado para funcionar offline no MVP.

O Location pede permissão de localização?
Não. O MVP não solicita permissões automaticamente.

O Location já ativa alarmes por localização?
Ainda não. Nesta fase, o módulo apenas prepara a estrutura e a navegação. Quando for liberado, ele declarará intenções e o Engine central decidirá a execução.

Por que o módulo abre “vazio”?
Porque o Zora7 prioriza previsibilidade e segurança: nada é carregado automaticamente e o módulo nunca trava o app.