Autenticação
Acesso ao sistema, definição de senha no primeiro acesso e recuperação de senha.
1. Objetivo
Permitir que usuários cadastrados acessem o HaisFaturamento, realizem a definição de senha no primeiro acesso e recuperem a senha quando necessário.
2. Fluxo
Login
- Informar e-mail e senha
- Credenciais válidasInício
- Usuário cadastrado sem senhaPrimeiro acesso
- “Esqueci minha senha”Recuperação de senha
Primeiro acesso
- Definir senha
- Confirmar senha
- Senha definida com sucesso
- Ir para o login
Recuperação de senha
- Informar e-mail cadastrado
- Enviar link de recuperação
- Exibir confirmação de envio
3. Telas e estados
Login
- Login/login(abre em nova aba)
Formulário de e-mail e senha.
Primeiro acesso
- Definir senha/primeiro-acesso(abre em nova aba)
Formulário de nova senha.
- Senha definida/primeiro-acesso?estado=sucesso(abre em nova aba)
Confirmação após definir a senha.
Recuperação de senha
- Recuperar senha/recuperar-senha(abre em nova aba)
Formulário de e-mail.
- Verifique seu e-mail/recuperar-senha?estado=enviado(abre em nova aba)
Confirmação após solicitar o link.
4. Regras e comportamentos
Login
Campos
- E-mail: obrigatório; formato de e-mail válido (sem diferenciar maiúsculas e minúsculas).
- Senha: obrigatória; sem validação de formato; permite exibir e ocultar.
Validação
- Validar os campos ao enviar o formulário.
- E-mail ou senha incorretos: exibir erro.
Direcionamento
- Login válido → Início.
- Usuário cadastrado sem senha → Primeiro acesso.
- “Esqueci minha senha” → Recuperação de senha.
- Sair (menu lateral), após confirmação → Login.
Primeiro acesso
Campos
- Nova senha: obrigatória.
- Confirmar senha: obrigatória e deve coincidir com a nova senha.
Requisitos da senha
- Mínimo de 8 caracteres, pelo menos uma letra, um número e um caractere especial.
Comportamento
- Validar os requisitos em tempo real.
- Requisito atendido: exibir ícone de check verde; não indicar apenas por cor.
- Requisito não atendido: manter estado neutro.
- “Definir senha”: desabilitado até atender todos os requisitos e as senhas coincidirem.
Após sucesso
- Exibir o estado “Senha definida”.
- Exibir a ação “Ir para o login”; sem redirecionamento automático.
Recuperação de senha
Campos
- E-mail: obrigatório; formato de e-mail válido; validar durante a digitação.
Envio
- “Enviar link de recuperação”: desabilitado até o e-mail ser válido.
- Durante o envio, desabilitar o botão e exibir indicador de carregamento.
Após envio
- Exibir o estado “Verifique seu e-mail”.
- Não informar se o e-mail está cadastrado; exibir a mesma confirmação para qualquer e-mail válido.
Navegação
- “Voltar para o login”: link secundário no estado de confirmação, pois o próximo passo acontece no e-mail.
5. Estados e validações
| Estado / situação | Onde ocorre | Comportamento esperado |
|---|---|---|
| Campo obrigatório vazio | Onde ocorre
| Comportamento esperado Mensagem (Login): “Informe sua senha.” Mensagem (Recuperação): “Informe o e-mail.” |
| Campo inválido | Onde ocorre
| Comportamento esperado Exibição: mensagem abaixo do campo. Exemplos: “Informe o e-mail.”, “Informe um e-mail válido.” |
| Senhas não coincidem | Onde ocorre
| Comportamento esperado Exibição: no campo de confirmação. Mensagem: “As senhas não coincidem.” |
| Botão desabilitado | Onde ocorre
| Comportamento esperado Primeiro acesso: “Definir senha” habilita somente quando os requisitos forem atendidos e as senhas coincidirem. Recuperação: “Enviar link de recuperação” habilita somente quando o e-mail for válido. |
| Processando | Onde ocorre
| Comportamento esperado Durante o envio, o botão principal fica desabilitado e exibe indicador de carregamento, evitando envio duplicado. |
| Erro de autenticação | Onde ocorre
| Comportamento esperado Exibição: alerta. Mensagem: “E-mail ou senha incorretos. Confira os dados e tente novamente.” |
| Falha ao definir senha | Onde ocorre
| Comportamento esperado Exibição: aviso. Mensagem: “Não foi possível definir a senha. Faça login novamente.” |
| Erro técnico / conexão | Onde ocorre
| Comportamento esperado Mensagem: “Não foi possível concluir a solicitação. Tente novamente.” |
| Sucesso | Onde ocorre
| Comportamento esperado Estado: “Senha definida”. Ação: “Ir para o login”. |
| Link de recuperação solicitado | Onde ocorre
| Comportamento esperado Estado: “Verifique seu e-mail”. Quando: após solicitar a recuperação com um e-mail válido. Mensagem: “Se houver uma conta cadastrada com esse e-mail, enviaremos um link para recuperação da senha.” Ação: “Voltar para o login”. |
6. Responsividade
As páginas de autenticação são responsivas para desktop, tablet e mobile. Diferenças relevantes:
- DesktopMensagem institucional à esquerda e cartão do formulário à direita.
- Tablet e mobileA mensagem institucional é ocultada; apenas o cartão do formulário é exibido, centralizado e em largura total disponível.
- MobileRodapé (copyright, Termos de uso e Política de privacidade) empilhado e centralizado.
7. Observações para desenvolvimento
- A implementação deve reutilizar os componentes, tokens e padrões existentes no Design System do HaisFaturamento para campos, botões, feedbacks, tipografia, espaçamentos e estados de interação.
Atenção — comportamento do protótipo
Para facilitar a validação e o handoff, a página /primeiro-acesso pode ser acessada diretamente pelo link no protótipo. No produto, o Primeiro acesso deve fazer parte do fluxo iniciado pelo Login, após a identificação de um usuário cadastrado que ainda não possui senha.
Comportamentos simulados no protótipo — contas de exemplo, persistência local no navegador e simulação de envio de e-mail — não devem ser interpretados automaticamente como regras de implementação.
Os links com ?estado= em Telas e estados (ex.: /primeiro-acesso?estado=sucesso, /recuperar-senha?estado=enviado) existem só para documentação e validação. No produto, esses estados continuam sendo alcançados apenas pelo fluxo normal.