# Avisos por Data # 1. Avisos por Data ## 1.0 Menu Menu **Avisos** e sub-menu **Avisos por Data** ## 1.1. Descrição Geral A interface "Avisos" é parte de um sistema de gerenciamento de frota que permite monitorar e visualizar alertas associados a veículos rastreados. O sistema apresenta uma interface dividida em duas seções principais: um painel de filtros e controles à esquerda, e um mapa interativo à direita que exibe a localização geográfica dos eventos. Na área de listagem, o sistema apresenta alertas relacionados aos veículos monitorados, como desligamentos, problemas de comunicação e outros eventos importantes. Cada alerta contém informações detalhadas como tipo de evento, veículo, condutor, data/hora, localização e detalhes de contato. O mapa interativo exibe marcadores coloridos que representam a localização dos eventos, utilizando um sistema de cores para diferenciar os tipos de alertas (vermelho para alertas críticos e verde para informações normais). ## 1.2. Elementos da Interface ### 1.2.1. Seção de Filtros 1. **Seleção de Veículo** - Campo: Dropdown com busca - Exemplo preenchido: "Honda CG 125 FAN - ODX-1939 - Ramylos" - Obrigatório: Sim - Funcionalidade: Permite filtragem por veículo específico - Validação: Requer seleção para ativar a pesquisa 2. **Tipo de Aviso** - Campo: Dropdown de seleção múltipla - Opcional: Sim - Valores possíveis: Lista extensa de tipos de alertas (Abastecimento, Abertura Capô, Aceleração Brusca, etc.) - Funcionalidade: Filtra alertas por categorias específicas 3. **Período de Data** - Campos: Dois seletores de data (início e fim) - Formato: DD-MM-YYYY - Exemplo: "02-03-2025" a "09-03-2025" - Opcional: Sim - Funcionalidade: Limita resultados ao intervalo de datas especificado - Validação: Data final deve ser posterior à data inicial 4. **Botão de Pesquisa** - Funcionalidade: Executa a busca com os critérios selecionados - Estado: Ativo somente quando veículo selecionado 5. **Botão "Todos"** - Funcionalidade: Exibe todos os alertas novamente após uma filtragem - Visibilidade: Aparece somente quando um alerta específico está selecionado ### 1.2.2. Seção de Resultados 1. **Lista de Avisos** - Exibição: Tabela com múltiplas linhas de alertas - Ordenação: Por data/hora decrescente (mais recente primeiro) - Selecionar: Clicável para visualizar detalhes no mapa - Informações por alerta: - Índice numérico (contador decrescente) - Ícone do tipo de alerta - Título do aviso (Ex: "Aviso de Veículo Desligado") - Nome do condutor - Data/hora do evento (formato: DD-MM-YYYY HH:MM:SS) - Localização/endereço - Informações de contato (email) - Detalhes adicionais específicos do evento 2. **Mensagem de Ausência de Dados** - Exibição: Alerta vermelho quando não há resultados - Mensagem: "Não existem dados para os parâmetros informados." - Visibilidade: Somente quando pesquisa não retorna resultados ### 1.2.3. Mapa Interativo 1. **Visualização Cartográfica** - Tipo: Google Maps - Controles: Zoom, alternar entre mapa e satélite - Marcadores: Indicam localização dos eventos - Vermelho: Alertas críticos/negativos (Ex: desligamentos, problemas) - Verde: Informações normais/positivas - Interatividade: Centraliza e amplia ao clicar em um alerta na lista - Função "Ver Todos": Reexibe todos os marcadores após filtro individual ### 1.2.4. Modal de Mídia 1. **Popup de Visualização de Vídeo** - Funcionalidade: Exibe vídeos associados aos alertas - Elementos: - Título (tipo de aviso) - Subtítulo (condutor) - Data/hora - Player de vídeo - Controles: Reproduzir, pausar, controle de volume ## 1.3. Fluxo de Trabalho 1. **Início** - O usuário acessa a tela de Avisos - Por padrão, é necessário selecionar um veículo para iniciar a pesquisa - O período de 7 dias anteriores é pré-selecionado 2. **Filtragem** - Usuário seleciona um veículo específico - Opcionalmente define tipos de avisos específicos - Opcionalmente ajusta o período de datas - Clica no botão de pesquisa (ícone de lupa) 3. **Visualização de Resultados** - Sistema exibe lista de avisos correspondentes aos filtros - Marcadores são exibidos no mapa para cada evento - Zoom do mapa é ajustado para mostrar todos os pontos 4. **Interação com Alertas** - Ao clicar em um alerta na lista: - O mapa centraliza neste ponto - O zoom é aumentado - Outros marcadores são ocultados - O botão "Todos" aparece, permitindo voltar à visualização completa 5. **Visualização de Mídias** - Para alertas com vídeos associados: - Miniatura do vídeo é exibida na lista - Usuário pode clicar em "Abrir Vídeo" - Um popup é exibido com o player de vídeo ## 1.4. Instruções Passo a Passo ### 1.4.1. Como Pesquisar Avisos 1. Na seção "1. Selecione o veículo:", clique no dropdown e selecione o veículo desejado - Você pode digitar para filtrar a lista de veículos - Informações como marca, modelo, placa e condutor são exibidas 2. (Opcional) Em "2. Escolha o tipo do aviso:", selecione um ou mais tipos de alertas específicos - Você pode selecionar múltiplos tipos mantendo a lista aberta 3. (Opcional) Em "3. Informe a Data:", defina o período desejado: - Clique no primeiro campo para definir a data inicial - Clique no segundo campo para definir a data final - Por padrão, o sistema usa os últimos 7 dias 4. Clique no botão de pesquisa (ícone de lupa) para executar a busca ### 1.4.2. Como Interagir com os Resultados 1. Após a pesquisa, analise a lista de avisos exibida: - Verifique o tipo de aviso, data/hora e local - Observe os marcadores correspondentes no mapa 2. Para focalizar um aviso específico: - Clique em qualquer linha da tabela de avisos - O mapa centralizará e ampliará o ponto selecionado - Apenas o marcador selecionado permanecerá visível 3. Para retornar à visualização de todos os pontos: - Clique no botão "Todos" que aparece após selecionar um aviso ### 1.4.3. Como Visualizar Vídeos Associados 1. Para avisos com vídeos disponíveis: - Uma miniatura do vídeo será exibida na linha do aviso - Clique em "Abrir Vídeo" ao lado da miniatura 2. No popup de vídeo: - Visualize as informações do evento (título, condutor, data) - Use os controles do player para reproduzir o vídeo - Feche o popup quando terminar a visualização ## 1.5. Regras de Negócio 1. **Acesso a Dados** - O sistema mostra apenas veículos associados ao cliente autenticado - Caso a sessão expire, o usuário é redirecionado para a tela de login 2. **Filtragem de Avisos** - É necessário selecionar pelo menos um veículo para realizar a pesquisa - Filtros de tipo e data são opcionais - Pesquisas podem ser feitas por data única ou por período 3. **Exibição de Dados** - Alertas são ordenados por data (mais recente primeiro) - Cada tipo de aviso tem um ícone específico para fácil identificação - Diferentes cores de marcadores indicam diferentes categorias de eventos 4. **Tratamento de Endereços** - O sistema exibe o endereço aproximado baseado nas coordenadas do evento - Quando não é possível determinar o endereço, são exibidas apenas as coordenadas 5. **Comunicação com Dispositivos** - Sistema verifica conexão com dispositivos e gera alertas de "Comunicação desatualizada" - Eventos como desligamento do veículo são reportados em tempo real ## 1.6. Perguntas Frequentes ### 1.6.1. Geral 1. **Como sei se um aviso é crítico?** - Os avisos críticos geralmente aparecem com marcadores vermelhos no mapa e com ícones de alerta na listagem. 2. **O que significa "Comunicação desatualizada"?** - Indica que o sistema não conseguiu comunicação com o dispositivo do veículo pelo tempo especificado. Isso pode ocorrer por diversos motivos, incluindo problemas de sinal, dispositivo desligado ou falha no equipamento. 3. **Posso exportar a lista de avisos?** - A exportação não está disponível diretamente nesta tela. Para relatórios completos, acesse a seção "Relatórios" no menu principal. ### 1.6.2. Filtros e Pesquisa 4. **Por que o botão de pesquisa está desativado?** - O botão só fica ativo após a seleção de um veículo. Verifique se você selecionou um veículo na lista dropdown. 5. **Como pesquiso por vários tipos de avisos ao mesmo tempo?** - No dropdown "Tipo de Aviso", mantenha a lista aberta e selecione múltiplos itens clicando em cada um deles. 6. **Qual o período máximo que posso visualizar?** - Não há limite técnico para o período, mas períodos muito longos podem resultar em muitos dados e afetar o desempenho. ### 1.6.3. Visualização de Dados 7. **O que significam as diferentes cores dos marcadores no mapa?** - Geralmente, vermelho indica alertas críticos ou eventos negativos, enquanto verde indica estados normais ou positivos. 8. **Por que não consigo ver vídeos para todos os avisos?** - Apenas alguns tipos de eventos capturam vídeos, dependendo da configuração do dispositivo e da natureza do evento. 9. **Como vejo mais detalhes sobre um local específico?** - Clique no aviso na lista para centralizar o mapa naquele ponto. Você também pode utilizar os controles do Google Maps para alternar entre visualizações de mapa e satélite. 10. **O que acontece se não houver avisos no período selecionado?** - O sistema exibirá uma mensagem alertando que "Não existem dados para os parâmetros informados."