# Registro de Parada ## Descrição da Interface O módulo"**Registro de Paradas**" é uma ferramenta que permite aos usuários monitorar e analisar as paradas registradas no aplicativo MINHA ROTA. A tela está dividida em duas seções principais: à esquerda, um painel de filtros e uma tabela de resultados; à direita, um mapa interativo que mostra a localização geográfica das paradas registradas. O layout é limpo e organizado, seguindo um fluxo lógico de trabalho que permite ao usuário facilmente selecionar os parâmetros de pesquisa e visualizar os resultados tanto em formato tabular quanto geográfico. Para acessar clique no menu **ROTEIRIZAÇÃO** opção **REGISTRO DE PARADAS.** ## Elementos da Interface ### Painel de Filtros 1. **Cabeçalho da Tela** - Título: "Visualização de Registro de Paradas" 2. **Seleção de Veículo** - Rótulo: "1. Selecione o veículo:" - Tipo: Menu suspenso (dropdown) - Obrigatório: Sim - Valores: Lista de veículos ativos do cliente - Formato de exibição: Marca, modelo, placa, identificação opcional (labelVeiculo) e nome do condutor - Funcionalidade de pesquisa: Filtra por marca, modelo, placa, condutor ou identificação do veículo 3. **Seleção de Tipo de Parada** - Rótulo: "2. Escolha o tipo de parada (opcional):" - Tipo: Menu suspenso (dropdown) - Obrigatório: Não - Valores possíveis: - Parada programada - Solicitação de motorista - Solicitação externa - Solicitação agente rodoviário - Acidente na Via - Acidente com o veículo - Defeito no veículo - Troca programada de veículo - Outro 4. **Seleção de Data** - Rótulo: "3. Informe a Data (opcional):" - Tipo: Seletor de data (date picker) - Obrigatório: Não - Formato: Dia/Mês/Ano - Configuração: Calendário interativo para seleção da data 5. **Botão de Pesquisa** - Rótulo: "Pesquisar" - Ícone: Lupa (feather icon "icon-search") - Estado: Desabilitado quando nenhum veículo está selecionado - Função: Realiza a pesquisa com os parâmetros configurados 6. **Botão Ver Todos** - Rótulo: "Ver Todos" - Ícone: "select\_all" - Visibilidade: Aparece apenas quando um aviso está selecionado - Função: Exibe todos os marcadores no mapa ### Tabela de Resultados 1. **Tabela de Paradas** - Colunas: - Número da ordem (contagem regressiva) - Ícone do tipo de parada - Detalhes da parada - Funcionalidade: Selecionar uma linha destaca a respectiva parada no mapa - Rolagem: Possui barra de rolagem vertical quando há muitos registros - Mensagem quando não há dados: "Não existem dados para os parâmetros informados." 2. **Detalhes na Coluna de Parada**: - Tipo de parada - Data e hora da parada - Informações do veículo (modelo, placa, condutor) - Descrição/localização (quando disponível) ### Mapa Interativo 1. **Mapa** - Tipo: Google Maps - Posição: Ocupa a metade direita da tela - Funcionalidades: - Marcadores indicando a localização das paradas - Zoom ajustável - Modo de visualização alternável (Mapa/Satélite) - Ajuste automático de zoom para mostrar todos os pontos - Centralização automática ao selecionar uma parada na tabela 2. **Marcadores do Mapa** - Representação visual: Ícones diferenciados por tipo de parada - Informações ao passar o mouse: Tipo de parada, condutor, descrição, data/hora ## Propósito e Fluxo de Trabalho ### Propósito A ferramenta "Visualização de Registro de Paradas" permite aos gestores de frota monitorar e analisar as paradas não planejadas e programadas dos veículos. Isso ajuda a: - Identificar padrões de paradas não autorizadas - Monitorar o cumprimento de rotas planejadas - Avaliar tempos de descanso e paradas de motoristas - Analisar ocorrências de problemas mecânicos ou acidentes - Verificar pontos de abastecimento ou manutenção ### Fluxo de Trabalho 1. O usuário seleciona um veículo da frota (campo obrigatório) 2. Opcionalmente, o usuário pode filtrar por tipo específico de parada 3. Opcionalmente, o usuário pode especificar uma data para a pesquisa 4. Ao clicar em "Pesquisar", o sistema: - Consulta o banco de dados por registros que correspondam aos filtros - Exibe os resultados na tabela à esquerda - Posiciona marcadores no mapa para cada parada encontrada - Ajusta o zoom do mapa para mostrar todos os marcadores 5. O usuário pode selecionar uma parada específica na tabela para: - Centralizar o mapa nessa localização - Mostrar apenas esse marcador no mapa 6. O usuário pode clicar em "Ver Todos" para exibir novamente todos os marcadores no mapa ## Instruções Passo a Passo ### Como Visualizar Registros de Paradas 1. **Selecionar um Veículo** - Clique no campo dropdown "1. Selecione o veículo" - Digite para filtrar a lista ou selecione diretamente um veículo da lista exibida - Confirme a seleção clicando no veículo desejado 2. **Aplicar Filtros Opcionais** - Para filtrar por tipo de parada: - Clique no campo dropdown "2. Escolha o tipo de parada (opcional)" - Selecione um dos tipos de parada disponíveis - Para filtrar por data: - Clique no campo de data "3. Informe a Data (opcional)" - Selecione a data desejada no calendário que aparece 3. **Realizar a Pesquisa** - Clique no botão "Pesquisar" (com ícone de lupa) - Aguarde o carregamento dos resultados 4. **Analisar os Resultados** - Verifique a tabela à esquerda para uma lista das paradas encontradas - Observe o mapa à direita para a localização geográfica das paradas - Note que o sistema automaticamente ajusta o zoom do mapa para mostrar todos os pontos 5. **Examinar uma Parada Específica** - Clique em uma linha da tabela para selecionar uma parada específica - O mapa centralizará automaticamente nesse ponto e ocultará os demais marcadores - Para voltar a ver todos os marcadores, clique no botão "Ver Todos" ### Como Interpretar os Marcadores no Mapa 1. Os marcadores no mapa representam as paradas registradas 2. A cor e ícone do marcador indicam o tipo de parada 3. Ao passar o mouse sobre um marcador, uma dica de contexto exibirá: - Tipo de parada - Nome do condutor - Descrição da localização (quando disponível) - Data e hora da parada ## Validações e Regras de Negócio 1. **Seleção de Veículo** - É obrigatória para realizar a pesquisa - O botão "Pesquisar" permanece desabilitado até que um veículo seja selecionado 2. **Filtros Opcionais** - Tipo de parada e data são opcionais - Se nenhum filtro opcional for aplicado, o sistema retornará todos os registros de parada do veículo selecionado 3. **Exibição de Resultados** - Se não houver registros correspondentes aos filtros aplicados, uma mensagem de alerta será exibida: "Não existem dados para os parâmetros informados." - A tabela e o mapa são atualizados apenas após clicar no botão "Pesquisar" 4. **Integração com o Mapa** - Os marcadores no mapa são sincronizados com a tabela de resultados - Selecionar um registro na tabela afeta a visualização do mapa, mas não vice-versa 5. **Permissões** - Apenas usuários com acesso à funcionalidade "REGISTRO\_PARADAS" podem visualizar esta tela - Os veículos listados são filtrados conforme as permissões do usuário logado ## Perguntas Frequentes ### Por que o botão "Pesquisar" está desabilitado? O botão "Pesquisar" permanecerá desabilitado até que um veículo seja selecionado, pois este é um campo obrigatório para a consulta. Selecione um veículo na primeira lista suspensa para habilitar o botão. ### Como posso ver paradas de um período específico? A tela atual permite filtrar por uma data específica. Se você precisa visualizar um intervalo de datas, será necessário realizar pesquisas individuais para cada dia e analisar os resultados separadamente. ### Por que alguns veículos não aparecem na lista de seleção? A lista exibe apenas veículos ativos associados ao seu usuário e que possuem pelo menos um registro de parada. Verifique se o veículo está ativo no sistema e se você tem as permissões necessárias para visualizá-lo. ### Como distinguir entre diferentes tipos de paradas no mapa? Cada tipo de parada é representado por um ícone diferente no mapa. A legenda específica não está visível na interface, mas ao passar o mouse sobre um marcador, você verá o tipo de parada na dica de contexto. ### É possível exportar os dados das paradas? A funcionalidade de exportação não está disponível diretamente nesta tela. Para obter relatórios exportáveis, você precisará utilizar o módulo de relatórios do sistema. ### Por que o mapa mostra apenas um marcador depois que selecionei uma parada? Quando você seleciona uma parada específica na tabela, o sistema oculta temporariamente os outros marcadores para facilitar a visualização do ponto selecionado. Para voltar a ver todos os marcadores, clique no botão "Ver Todos". ### Posso visualizar a rota que o veículo percorreu entre as paradas? Esta funcionalidade não está disponível nesta tela, que mostra apenas os pontos de parada. Para visualizar o trajeto completo do veículo, utilize a funcionalidade de histórico de posições ou de rastreamento do sistema. ### Como sei se uma parada foi autorizada ou não? O tipo de parada indica a natureza da parada (programada, solicitação do motorista, etc.). Para determinar se foi autorizada, compare com o planejamento de rota e as políticas da empresa.