CRMAppy Docs Login & Logoff
v0.1.6
🔐 Capítulo 1B

Login & Logoff

O acesso ao CRMAppy é protegido por autenticação segura gerida pelo Supabase Auth. A tela de login oferece três formas de entrada e um fluxo de recuperação de senha — tudo sem instalar nada, direto no navegador.

1. A Tela de Login

Ao acessar o sistema, o usuário é apresentado à tela de autenticação. O layout é minimalista e centralizado, com o logo do CRMAppy no topo e os campos de acesso logo abaixo.

2. Opções de Acesso

A tela de login concentra quatro formas de interação, acessíveis a partir de um único e-mail:

Opção Quando usar Como funciona
Entrar Acesso padrão com e-mail e senha cadastrados. Preencha e-mail e senha, clique em Entrar. O sistema valida as credenciais e redireciona para o Dashboard.
Magic Link Quando não quer digitar senha ou está em um dispositivo novo. Informe o e-mail, clique em Entrar com Magic Link. Um link de acesso único é enviado para a caixa de entrada. Clique nele e o sistema abre já autenticado.
Criar senha Primeiro acesso ou criação de conta. Clique em Crie aqui, informe o e-mail e defina uma senha com no mínimo 6 caracteres. Um e-mail de confirmação é enviado para ativar o acesso.
Esqueci minha senha Quando a senha foi esquecida ou precisa ser redefinida. Clique no link Esqueci minha senha, informe o e-mail e o sistema envia um link de redefinição para a caixa de entrada.

3. Entrar com Magic Link

O Magic Link é a forma mais rápida de acessar o CRMAppy sem precisar memorizar senha. O fluxo é simples e seguro:

1
Digite o e-mail na tela de login

O campo de e-mail precisa estar preenchido com um endereço válido antes de acionar o Magic Link.

2
Clique em "Entrar com Magic Link"

O sistema envia uma requisição via supabase.auth.signInWithOtp e exibe a mensagem: "Enviamos um link mágico para seu e-mail. Verifique sua caixa de entrada!"

3
Abra o e-mail recebido

Um e-mail automático é enviado pelo Supabase com um botão ou link de acesso único (OTP — One-Time Password). O link expira após uso ou após um curto período de tempo.

Clique no link e acesse o sistema

O navegador redireciona automaticamente para o CRMAppy já autenticado. Nenhuma senha necessária.

💡 Lembrar login: Na tela de login por senha, marque a opção "Lembrar login" para que o sistema preencha automaticamente o e-mail nas próximas visitas. A preferência é salva localmente no navegador.

4. Como Fazer Logoff

O logoff encerra a sessão ativa do usuário no CRMAppy de forma segura. Para sair do sistema, acesse o menu lateral, clique no seu nome ou avatar no rodapé da barra e selecione "Sair" ou "Logoff".

  1. 1
    Localize o rodapé do menu lateral

    No canto inferior esquerdo da tela, o menu lateral exibe o nome do usuário logado e o botão de saída.

  2. 2
    Clique no ícone de saída (→)

    O sistema encerra a sessão no Supabase Auth, invalida o token JWT ativo e redireciona para a tela de login.

  3. 3
    Confirmação

    A tela de login é exibida novamente, confirmando que a sessão foi encerrada com sucesso.

5. ⚠️ Por que Sair Pelo Sistema e Não Fechar o Navegador

🚨 Atenção — Risco de Segurança: Fechar a janela ou aba do navegador pelo X do Windows (ou do sistema operacional) NÃO encerra a sessão no CRMAppy. O token de autenticação permanece ativo até sua expiração natural.

Entender a diferença é importante para proteger os dados da empresa:

Ação O que acontece Risco
Logoff pelo sistema A sessão é encerrada no servidor. O token JWT é invalidado imediatamente pelo Supabase. Seguro
Fechar o navegador pelo X A aba fecha, mas o token de sessão continua válido no navegador (armazenado em memória ou cookies). Ao reabrir o navegador, o sistema pode reconhecer a sessão automaticamente. Atenção
Fechar sem logoff em computador compartilhado Outra pessoa que abrir o mesmo navegador na mesma máquina pode acessar o CRMAppy com os dados e permissões do usuário anterior — sem precisar de senha. Alto Risco
🔒 Boas práticas de segurança:
  • Sempre faça logoff pelo sistema antes de sair do computador.
  • Em computadores compartilhados ou públicos, nunca marque "Lembrar login".
  • Se suspeitar que a sessão ficou aberta indevidamente, altere a senha imediatamente em Configurações.
  • Não compartilhe credenciais de acesso — cada usuário deve ter o seu próprio login.