Motorista/coletor cadastrado no ERP Atak, com usuário e senha liberados pela equipe responsável.

O aparelho precisa ter a URL do servidor (API) configurada corretamente (ícone de engrenagem, na parte inferior da tela) e, em muitos casos, o dispositivo precisa estar previamente autorizado no sistema pela equipe de suporte, com base no identificador do dispositivo.

Esta é a primeira tela do fluxo do motorista: não depende de nenhuma outra rotina anterior dentro do próprio aplicativo.

Ao abrir o aplicativo pela primeira vez em um aparelho novo, o motorista deve tocar no ícone de engrenagem (rodapé da tela) e informar a URL do servidor fornecida pela equipe de suporte, depois confirmar. O sistema valida se a URL foi preenchida e se está no formato correto (precisa começar com o protocolo “http”); se estiver tudo certo, exibe a confirmação “API configurada com sucesso”.

Caso a equipe de suporte solicite o identificador do aparelho para liberar o acesso, o motorista toca no ícone de informação (rodapé da tela). O sistema exibe o identificador do dispositivo em um painel e permite copiá-lo tocando sobre o valor, para depois colar e enviar à equipe responsável.

O motorista preenche o campo “Login” com seu usuário e o campo “Senha” com sua senha. Se desejar que o aplicativo mantenha a sessão iniciada nas próximas vezes que for aberto neste aparelho, ele mantém o interruptor “Lembrar usuário” ligado (é o comportamento padrão).

O motorista toca no botão “Entrar”. O sistema verifica se os dois campos foram preenchidos; caso algum esteja vazio, exibe uma mensagem indicando qual campo precisa ser informado e não prossegue.

Com os campos preenchidos, o sistema verifica o identificador do dispositivo e a URL do servidor configurada, e então confirma o usuário e a senha informados. Se o motorista já autenticou nesse mesmo aparelho antes com esse mesmo usuário e senha, o sistema pode reconhecer o acesso imediatamente, mesmo sem conexão com a internet. Caso contrário, o sistema consulta o servidor para validar as credenciais; nesse caso é necessário ter conexão com a internet.

Com o acesso confirmado, o sistema verifica automaticamente se o aparelho já possui uma rota sincronizada. Se já possuir, o motorista é levado para a tela de atualização de rota/placa do veículo. Se ainda não possuir (por exemplo, primeiro acesso do motorista neste aparelho), ele é levado para a tela de sincronização de dados, onde deve sincronizar as informações necessárias antes de seguir em frente.

📋 Tipo: Texto

⚠️ Obrigatoriedade: Obrigatório

📋 Tipo: Texto oculto (com opção de mostrar/ocultar)

⚠️ Obrigatoriedade: Obrigatório

📋 Tipo: Interruptor (liga/desliga)

⚠️ Obrigatoriedade: Opcional (vem ligado por padrão)

Ao confirmar usuário e senha, o aplicativo consulta o servidor do ERP Atak para validar o acesso, salvando localmente no aparelho, de forma protegida, os dados da sessão do motorista (usuário, nome, placa do veículo e uma credencial de acesso temporária). Isso permite que, em acessos futuros no mesmo aparelho com o mesmo usuário e senha, o sistema reconheça o motorista mesmo sem conexão com a internet no momento do login.

Logo após a autenticação, o sistema verifica automaticamente, junto ao servidor, se existe uma rota (percurso) vinculada ao motorista para o dia. Essa verificação é o que determina a tela seguinte: se o aparelho já possui os dados básicos de uma sincronização anterior (motivos de não-coleta e propriedades cadastradas), o motorista segue para a atualização de rota/placa do veículo; caso contrário, o motorista é direcionado para a sincronização inicial de dados.

Todos os dados de apoio (rotas, propriedades, motivos) ficam salvos no aparelho, permitindo que o motorista trabalhe em campo mesmo sem conexão constante com a internet; apenas o login inicial (quando não há uma sessão reconhecida no aparelho) e a sincronização exigem conexão no momento em que são realizados.

O motorista não consegue avançar sem preencher os dois campos. Se algum estiver vazio, o sistema mostra qual campo falta preencher e não realiza a tentativa de acesso.

O sistema precisa conseguir identificar o aparelho usado para permitir o acesso. Se isso não for possível por algum motivo, o sistema exibe a mensagem “Sem permissão para acessar o IMEI” e não completa o login.

Se a URL do servidor não tiver sido configurada previamente (ícone de engrenagem), o sistema exibe a mensagem “Informe a url” e não tenta autenticar.

Se o motorista já autenticou anteriormente neste mesmo aparelho com o mesmo usuário e a mesma senha, o sistema reconhece o acesso imediatamente, sem precisar de conexão com a internet naquele momento. [informação não disponível na documentação de origem, validar com analista responsável: comportamento exato caso a senha do usuário tenha sido alterada no servidor nesse intervalo, já que o aplicativo não revalida automaticamente essa credencial salva localmente]

Se o usuário e a senha informados não forem aceitos pelo servidor, ou se houver algum problema de comunicação, o sistema não permite o acesso e exibe uma mensagem de erro correspondente à causa (por exemplo, usuário/senha inválidos, dispositivo não autorizado, ou erro no servidor). O motorista pode tentar novamente após corrigir os dados ou verificar sua conexão.

Depois do login confirmado, o próprio sistema decide, sem exigir nenhuma ação adicional do motorista, se ele deve ir para a tela de atualização de rota/placa (quando já existe uma sincronização anterior no aparelho) ou para a tela de sincronização de dados (quando é necessário sincronizar pela primeira vez). [informação não disponível na documentação de origem, validar com analista responsável: o critério usado pelo servidor para vincular ou não uma rota ao motorista em um determinado dia é definido no backend]