Login
Login
A tela de Login é o ponto de entrada do aplicativo de Coleta de Leite: nela o coletor informa usuário e senha para abrir uma sessão de trabalho no ERP.
Visão Geral
A tela de Login é o ponto de entrada do aplicativo de Coleta de Leite: nela o coletor informa usuário e senha para abrir uma sessão de trabalho no ERP. Além de autenticar, o login decide para onde o coletor é encaminhado em seguida — direto para a confirmação de rota do dia (quando já existe uma base de dados válida no aparelho) ou para a tela de Sincronizar Dados (quando é o primeiro acesso no aparelho ou os dados salvos estão incompletos).
Pré-requisitos
- O aplicativo precisa conseguir identificar o aparelho. Sem isso, o botão Entrar fica bloqueado antes mesmo de tentar autenticar.
- O aplicativo precisa ter o endereço do servidor configurado (uma única vez, pela tela de configuração acessível pelo ícone de engrenagem no rodapé do Login). Sem esse endereço configurado, o botão Entrar fica bloqueado com aviso.
- Conexão com a internet só é obrigatória na primeira vez que o coletor autentica neste aparelho, ou ao usar uma senha diferente da última usada. Se o mesmo usuário e senha já foram usados antes neste aparelho, o login pode ser aceito sem internet (ver “Comportamento Offline e Dados Locais”).
Fluxo Operacional
- O coletor abre o aplicativo e chega à tela de Login. Nesse momento, o aplicativo pede ao sistema do aparelho a permissão de localização — essa solicitação não impede o uso da tela.
- O coletor informa usuário e senha e, opcionalmente, alterna o interruptor “Lembrar usuário” (ligado por padrão).
- Ao tocar em Entrar, o aplicativo confirma que os dois campos estão preenchidos, que consegue identificar o aparelho e que há um endereço de servidor configurado. Faltando qualquer um desses itens, a tentativa é interrompida e um aviso é exibido, sem chegar a autenticar.
- O aplicativo autentica o usuário (ver “Comportamento Offline e Dados Locais” e “Regras de Negócio”).
- Se a autenticação falhar, uma mensagem de erro é exibida e o coletor permanece na tela de Login.
- Se a autenticação for aceita, o aplicativo reproduz uma animação de confirmação no botão Entrar e só então decide a tela seguinte.
- A tela seguinte depende do que já está salvo no aparelho: primeiro acesso (ou dados incompletos) leva à tela de Sincronizar Dados; acesso recorrente com dados completos leva à tentativa de atualizar o percurso do dia e, na sequência, à tela de Atualizar Rota e Placa.
Interface e Comportamentos
Formulário de Login
Dois campos obrigatórios — Login e Senha — mais o interruptor “Lembrar usuário”. O ícone de mostrar/ocultar a senha só aparece depois que o coletor começa a digitar algo no campo Senha; a cada caractere novo digitado, a senha volta a ficar oculta. O interruptor “Lembrar usuário” é salvo imediatamente ao ser alterado, independente de o login já ter sido concluído.
Identificação do Dispositivo
Um botão no rodapé (ícone de informação) abre um painel exibindo o identificador único do aparelho, com opção de copiar para a área de transferência. Se o identificador não puder ser obtido, o painel exibe um aviso de permissão em vez do valor, sem opção de copiar.
Configuração do Endereço do Servidor
Um botão no rodapé (ícone de engrenagem) abre um formulário para informar o endereço do servidor que o aplicativo deve usar em toda comunicação, inclusive no login. A validação segue esta ordem: (1) o endereço não pode estar vazio; (2) ele precisa começar exatamente com `http` — qualquer outro formato, incluindo `https`, é rejeitado com um aviso pedindo o protocolo HTTP; (3) passando pelas duas checagens anteriores, o endereço ainda precisa ter um formato válido de endereço web. Ao confirmar um endereço válido, ele é salvo no aparelho e usado a partir daí.
Feedbacks ao Usuário
| Situação | Feedback | Texto exato |
|---|---|---|
| Campo Login vazio ao confirmar | Aviso abaixo do campo | “Informe o login” |
| Campo Senha vazio ao confirmar | Aviso abaixo do campo | “Informe a senha” |
| Identificador do aparelho indisponível | Aviso (snackbar) e bloqueio do Entrar | “Sem permissão para acessar o IMEI” |
| Endereço do servidor não configurado | Aviso (snackbar) e bloqueio do Entrar | “Informe a url” |
| Identificador copiado para a área de transferência | Aviso (snackbar) | “IMEI copiado para área de transferência” |
| Endereço do servidor configurado com sucesso | Aviso (snackbar) | “API configurada com sucesso” |
| Endereço do servidor com formato diferente de http | Aviso no campo do formulário de configuração | “Informe o protocolo HTTP” |
| Usuário ou senha rejeitados pelo servidor | Aviso (snackbar) | “Erro na autenticação de usuário e senha” |
| Autenticação recusada sem detalhe do servidor | Aviso (snackbar) | “Erro ao autenticar o usuário e senha” |
| Aparelho não autorizado | Aviso (snackbar) | “Erro de dispositivo não autorizado” |
| Falha de conexão com o servidor | Aviso (snackbar) | “Erro de conexão” |
| Tempo de resposta do servidor esgotado | Aviso (snackbar) | “Erro de tempo de execução” |
Regras de Negócio
Validação do formulário
Login e senha são obrigatórios. Sem os dois preenchidos, o formulário não avança e o Entrar não chega a ser processado.
Verificações antes de autenticar
Mesmo com o formulário válido, o aplicativo ainda confere, nesta ordem, se consegue identificar o aparelho e se há um endereço de servidor configurado. Faltando qualquer um, a tentativa é interrompida antes de qualquer autenticação.
Validação de usuário e senha
O servidor compara a senha informada com a senha cadastrada do usuário. Se não coincidirem, o login é recusado. Exceção: se o usuário existir no cadastro mas ainda não tiver nenhuma senha definida, a primeira senha informada no login é aceita e passa a ser a senha definitiva desse usuário — ou seja, o primeiro login de um usuário sem senha cadastrada é quem a define.
Usuário inativo
Se o usuário estiver marcado como inativo no cadastro, o login é recusado e um aviso é enviado automaticamente aos supervisores responsáveis, informando usuário, data e hora da tentativa.
Renovação automática da sessão
A sessão aberta pelo login tem validade de 360 horas (15 dias). Se, durante o uso do aplicativo, uma chamada ao servidor for recusada por sessão expirada ou inválida, o aplicativo tenta renovar a sessão automaticamente, usando o usuário e a senha salvos, e repete a operação uma única vez antes de avisar o coletor do erro.
Decisão da tela seguinte ao login
Ao autenticar com sucesso, o aplicativo confere se já existem, salvos no aparelho, ao menos um motivo de ocorrência, ao menos uma propriedade, e os dados completos da conta do coletor. As três condições precisam ser verdadeiras ao mesmo tempo.
- Se qualquer uma for falsa, o coletor é encaminhado para a tela de Sincronizar Dados, de onde o aplicativo baixa motivos, propriedades, veículo e percurso do zero.
- Se as três forem verdadeiras, o aplicativo tenta atualizar apenas o percurso do dia antes de liberar a tela de Atualizar Rota e Placa.
Resultado da atualização do percurso do dia
Se o servidor devolver pelo menos um percurso válido para o dia, o aplicativo substitui todo o percurso salvo anteriormente pelo recebido. Se a resposta não trouxer nenhum percurso (ausente, vazia ou em formato inesperado), a atualização é tratada como falha e o percurso salvo anteriormente é apagado.
Comportamento Offline e Dados Locais
O aplicativo mantém, no aparelho, uma lista das contas (usuário, senha e dados do coletor) já usadas para logar naquele aparelho. Um novo login com o mesmo usuário e a mesma senha de uma conta já salva é aceito imediatamente, sem precisar de internet. Um login bem-sucedido pela rede atualiza essa lista: se o usuário já constava nela, a entrada é substituída (mantendo nome, placa e código de cadastro já conhecidos, quando o novo login não os traz); se não constava, uma entrada nova é adicionada. Essa mesma lista é o que permite ao coletor trocar de usuário em um mesmo aparelho compartilhado sem perder o cadastro de acessos anteriores.
Geolocalização e Rastreamento
Quando o login encaminha o coletor para a tela de Atualizar Rota e Placa (ou seja, quando os dados do aparelho já estavam completos), o aplicativo também inicia o rastreamento de localização em segundo plano antes de trocar de tela.
Troubleshooting
Não consigo entrar: aviso de login em branco
Mensagem exibida: “Informe o login”
O que fazer: preencher o campo Login antes de tocar em Entrar.
Não consigo entrar: aviso de senha em branco
Mensagem exibida: “Informe a senha”
O que fazer: preencher o campo Senha antes de tocar em Entrar.
Botão Entrar não avança: aviso de permissão do identificador do aparelho
Mensagem exibida: “Sem permissão para acessar o IMEI”
O que fazer: verificar, nas configurações do aparelho, se o aplicativo tem as permissões necessárias; reabrir o aplicativo após ajustar.
Botão Entrar não avança: aviso para informar o endereço do servidor
Mensagem exibida: “Informe a url”
O que fazer: configurar o endereço do servidor pelo ícone de engrenagem no rodapé da tela de Login, antes de tentar entrar.
Configuração do endereço recusada com aviso de protocolo HTTP
Mensagem exibida: “Informe o protocolo HTTP”
Cenário: foi digitado um endereço que não começa exatamente com `http` (inclui o caso de ter digitado `https`).
O que fazer: informar o endereço usando exatamente o prefixo `http`, ainda que o servidor real use `https` — confirmar com o suporte qual endereço é aceito pelo aplicativo neste caso.
Login recusado com aviso de autenticação
Mensagem exibida: “Erro na autenticação de usuário e senha” ou “Erro ao autenticar o usuário e senha” (as duas indicam usuário ou senha incorretos; o texto exato varia conforme o motivo interno da recusa)
O que fazer: confirmar usuário e senha com o suporte; se for o primeiro acesso deste coletor, lembrar que a primeira senha digitada é a que passa a valer.
Login recusado com aviso de aparelho não autorizado
Mensagem exibida: “Erro de dispositivo não autorizado”
O que fazer: confirmar com o suporte se este aparelho está liberado para este usuário.
Login falha sem mensagem do servidor, aviso de conexão
Mensagem exibida: “Erro de conexão”
O que fazer: confirmar se o aparelho tem internet no momento da tentativa; se o coletor já tiver logado antes neste aparelho com a mesma senha, tentar novamente pode funcionar sem internet.
Login demora e depois falha com aviso de tempo esgotado
Mensagem exibida: “Erro de tempo de execução”
O que fazer: tentar novamente; se persistir, avisar o suporte.
Login falha com aviso de servidor não encontrado
Mensagem exibida: “Servidor não encontrado”
O que fazer: confirmar o endereço do servidor configurado (ícone de engrenagem) com o suporte.
Coletor autentica mas a tela seguinte não mostra o percurso esperado
Mensagem exibida: “Nenhuma — o aplicativo não avisa o coletor quando a atualização do percurso do dia falha silenciosamente”
Cenário: o login foi aceito e o coletor já tinha dados completos de um acesso anterior, mas a atualização do percurso do dia não trouxe nenhum percurso válido.
O que fazer: confirmar com o suporte se há percurso atribuído ao coletor no servidor para o dia; reforçar a sincronização manual pela tela de Sincronizar Dados, se disponível.
Casos de Uso
Caso 1 — Primeiro acesso de um coletor novo no aparelho
O coletor informa usuário e senha pela primeira vez neste aparelho. Como não há conta salva localmente, o aplicativo autentica direto no servidor; com sucesso, como ainda não há motivos nem propriedades salvos no aparelho, o coletor é encaminhado para a tela de Sincronizar Dados.
Caso 2 — Acesso recorrente com percurso do dia disponível
O coletor já usou este aparelho antes, tem os dados completos salvos e há um percurso atribuído a ele para o dia. O login é validado (localmente, se usuário e senha baterem com o último acesso salvo, ou pelo servidor caso contrário), a atualização do percurso do dia traz resultado, e o coletor segue para a tela de Atualizar Rota e Placa com o rastreamento de localização já iniciado.
Caso 3 — Usuário ou senha incorretos
O coletor digita a senha errada. Não há conta salva localmente com essa combinação, então o aplicativo consulta o servidor, que recusa a autenticação; o coletor vê o aviso de usuário/senha inválidos e permanece na tela de Login.
Caso 4 — Acesso recorrente sem percurso atribuído no dia
O coletor já tem os dados completos salvos de acessos anteriores, mas não há nenhum percurso atribuído a ele para o dia corrente. O login é aceito normalmente, mas a atualização do percurso do dia não traz nenhum resultado; mesmo assim, o coletor é encaminhado para a tela de Atualizar Rota e Placa (ver T-11), sem um aviso explícito de que o percurso do dia não foi atualizado.