Tela Principal

A Tela Principal do aplicativo EasyPac é a central operacional onde o usuário visualiza e acessa as planilhas disponíveis para preenchimento, monitora pendências e realiza a sincronização de trabalhos iniciados. Nesta tela estão os controles de busca, filtros, indicadores de progresso e ações rápidas (sincronizar/abrir), além de informações de contexto (usuário, data base, turno e versão do app).

A Tela Principal do aplicativo EasyPac é a central operacional onde o usuário visualiza e acessa as planilhas disponíveis para preenchimento, monitora pendências e realiza a sincronização de trabalhos iniciados. Nesta tela estão os controles de busca, filtros, indicadores de progresso e ações rápidas (sincronizar/abrir), além de informações de contexto (usuário, data base, turno e versão do app).

Visão Geral

A Tela Principal organiza as planilhas disponíveis de forma que o usuário rapidamente identifique o que precisa ser preenchido, continue preenchimentos iniciados e sincronize registros com o servidor. Ela apresenta, em destaque, o contexto do acesso (Nome do Usuário, Data Base e Turno), controles de busca e filtros, e a lista de planilhas com indicadores de status.

Elementos da Tela — descrição detalhada

• Nome do Usuário, Data Base e Turno (topo):
  • Nome do Usuário: nome exibido do usuário autenticado; serve como confirmação visual da conta em uso.
  • Data Base: data que foi selecionada/definida na tela de entrada de dados — influencia quais registros são apresentados e quais planilhas serão consideradas para preenchimento naquele ciclo.
  • Turno: turno corrente selecionado na entrada de dados; muitas planilhas são calculadas e filtradas com base nesse turno.
  • Comportamento: esses três valores são preenchidos no login/entrada de dados e permanecem visíveis enquanto durar a sessão. Alterações exigem voltar à tela de Entrada de Dados.
• Versão do Aplicativo (rodapé/topo secundário):
  • Exibe a versão instalada (ex.: 1.4.2). Útil para suporte e diagnóstico — anote essa versão ao abrir chamados.
  • Em situações de incompatibilidade, o suporte pode pedir essa versão para verificar necessidade de update.
• Campo de Busca (texto e voz):
  • Entrada por texto: aceita código da planilha (ex.: “ATAK – APPCC 001”) ou termos do nome/descrição (“recebimento matéria prima”).
  • Entrada por voz: acionar o ícone de microfone permite ditar o termo; o sistema converte para texto e aplica a mesma lógica de busca.
  • Comportamento de resultado: a busca realiza correspondência por prefixo e palavras-chave; se não houver resultados exibe mensagem “Nenhuma planilha encontrada”.
  • Dicas: pesquisar pelo código é mais preciso; pesquisa por palavras pode retornar múltiplos resultados ordenados por relevância.
• Filtros (painel lateral/overlay):
  • Filtros disponíveis típicos: Tipo de Apontamento, Local da Planilha, Empresa, Programa de Qualidade, Formulário, Usuário, Turno, Status e período/data (quando aplicável).
  • Tipo de Apontamento: filtra entre “por Demanda” (preenchimentos sob demanda) e “por Dia” (planilhas diárias), alterando a disponibilidade e as regras de sincronização.
  • Local da Planilha: restringe a listagem apenas às planilhas associadas ao local selecionado.
  • Persistência: filtros podem permanecer ativos durante a sessão até que o usuário os limpe ou altere; ao aplicar, todos os gráficos/listas se atualizam conforme os critérios escolhidos.
• Listagem de Planilhas:
  • Código: identificação única (ex.: ATAK – APPCC 001).
  • Descrição: texto curto que descreve propósito (ex.: Recebimento de Matéria Prima).
  • Indicadores:
    • Quantidade de monitoramentos realizados: número de entradas/execuções já realizadas para a data/turno selecionado.
    • Itens pendentes: contagem de campos/checkpoints que ainda não foram preenchidos na última execução; serve para priorizar quais planilhas precisam atenção.
  • Marcadores visuais: ícones/labels que indicam estado (ex.: TESTE, BLOQUEADA, NOVA, COM PENDÊNCIAS).
• Botão de Sincronização (ícone ao lado da planilha):
  • Objetivo: baixar registros já iniciados/no servidor para permitir continuidade do preenchimento no dispositivo.
  • Comportamento ao tocar: inicia processo de verificação remoto; na conclusão, a planilha passa a exibir os registros baixados e o usuário pode “continuar preenchimento”.
  • Estados exibidos: carregando (spinner), sucesso (mensagem/ícone de OK) ou falha (mensagem de erro).
• Marcador “TESTE”:
  • Indica planilhas que estão em fase de validação/ambiente de teste. Essas planilhas não impactam relatórios oficiais e podem conter campos experimentais.
  • Normalmente só visível para perfis com permissão de teste/validação (ou para todos, dependendo da configuração do portal).

Busca e Filtros — fluxo e exemplos

• Exemplo de busca por código: digite “ATAK – APPCC 001” → sistema retorna a planilha exata em primeiro lugar.
• Exemplo de busca por nome: digite “recebimento” → retorna todas as planilhas que contenham a palavra no título/descrição, ordenadas por relevância.
• Busca por voz: diz “recebimento matéria prima” → conversão para texto → mesma lógica de filtro textual.
• Combinação com filtros: pesquise “recebimento” e selecione o Local = “Loja 4” e Tipo = “Por Turno” → a lista é reduzida às planilhas daquela loja com esse tipo.
• Comportamento quando não há resultados: mensagem sugerindo limpar filtros ou tentar outro termo; exemplo de texto: “Nenhuma planilha encontrada. Tente alterar os filtros ou buscar por outro termo.”

Sincronização — fluxo detalhado (o que o usuário vê)

• Pré-condições: estar com Data Base e Turno corretos; conexão de rede (recomendado).
• Ação do usuário: tocar no ícone de sincronizar ao lado da planilha desejada.
• Processo apresentado ao usuário:
  • 1) Tela mostra “Sincronizando…” com spinner.
  • 2) App consulta o servidor para registros já gravados naquela planilha, respeitando a configuração (por turno ou diária).
  • 3) Resultado possível:
    • Sucesso com registros: “Sincronização concluída — X monitoramentos baixados”. Agora o usuário pode continuar preenchendo os registros baixados.
    • Sucesso sem registros (ex.: turno diferente): “Nenhum preenchimento encontrado para sincronizar neste turno.” — exemplo comum em planilhas por turno quando o usuário está em turno diferente do registro.
    • Falha de rede/servidor: “Falha na sincronização. Verifique sua conexão e tente novamente.” com opção de tentar novamente.
• Regras por tipo de planilha:
  • Planilhas por Turno: sincronizam apenas registros do mesmo turno em que o usuário está logado. Ex.: usuário no Turno 1 só verá registros iniciados no Turno 1.
  • Planilhas Diárias: permitem sincronizar registros de qualquer turno do mesmo dia; trazem todos os registros daquele dia.
• Conflitos/continuidade: se um monitor começou preenchimento e outro também, a sincronização traz os registros e o app permite abrir cada execução separadamente; lógica de bloqueio/edição simultânea depende da configuração do servidor (o app exibirá mensagens caso o registro esteja bloqueado por outro usuário).

Estrutura Técnica e Comportamento (ampliado)

• Carregamento inicial: ao abrir a tela, o app solicita a lista de planilhas para a Data Base/Empresa/Turno selecionados.
• Atualização via filtros: qualquer alteração de filtro realiza nova consulta e atualiza a listagem.
• Estados da listagem:
  • Vazio: quando não há planilhas associadas ao filtro (mensagem orientando a alterar filtros).
  • Com itens: mostra indicadores e ações (sincronizar, abrir, ver histórico).
  • Carregando: spinner global ou por item durante consultas/sincronizações.
• Indicadores de progresso: a contagem de itens pendentes e monitoramentos realizados é derivada dos registros armazenados (local/servidor) e atualizada após sincronização.
• Segurança/permissões: visibilidade de planilhas e ações dependem do perfil do usuário (permissões definidas no portal). Usuários sem permissão de edição verão apenas visualização, por exemplo.

Regras de Negócio e Restrições (detalhadas)

• Turno vs Diário: sincronização e visibilidade respeitam o modo de configuração da planilha (por turno ou diária).
• Data Base: não permite seleção futura; relatórios e sincronizações se baseiam na Data Base definida.
• Permissões: a listagem e botões disponíveis dependem das permissões do usuário (visualizar, editar, sincronizar, validar, etc.).
• Planilhas TESTE: não devem entrar em relatórios oficiais; seu uso é restrito conforme política interna.
• Sincronização parcial: se houver falha, registros parcialmente enviados podem permanecer em estado pendente até nova tentativa.

Mensagens usuais e textos exibidos (exemplos)

• Sincronização concluída — X registros baixados.
• Nenhum preenchimento encontrado para sincronizar neste turno.
• Falha na sincronização. Verifique sua conexão e tente novamente.
• Nenhuma planilha encontrada. Tente alterar os filtros ou buscar por outro termo.
• Planilha em modo TESTE — resultados não serão enviados a relatórios oficiais.

Solução de problemas comuns (passo a passo)

• Não encontro a planilha:
  1. Verifique filtros ativos (local, tipo, turno).
  2. Tente buscar pelo código exato da planilha.
  3. Confirme se você tem permissão para visualizar aquela planilha.
• Sincronização retorna “nenhum preenchimento encontrado”:
  1. Confirme o Turno atual — se a planilha for por turno, você só verá registros do mesmo turno.
  2. Verifique se a Data Base está correta (pode estar selecionada outra data).
• Sincronização falha com erro de rede:
  1. Confira conexão de internet do dispositivo.
  2. Tente novamente após alguns minutos; se persistir, registre a versão do app e o UUID do dispositivo e contate suporte.
• Indicadores parecem errados (itens pendentes/monitoramentos):
  1. Realize uma sincronização manual para garantir dados atualizados.
  2. Se ainda houver divergência, informe ao suporte com prints, versão do app e UUID.

Observações Importantes e boas práticas

• Confirme sempre Data Base e Turno antes de iniciar preenchimentos — erros aqui geram registros no período/turno errado.
• Use a busca por código quando souber a identificação exata para encontrar a planilha mais rápido.
• Sincronize sempre que for continuar um preenchimento iniciado por outro usuário, e antes de concluir para garantir que você tenha a versão mais atual.
• Planilhas marcadas como “TESTE” não devem ser consideradas em relatórios; utilize-as apenas para validações.
• Ao abrir chamados de suporte, informe: passo a passo que gerou o problema, versão do app e UUID do dispositivo (ícone “i”).