Skip to main content

Monitorar Roteirizações

Descrição da Interface

O módulo "Monitorar de Roteirizações" apresenta uma interface moderna e estruturada para o gerenciamento de roteirizações de entregas ou visitas. A interface foi projetada para proporcionar uma visão abrangente das roteirizações programadas, permitindo o monitoramento em tempo real do status das visitas, sua organização cronológica, e a gestão de ocorrências relacionadas.

A interface apresenta um layout responsivo com uma área superior para filtragem, uma seção central para visualização de rotas em formato de linha do tempo, e uma área inferior que alterna entre um painel de estatísticas (dashboard) ou uma tabela detalhada das roteirizações.

Os elementos visuais utilizam um esquema de cores intuitivo que facilita a compreensão do status das rotas, com indicadores visuais como ícones e cores diferenciadas para representar diferentes estados de entrega.

Para acessar clique no menu ROTEIRIZAÇÃO opção MONITORAR ROTEIRIZAÇÕES.

Elementos da Interface

Tela Principal - Monitoramento de Rotas

Área de Filtros (Superior)

  1. Campo Veículo

    • Tipo: Dropdown (v-select)
    • Função: Permite filtrar por veículo específico
    • Valores possíveis: Lista de veículos cadastrados no sistema
    • Dados mostrados: Placa, modelo e identificação opcional (labelVeiculo)

  2. Campo Status

    • Tipo: Dropdown (v-select)
    • Função: Filtrar por status da roteirização
    • Valores possíveis: ABERTA, AGENDADA, EM_ANDAMENTO, FINALIZADA, CANCELADA

  3. Campos de Data (Período)

    • Tipo: Datepicker (flatPickr)
    • Função: Filtrar por período de datas
    • Formato: DD-MM-YYYY
    • Configuração: Intervalo com data inicial e final

  4. Botões de Ação

    • Botão de Pesquisa (ícone de lupa)
    • Botão Limpar Filtros (ícone de arquivo)

Controles de Exibição

  1. Toggle "ATUALIZAR?"

    • Tipo: Switch (vs-switch)
    • Função: Ativa/desativa atualização automática dos dados a cada 10 segundos
    • Estados: Ligado/Desligado

  2. Toggle "DASHBOARD"

    • Tipo: Switch (vs-switch)
    • Função: Alterna entre visualização de tabela e dashboard estatístico
    • Estados: Ligado/Desligado

  3. Contador de Roteirizações

    • Exibe o número total de roteirizações encontradas

Área de Timeline (Linha do Tempo)

  • Visualização gráfica das rotas
  • Cada linha representa uma rota com:
    • Número sequencial
    • Horário inicial (ex: 12:00)
    • Linha com pontos representando os itinerários
    • Horário final (ex: 14:36)
  • Cada ponto na linha representa uma parada/visita
  • Numerados de 1 a 5 (ou conforme quantidade de itinerários)

Tabela de Roteirizações

  • Colunas:
    1. #: Número sequencial
    2. Status: Ícone representando status (CheckCircle, ArrowRightCircle, MoreHorizontal, Calendar, XCircle)
    3. Placa do Veículo: Identificação do veículo
    4. Qtd. Itinerários: Formato "entregues/total [renegociados]"
    5. ID: Identificador único da roteirização
    6. Início: Data e hora do início previsto
    7. Coluna vazia: Separador
    8. Fim: Data e hora do fim previsto
    9. KM: Distância estimada em quilômetros
    10. Tempo: Tempo estimado para conclusão
    11. Peso: Peso total da carga
    12. Volume: Volume total da carga
    13. Ações: Botões para visualizar itinerários e indicadores de ocorrências

Painéis de Dashboard (Quando ativado)

  • Cards Estatísticos:

    1. Itinerários: Total de itinerários programados
    2. Entregues: Total de itinerários entregues
    3. Renegociadas: Total de itinerários renegociados
    4. Pendentes: Total de itinerários pendentes
    5. Percentual de Sucesso: Taxa de entregas realizadas
    6. Ocorrências: Total de ocorrências registradas

  • Gráfico de Barras: Visualização gráfica dos dados estatísticos

Popup de Itinerários

Cabeçalho da Tabela

  1. #: Ordem planejada
  2. VISITA/PEDIDO: Número da visita ou pedido (depende do tipo de roteirização)
  3. VALOR: Valor do pedido (apenas para roteirização de pedidos)
  4. STATUS: Estado atual do itinerário
  5. PREVISÃO: Data e hora prevista para a visita
  6. CHECKIN: Data e hora do checkin
  7. CHECKOUT: Data e hora do checkout
  8. EXECUTADO: Horário de execução
  9. CODIGO: Código do ponto de interesse
  10. NOME: Nome do ponto de interesse
  11. ORDEM: Ordem de execução
  12. Ações: Botão para registrar ocorrências

Dados dos Itinerários

  • Lista de itinerários com todos os dados relacionados
  • Botão para registrar ocorrências para cada itinerário

Popup de Ocorrências

Área de Cadastro

  1. Dropdown Tipo de Ocorrência

    • Tipo: Dropdown (v-select)
    • Função: Selecionar o tipo de ocorrência
    • Valores: Lista de tipos de ocorrências cadastradas

  2. Botão Adicionar

    • Tipo: Botão (vs-button)
    • Função: Adicionar nova ocorrência

Tabela de Ocorrências

  • Colunas:
    1. Tipo: Tipo da ocorrência
    2. Cadastrado: Data e hora de cadastro
    3. Tratado: Data e hora de tratamento
    4. Status: Status da ocorrência (PENDENTE/TRATADO)

Botões de Ação

  1. Pesquisar: Atualiza a lista de ocorrências
  2. Gravar: Salva as alterações nas ocorrências

Propósito e Fluxo de Trabalho

O Sistema de Monitoramento de Rotas foi desenvolvido para gerenciar e acompanhar roteirizações de entregas ou visitas técnicas. Ele permite visualizar o progresso das rotas, identificar problemas e gerir ocorrências de forma eficiente.

Fluxo de Trabalho Principal:

  1. Filtrar Roteirizações:

    • O usuário seleciona os critérios de filtro (veículo, status, período)
    • Sistema exibe as roteirizações que correspondem aos critérios

  2. Monitorar Progresso:

    • A visualização de timeline permite acompanhar o progresso das rotas
    • A tabela ou dashboard apresenta informações detalhadas sobre cada roteirização

  3. Gerenciar Itinerários:

    • Ao selecionar uma roteirização, o usuário pode visualizar seus itinerários
    • Os detalhes de cada parada são exibidos, incluindo checkins e checkouts

  4. Registrar e Gerenciar Ocorrências:

    • Para itinerários com problemas, o usuário pode registrar ocorrências
    • As ocorrências podem ser tratadas e ter seu status atualizado

  5. Análise de Desempenho:

    • O dashboard apresenta métricas de desempenho como taxa de sucesso de entregas
    • Os gráficos facilitam a visualização de indicadores chave

Regras de Negócio Importantes:

  1. Auto-atualização: Quando ativada, a tela é atualizada a cada 10 segundos para refletir o status atual das roteirizações.

  2. Estados da Roteirização: Uma roteirização pode passar pelos estados:

    • AGENDADA: Programada mas ainda não iniciada
    • ABERTA: Disponível para início
    • EM_ANDAMENTO: Em execução
    • FINALIZADA: Concluída
    • CANCELADA: Cancelada sem conclusão

  3. Status dos Itinerários: Os itinerários podem ter diferentes status, como:

    • Visita Aberta
    • Visita Adiada
    • Visita Pendente
    • Visita Realizada
    • Entregue
    • Devolvido
    • Endereço Fechado
    • Endereço Errado
    • Endereço Não Localizado

  4. Gestão de Ocorrências: Ocorrências podem ser cadastradas, consultadas e tratadas, mantendo registro de quem e quando foram tratadas.

  5. Restrições de Edição: Não é possível modificar roteirizações finalizadas ou canceladas.

Instruções Passo a Passo

Como Filtrar Roteirizações

  1. Acesse a tela de Monitoramento de Rotas
  2. Selecione um veículo no campo "Veículo" (opcional)
  3. Selecione um status no campo "Status" (opcional)
  4. Defina um período nas datas de início e fim
  5. Clique no botão de pesquisa (ícone de lupa)
  6. O sistema exibirá as roteirizações que correspondem aos critérios

Como Ativar a Atualização Automática

  1. Localize o switch "ATUALIZAR?" na parte superior da tela
  2. Clique no switch para ativá-lo
  3. A tela será atualizada automaticamente a cada 10 segundos
  4. Para desativar, clique novamente no switch

Como Visualizar Itinerários de uma Roteirização

  1. Nas linhas da tabela de roteirizações, localize a roteirização desejada
  2. Clique no botão de lista (ícone) na coluna de ações
  3. O popup de itinerários será exibido com a lista de todas as paradas
  4. Verifique os detalhes de cada itinerário na tabela

Como Registrar uma Ocorrência

  1. No popup de itinerários, localize o itinerário que necessita de registro de ocorrência
  2. Clique no botão de sino (ícone) na linha do itinerário
  3. No popup de ocorrências, selecione o tipo de ocorrência no dropdown
  4. Clique no botão de adicionar (ícone +)
  5. A ocorrência será adicionada à tabela
  6. Se necessário, edite o status da ocorrência entre "PENDENTE" e "TRATADO"
  7. Clique no botão "Gravar" para salvar as alterações

Como Alternar entre Visualização de Tabela e Dashboard

  1. Localize o switch "DASHBOARD" na parte superior da tela
  2. Clique no switch para ativar a visualização de dashboard
  3. A tela exibirá cards estatísticos e gráficos em vez da tabela detalhada
  4. Para voltar à visualização de tabela, clique novamente no switch

Perguntas Frequentes

1. Como identifico roteirizações com problemas?

Roteirizações com ocorrências pendentes são indicadas por um ícone de sino na coluna de ações. Você também pode filtrar por status para localizar roteirizações que não foram finalizadas conforme o cronograma.

2. O que significa a exibição "3/5 [1]" na coluna de itinerários?

Esta notação indica que, de um total de 5 itinerários, 3 foram entregues/realizados com sucesso e 1 foi renegociado. Os demais estão pendentes.

3. É possível alterar um itinerário de uma roteirização já iniciada?

Sim, é possível alterar itinerários de roteirizações que estejam nos status "ABERTA" ou "EM_ANDAMENTO". Roteirizações "FINALIZADAS" ou "CANCELADAS" não podem ser alteradas.

4. Como funciona a atualização automática?

Quando ativada, a tela faz uma consulta ao servidor a cada 10 segundos para atualizar os dados exibidos. Isso permite acompanhar o progresso das roteirizações em tempo real sem precisar atualizar a página manualmente.

5. Por que algumas roteirizações aparecem com peso e volume zerados?

Roteirizações sem registros de peso e volume podem estar em fase de planejamento ou podem representar roteirizações de visitas técnicas, onde não há transporte de mercadorias.

6. Como tratar uma ocorrência registrada?

Acesse o popup de ocorrências do itinerário, altere o status da ocorrência para "TRATADO" e, se necessário, adicione informações na área de tratativa. Em seguida, clique em "Gravar" para salvar as alterações.

7. É possível excluir uma roteirização?

Roteirizações podem ser excluídas apenas se não tiverem sido sincronizadas com dispositivos móveis. Para excluir, é necessário primeiro apagar a sincronização através do módulo de ROTAS.

8. Como interpretar a visualização de timeline?

Cada linha horizontal representa uma roteirização, com o horário inicial à esquerda e o final à direita. Os pontos numerados ao longo da linha representam os itinerários (paradas) planejados, na ordem em que devem ser executados.

Informações Técnicas Adicionais

O sistema implementa uma estrutura de dados robusta que gerencia diferentes tipos de roteirizações: entregas de produtos (pedidos) e visitas técnicas. As roteirizações são armazenadas com todos os metadados necessários, incluindo coordenadas geográficas, tempos estimados, e dados de carga.

O sistema realiza várias validações importantes:

  • Checagem de dados temporais: não permite registrar um fim de rota anterior ao início
  • Validação de sequência de status: respeita a sequência de estados da roteirização (AGENDADA → ABERTA → EM_ANDAMENTO → FINALIZADA)
  • Verificação de permissões de alteração: impede modificações em roteirizações já finalizadas ou canceladas

Os campos de valor monetário, peso e volume são formatados com a função formatarNumero() que aplica as configurações regionais de exibição para facilitar a leitura dos valores.

Back to top