Pontos de Interesse - Controle de Permanência Visão Geral da Interface O módulo "Controle de Permanência em Ponto de Interesse" apresenta uma ferramenta de monitoramento de veículos em tempo real. A tela principal está organizada em duas seções principais: uma área de filtros no topo e três painéis de visualização coloridos (verde, amarelo e vermelho) que exibem informações sobre veículos em diferentes estados de permanência. Cada painel colorido possui um contador numérico no topo e uma tabela que lista os veículos correspondentes àquela categoria de tempo de permanência. A interface utiliza um esquema de cores intuitivo para indicar o status de permanência dos veículos: verde para normal, amarelo para atenção e vermelho para alerta. Para acessar clique no menu FROTAS, seção PONTOS DE INTERESSE, opção  CONTROLE DE PERMANÊNCIA. Elementos da Interface Seção de Filtros Categoria Tipo: Lista suspensa múltipla seleção Propósito: Filtra veículos por categoria Valores: Carregados dinamicamente da tabela CategoriasVeiculos Obrigatório: Não Divisão Tipo: Lista suspensa múltipla seleção Propósito: Filtra veículos por divisão organizacional Valores: Carregados do estado da aplicação (listaDivisao) Obrigatório: Não Tipo Veículo Tipo: Lista suspensa com ícones Propósito: Filtra por tipo de veículo Valores: Constantes definidas em CONSTANTE_TIPO_VEICULO Observação: Exibe ícones representativos de cada tipo de veículo Obrigatório: Não Placa / Label Tipo: Campo de texto Propósito: Filtra veículos por placa ou identificador Validação: Busca por correspondência parcial (case-insensitive) Obrigatório: Não Nome ponto de interesse Tipo: Campo de texto Propósito: Filtra veículos por local atual Validação: Busca por correspondência parcial (case-insensitive) Obrigatório: Não Botões de Ação Botão de Pesquisa (ícone de lupa): Aplica os filtros selecionados Botão Limpar Filtros (ícone de arquivo): Restaura os filtros para o estado inicial Painéis de Controle A interface apresenta três painéis coloridos que categorizam os veículos baseados em seu tempo de permanência: Painel Verde (Normal) Cabeçalho: Verde com contador de veículos Colunas: Número, Veículo, Ponto de Interesse Dados exibidos por veículo: Divisão do veículo Placa do veículo Label do veículo Nome do ponto de interesse Data/hora de entrada Tempo de permanência Painel Amarelo (Atenção) Cabeçalho: Amarelo com contador de veículos Colunas e estrutura idênticas ao painel verde Indica veículos em zona de tempo intermediária Painel Vermelho (Alerta) Cabeçalho: Vermelho com contador de veículos Colunas e estrutura idênticas aos outros painéis Indica veículos que excederam o tempo máximo recomendado Propósito e Fluxo de Trabalho Esta tela tem como objetivo principal monitorar o tempo de permanência de veículos em diferentes pontos de interesse predefinidos. O sistema categoriza automaticamente os veículos em três níveis de atenção baseados em limites de tempo configurados para cada ponto de interesse. Fluxo de Trabalho Básico: O sistema carrega automaticamente todos os veículos ativos e seus respectivos pontos de interesse atuais Os veículos são distribuídos nos painéis verde, amarelo ou vermelho com base no tempo de permanência em relação aos limites configurados O usuário pode aplicar filtros para concentrar-se em veículos específicos ou pontos de interesse Os dados são atualizados automaticamente a cada 10 segundos para manter as informações em tempo real O operador monitora especialmente os veículos nos painéis amarelo e vermelho que podem requerer atenção Regras de Negócio: Cada ponto de interesse possui configurações próprias de limite de tempo para as faixas verde, amarela e vermelha A classificação de um veículo em uma faixa de cor é determinada pelo tempo que ele permanece em um ponto de interesse em relação aos limites configurados O sistema suporta diferentes tipos de veículos, categorias e divisões organizacionais Alguns pontos de interesse podem estar configurados para exibir avisos somente para veículos específicos (avisosPorVeiculo) Instruções Passo a Passo Como Filtrar Veículos Na seção superior da tela, localize os campos de filtro Selecione uma ou mais categorias no campo "Categoria" (opcional) Selecione uma ou mais divisões no campo "Divisão" (opcional) Selecione um tipo de veículo no campo "Tipo Veículo" (opcional) Digite uma placa ou label parcial no campo "Placa / Label" (opcional) Digite um nome de ponto de interesse parcial no campo correspondente (opcional) Clique no botão com ícone de lupa para aplicar os filtros Observe que os três painéis serão atualizados para mostrar apenas os veículos que correspondem aos critérios de filtro Como Limpar os Filtros Clique no botão com ícone de arquivo na barra de filtros Todos os campos de filtro serão resetados para seus valores padrão A visualização retornará a exibir todos os veículos disponíveis Como Interpretar os Painéis Painel Verde: Contém veículos dentro do limite de tempo aceitável para permanência O número no cabeçalho indica quantos veículos estão nesta condição Painel Amarelo: Contém veículos que estão se aproximando do limite máximo de permanência recomendado Requer atenção do operador para possíveis ações Painel Vermelho: Contém veículos que excederam o tempo máximo recomendado Indica prioridade de ação para o operador Como Analisar Informações de Veículos Em cada painel, observe as colunas que mostram: Número sequencial do registro Informações do veículo (divisão, placa e identificador) Informações do ponto de interesse (nome, data/hora de entrada e tempo de permanência) O tempo de permanência é exibido no formato [hh h mm min ss s] A data/hora de entrada mostra quando o veículo chegou ao ponto de interesse Os veículos são ordenados por data/hora de entrada (do mais antigo para o mais recente) Perguntas Frequentes Gerais Com que frequência os dados são atualizados? Os dados são atualizados automaticamente a cada 10 segundos, garantindo informações em tempo real. Por que alguns veículos não aparecem em nenhum painel mesmo existindo no sistema? Veículos podem não aparecer por vários motivos: O veículo não está associado a nenhum ponto de interesse O ponto de interesse está configurado para exibir avisos somente para veículos específicos O veículo foi excluído logicamente (exclusaoLogica = 1) Os filtros aplicados estão removendo o veículo da visualização Como são determinadas as cores dos painéis para cada veículo? Cada ponto de interesse possui configurações próprias com limiares para as faixas: Verde: Entre faixaInicioVerdeTempoPermanencia e faixaFimVerdeTempoPermanencia Amarela: Entre faixaInicioAmarelaTempoPermanencia e faixaFimAmarelaTempoPermanencia Vermelha: Entre faixaInicioVermelhaTempoPermanencia e faixaFimVermelhaTempoPermanencia Filtros Posso selecionar múltiplas divisões e categorias ao mesmo tempo? Sim, os campos Categoria e Divisão permitem seleção múltipla. Os filtros são case-sensitive? Não, as buscas por texto são case-insensitive. Por exemplo, procurar por "abc" encontrará registros com "ABC", "abc" ou "Abc". Por que não consigo ver todos os tipos de veículos no filtro? A lista de tipos de veículos é predefinida no sistema. Se não estiver vendo algum tipo específico, pode ser necessário cadastrá-lo nas configurações do sistema. Dados e Registros Por que o contador no topo de cada painel não corresponde ao número de veículos que vejo listados? O contador reflete o número de veículos após a aplicação dos filtros. Se os filtros estiverem ativos, o número pode ser menor que o total de veículos naquela categoria. E se um ponto de interesse não tiver limites de tempo configurados? Todos os pontos de interesse devem ter limites configurados para funcionamento correto do sistema. Se algum não tiver, os veículos nesse ponto podem não ser categorizados adequadamente. É possível exportar essa lista de veículos para análise posterior? A funcionalidade de exportação não está disponível diretamente nesta tela. Seria necessário implementar um botão adicional para essa funcionalidade. Se um veículo mudar de ponto de interesse, quanto tempo leva para refletir na interface? A mudança será refletida no próximo ciclo de atualização automática (até 10 segundos) ou imediatamente se você clicar no botão de pesquisa. Considerações Adicionais Este sistema de controle de permanência é especialmente útil para operações que necessitam monitorar o tempo que veículos permanecem em determinados locais, como estacionamentos, docas de carga, áreas de serviço ou pontos de interesse operacional. A categorização por cores permite identificação rápida de situações que requerem atenção, facilitando a gestão de exceções e a otimização de recursos. O recurso de atualização automática a cada 10 segundos garante que as informações estejam sempre atualizadas, permitindo reações rápidas a situações críticas. Os filtros abrangentes proporcionam flexibilidade para focar em áreas ou veículos específicos conforme necessário. Uma possível melhoria seria a adição de alertas sonoros ou notificações proativas quando veículos entram nas zonas amarela ou vermelha, além de capacidades de exportação de dados para análises históricas mais aprofundadas.