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) 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) Campo Status Tipo: Dropdown (v-select) Função: Filtrar por status da roteirização Valores possíveis: ABERTA, AGENDADA, EM_ANDAMENTO, FINALIZADA, CANCELADA 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 Botões de Ação Botão de Pesquisa (ícone de lupa) Botão Limpar Filtros (ícone de arquivo) Controles de Exibição Toggle "ATUALIZAR?" Tipo: Switch (vs-switch) Função: Ativa/desativa atualização automática dos dados a cada 10 segundos Estados: Ligado/Desligado Toggle "DASHBOARD" Tipo: Switch (vs-switch) Função: Alterna entre visualização de tabela e dashboard estatístico Estados: Ligado/Desligado 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: # : Número sequencial Status : Ícone representando status (CheckCircle, ArrowRightCircle, MoreHorizontal, Calendar, XCircle) Placa do Veículo : Identificação do veículo Qtd. Itinerários : Formato "entregues/total [renegociados]" ID : Identificador único da roteirização Início : Data e hora do início previsto Coluna vazia : Separador Fim : Data e hora do fim previsto KM : Distância estimada em quilômetros Tempo : Tempo estimado para conclusão Peso : Peso total da carga Volume : Volume total da carga Ações : Botões para visualizar itinerários e indicadores de ocorrências Painéis de Dashboard (Quando ativado) Cards Estatísticos : Itinerários : Total de itinerários programados Entregues : Total de itinerários entregues Renegociadas : Total de itinerários renegociados Pendentes : Total de itinerários pendentes Percentual de Sucesso : Taxa de entregas realizadas 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 # : Ordem planejada VISITA/PEDIDO : Número da visita ou pedido (depende do tipo de roteirização) VALOR : Valor do pedido (apenas para roteirização de pedidos) STATUS : Estado atual do itinerário PREVISÃO : Data e hora prevista para a visita CHECKIN : Data e hora do checkin CHECKOUT : Data e hora do checkout EXECUTADO : Horário de execução CODIGO : Código do ponto de interesse NOME : Nome do ponto de interesse ORDEM : Ordem de execução 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 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 Botão Adicionar Tipo: Botão (vs-button) Função: Adicionar nova ocorrência Tabela de Ocorrências Colunas: Tipo : Tipo da ocorrência Cadastrado : Data e hora de cadastro Tratado : Data e hora de tratamento Status : Status da ocorrência (PENDENTE/TRATADO) Botões de Ação Pesquisar : Atualiza a lista de ocorrências 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: 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 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 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 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 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: Auto-atualização : Quando ativada, a tela é atualizada a cada 10 segundos para refletir o status atual das roteirizações. 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 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 Gestão de Ocorrências : Ocorrências podem ser cadastradas, consultadas e tratadas, mantendo registro de quem e quando foram tratadas. Restrições de Edição : Não é possível modificar roteirizações finalizadas ou canceladas. Instruções Passo a Passo Como Filtrar Roteirizações Acesse a tela de Monitoramento de Rotas Selecione um veículo no campo "Veículo" (opcional) Selecione um status no campo "Status" (opcional) Defina um período nas datas de início e fim Clique no botão de pesquisa (ícone de lupa) O sistema exibirá as roteirizações que correspondem aos critérios Como Ativar a Atualização Automática Localize o switch "ATUALIZAR?" na parte superior da tela Clique no switch para ativá-lo A tela será atualizada automaticamente a cada 10 segundos Para desativar, clique novamente no switch Como Visualizar Itinerários de uma Roteirização Nas linhas da tabela de roteirizações, localize a roteirização desejada Clique no botão de lista (ícone) na coluna de ações O popup de itinerários será exibido com a lista de todas as paradas Verifique os detalhes de cada itinerário na tabela Como Registrar uma Ocorrência No popup de itinerários, localize o itinerário que necessita de registro de ocorrência Clique no botão de sino (ícone) na linha do itinerário No popup de ocorrências, selecione o tipo de ocorrência no dropdown Clique no botão de adicionar (ícone +) A ocorrência será adicionada à tabela Se necessário, edite o status da ocorrência entre "PENDENTE" e "TRATADO" Clique no botão "Gravar" para salvar as alterações Como Alternar entre Visualização de Tabela e Dashboard Localize o switch "DASHBOARD" na parte superior da tela Clique no switch para ativar a visualização de dashboard A tela exibirá cards estatísticos e gráficos em vez da tabela detalhada 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.