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

1. 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

2. 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

3. 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

4. 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

5. 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

6. 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:

1. 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

2. 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

3. 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:

1. O sistema carrega automaticamente todos os veículos ativos e seus respectivos pontos de interesse atuais
2. 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
3. O usuário pode aplicar filtros para concentrar-se em veículos específicos ou pontos de interesse
4. Os dados são atualizados automaticamente a cada 10 segundos para manter as informações em tempo real
5. 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

1. Na seção superior da tela, localize os campos de filtro
2. Selecione uma ou mais categorias no campo "Categoria" (opcional)
3. Selecione uma ou mais divisões no campo "Divisão" (opcional)
4. Selecione um tipo de veículo no campo "Tipo Veículo" (opcional)
5. Digite uma placa ou label parcial no campo "Placa / Label" (opcional)
6. Digite um nome de ponto de interesse parcial no campo correspondente (opcional)
7. Clique no botão com ícone de lupa para aplicar os filtros
8. 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

1. Clique no botão com ícone de arquivo na barra de filtros
2. Todos os campos de filtro serão resetados para seus valores padrão
3. A visualização retornará a exibir todos os veículos disponíveis

Como Interpretar os Painéis

1. 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

2. 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

3. 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

1. 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)

2. O tempo de permanência é exibido no formato [hh h mm min ss s]

3. A data/hora de entrada mostra quando o veículo chegou ao ponto de interesse

4. Os veículos são ordenados por data/hora de entrada (do mais antigo para o mais recente)

Perguntas Frequentes

Gerais

1. 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.

2. 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

3. 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

4. Posso selecionar múltiplas divisões e categorias ao mesmo tempo?

   • Sim, os campos Categoria e Divisão permitem seleção múltipla.

5. 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".

6. 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

7. 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.

8. 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.

9. É 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.

10. 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.