• Avisos
  • Novidades
  • Documentação
  • Depoimentos
  • Blog
  • Materiais
  • Manuais
  • Dúvidas
  • Avisos
  • Novidades
  • Documentação
  • Depoimentos
  • Blog
  • Materiais
  • Manuais
  • Dúvidas

Documentação

  • COLETA DE LEITE
    • Autenticacao
      • Login
      • Splash
    • Coletas
      • Coleta de Carga
      • Evidência de Coleta
      • Lista de Coletas
      • Persistir Coleta
    • Envio
      • Coletas Enviadas
      • Enviar Coleta
    • Propriedades
    • Rotaveiculo
      • Atualizar Placa
      • Atualizar Rota
      • Atualizar Rota e Placa
      • Tanque
    • Sincronizar Dados
    • Ver Mapa da Rota
Nenhum resultado encontrado
Inteligência Atak / Documentação / COLETA DE LEITE / Autenticacao

Login

Criado por Igor Ribeiro em 01 de setembro de 2026
•
Atualizado por Igor Ribeiro em 09 de outubro de 2026
Documentação Técnica

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.

01. VISÃO GERAL

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).

02. PRÉ-REQUISITOS

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”).
03. FLUXO OPERACIONAL

Fluxo Operacional

  1. 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.
  2. O coletor informa usuário e senha e, opcionalmente, alterna o interruptor “Lembrar usuário” (ligado por padrão).
  3. 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.
  4. O aplicativo autentica o usuário (ver “Comportamento Offline e Dados Locais” e “Regras de Negócio”).
  5. Se a autenticação falhar, uma mensagem de erro é exibida e o coletor permanece na tela de Login.
  6. 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.
  7. 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.
04. INTERFACE E COMPORTAMENTOS

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í.

05. FEEDBACKS AO USUÁRIO

Feedbacks ao Usuário

SituaçãoFeedbackTexto exato
Campo Login vazio ao confirmarAviso abaixo do campo“Informe o login”
Campo Senha vazio ao confirmarAviso abaixo do campo“Informe a senha”
Identificador do aparelho indisponívelAviso (snackbar) e bloqueio do Entrar“Sem permissão para acessar o IMEI”
Endereço do servidor não configuradoAviso (snackbar) e bloqueio do Entrar“Informe a url”
Identificador copiado para a área de transferênciaAviso (snackbar)“IMEI copiado para área de transferência”
Endereço do servidor configurado com sucessoAviso (snackbar)“API configurada com sucesso”
Endereço do servidor com formato diferente de httpAviso no campo do formulário de configuração“Informe o protocolo HTTP”
Usuário ou senha rejeitados pelo servidorAviso (snackbar)“Erro na autenticação de usuário e senha”
Autenticação recusada sem detalhe do servidorAviso (snackbar)“Erro ao autenticar o usuário e senha”
Aparelho não autorizadoAviso (snackbar)“Erro de dispositivo não autorizado”
Falha de conexão com o servidorAviso (snackbar)“Erro de conexão”
Tempo de resposta do servidor esgotadoAviso (snackbar)“Erro de tempo de execução”
06. REGRAS DE NEGÓCIO

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.

07. COMPORTAMENTO OFFLINE E DADOS LOCAIS

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.

08. GEOLOCALIZAÇÃO E RASTREAMENTO

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.

09. TROUBLESHOOTING

Troubleshooting

T-01

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.

T-02

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.

T-03

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.

T-04

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.

T-05

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.

T-06

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.

T-07

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.

T-08

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.

T-09

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.

T-10

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.

T-11

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.

10. CASOS DE USO

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.

NA PÁGINA

  • Visão Geral
  • Pré-requisitos
  • Fluxo Operacional
  • Interface e Comportamentos
  • Feedbacks ao Usuário
  • Regras de Negócio
  • Comportamento Offline e Dados Locais
  • Geolocalização e Rastreamento
  • Troubleshooting
  • Casos de Uso
NEWSLETTER

Conteúdo para quem vive a indústria de alimentos

Receba conteúdos sobre tecnologia, gestão e inovação para a indústria de alimentos.

Acompanhe novidades, tendências e soluções para melhorar a eficiência da sua operação.

Produtos

  • ERP
  • Frigosoft
  • Força de Vendas
  • Coleta de Resíduos
  • Venda Ambulante
  • Coleta de Leite
  • BI Atak
  • EasyPAC
  • Delivery B2B

Soluções

  • Bovinos
  • Suínos
  • Aves
  • Ovinos
  • Pescados
  • Laticínios
  • Curtumes
  • Charqueadas
  • Distribuidores Entrepostos
  • Indústria de Alimentos em Geral

Conteúdos

  • Blog
  • E-books (em breve)
  • Podcasts (em breve)
  • Webinars (em breve)
  • Depoimentos

Ajuda

  • Dúvidas
  • Documentação (em breve)
  • Manuais (em breve)
  • Avisos (em breve)
  • Novidades (em breve)

Empresa

  • Sobre
  • Carreiras
  • Privacidade
  • Contato
  • llms.txt
  • llms-full.txt

Social

  • LinkedIn
  • Instagram
  • YouTube

© 2026 Atak Sistemas Todos os direitos reservados.

Av. Nildo Ribeiro da Rocha, 5766 Parque Tecnológico, Maringá/PR. CNPJ: 73.500.290/0001-06