Pontuação de Avisos

Visão Geral

A funcionalidade de Pontuação de Avisos é uma ferramenta essencial para gerenciamento de frota que permite configurar pontuações para diferentes tipos de eventos ou avisos gerados pelos veículos. Estas pontuações são utilizadas para medir o desempenho dos motoristas e a performance da frota, através da atribuição de valores numéricos (geralmente negativos) a determinados comportamentos ou eventos.

O sistema é composto por duas interfaces principais:

1. Uma tela de listagem que mostra todas as pontuações configuradas
2. Uma tela de edição para criar ou modificar as pontuações

As pontuações são organizadas por categorias (como Segurança, Performance, Agilidade) e tipos de avisos específicos (como Excesso de Velocidade, Freada Brusca, etc.). Para acessar a opção utilize o menu CONFIGURAÇÕES e a opção PONTUAÇÃO DE AVISOS.

Interface de Listagem (Pontuações Avisos)

Elementos da Interface

Cabeçalho

• Título: "Pontuações Avisos" - Identifica a funcionalidade da tela

Seção de Filtros

• Título do Painel: "Filtros" - Painel expansível/retrátil
• Campo "Tipo do Aviso": Dropdown que permite selecionar entre diversos tipos de avisos predefinidos
• Campo "Categoria do Aviso": Dropdown que permite selecionar entre as categorias disponíveis
• Botões de Ação:
  • Pesquisar (ícone de lupa): Executa a busca com os filtros selecionados
  • Limpar Filtros (ícone de arquivo): Restaura os filtros para seu estado inicial
  • Novo (ícone de adição): Redireciona para a tela de criação de nova pontuação
  • Exportar para CSV (ícone de salvar): Exporta os dados da tabela para um arquivo CSV

Tabela de Resultados

• Colunas:
  • CATEGORIA: Exibe a categoria do aviso (ex.: Segurança, Performance, Agilidade)
  • AVISO: Exibe o tipo de aviso específico
  • PONTUAÇÃO: Exibe o valor numérico da pontuação (geralmente negativo)
• Dados:
  • Cada linha representa uma configuração de pontuação para um tipo específico de aviso
  • Os valores de pontuação são mostrados com duas casas decimais

Paginação

• Indicador de Registros: Mostra a faixa de registros exibidos e o total disponível (ex.: "1 - 15 de 15")
• Controles de Paginação: Botões para navegar entre as páginas de resultados

Interface de Edição (Pontuação Aviso)

Elementos da Interface

Cabeçalho

• Título: "Pontuação Aviso" - Identifica a funcionalidade da tela

Formulário de Edição

• Campo "Categoria do Aviso": Dropdown que permite selecionar a categoria do aviso (obrigatório)
  • Valores possíveis: Segurança, Performance, Agilidade, etc.
• Campo "Tipo do Aviso": Dropdown que permite selecionar o tipo específico de aviso (obrigatório)
  • Valores possíveis: Excesso de Velocidade, Freada Brusca, RPM acima do limite, etc.
• Campo "Pontuação": Campo numérico para inserir o valor da pontuação (obrigatório)
  • Formato: Numérico com duas casas decimais
  • Valores típicos: Números negativos (ex.: -2,50, -10,01, -15,00)

Botões de Ação

• Gravar: Salva as alterações e retorna à tela de listagem
• Excluir: Remove a pontuação existente (visível apenas ao editar um registro existente)
• Voltar: Retorna à tela de listagem sem salvar alterações

Painel de Erros

• Exibe mensagens de validação quando o formulário contém erros

Operações Principais

Como Pesquisar Pontuações

1. Na tela de listagem, expanda o painel "Filtros" se ele estiver recolhido
2. Selecione um "Tipo do Aviso" no dropdown correspondente (opcional)
3. Selecione uma "Categoria do Aviso" no dropdown correspondente (opcional)
4. Clique no botão de pesquisa (ícone de lupa)
5. A tabela será atualizada mostrando apenas os registros que correspondem aos filtros aplicados

Como Criar uma Nova Pontuação

1. Na tela de listagem, clique no botão "Novo" (ícone de adição)
2. Na tela de edição, selecione a "Categoria do Aviso" no dropdown correspondente
3. Selecione o "Tipo do Aviso" no dropdown correspondente
4. Digite o valor da "Pontuação" (geralmente um número negativo)
5. Clique no botão "Gravar"
6. Se todas as informações estiverem corretas, o sistema salvará a nova pontuação e redirecionará para a tela de listagem
7. Se houver erros de validação, eles serão exibidos no painel de erros

Como Editar uma Pontuação Existente

1. Na tela de listagem, clique na linha da tabela correspondente à pontuação que deseja editar
2. Na tela de edição, modifique os campos conforme necessário:
   • "Categoria do Aviso"
   • "Tipo do Aviso"
   • "Pontuação"
3. Clique no botão "Gravar"
4. Se todas as informações estiverem corretas, o sistema salvará as alterações e redirecionará para a tela de listagem
5. Se houver erros de validação, eles serão exibidos no painel de erros

Como Excluir uma Pontuação

1. Na tela de listagem, clique na linha da tabela correspondente à pontuação que deseja excluir
2. Na tela de edição, clique no botão "Excluir"
3. O sistema removerá a pontuação e redirecionará para a tela de listagem

Como Exportar Dados para CSV

1. Na tela de listagem, aplique os filtros desejados (opcional)
2. Clique no botão "Exportar para CSV" (ícone de salvar)
3. O sistema gerará um arquivo CSV contendo os dados da tabela e iniciará o download

Regras de Negócio

1. Unicidade de Tipo de Aviso:

   • Não é permitido configurar mais de uma pontuação para o mesmo tipo de aviso
   • Se o usuário tentar criar uma pontuação para um tipo de aviso que já existe, o sistema exibirá uma mensagem de erro

2. Campos Obrigatórios:

   • Todos os campos (Categoria do Aviso, Tipo do Aviso e Pontuação) são obrigatórios
   • Se algum campo não for preenchido, o sistema exibirá mensagens de validação

3. Formato da Pontuação:

   • As pontuações são representadas com duas casas decimais
   • Geralmente são valores negativos, indicando penalidades

4. Permissões:

   • A capacidade de gravar (criar/editar) e excluir pontuações depende das permissões do usuário
   • Usuários com acesso "Master" têm permissão total
   • Usuários com acesso "Grupo" dependem de configurações adicionais

Perguntas Frequentes

O que são as pontuações de avisos?

As pontuações de avisos são valores atribuídos a eventos específicos detectados durante a operação dos veículos. Geralmente são valores negativos que representam penalidades por comportamentos indesejados, como excesso de velocidade ou freadas bruscas. Estas pontuações são utilizadas para avaliar o desempenho dos motoristas e a eficiência da frota.

Por que as pontuações são geralmente negativas?

As pontuações são concebidas como um sistema de penalidades, onde valores negativos representam deduções na avaliação de desempenho. Quanto mais negativa a pontuação, maior a penalidade associada ao evento.

Como as categorias de avisos são utilizadas?

As categorias de avisos (como Segurança, Performance, Agilidade) ajudam a organizar os diferentes tipos de eventos monitorados. Elas permitem agrupar eventos relacionados e facilitar a análise por área de interesse.

É possível ter mais de uma pontuação para o mesmo tipo de aviso?

Não, o sistema não permite configurar mais de uma pontuação para o mesmo tipo de aviso. Se você tentar criar uma nova pontuação para um tipo de aviso que já existe, o sistema exibirá uma mensagem de erro.

Como as pontuações afetam o sistema de gerenciamento de frota?

As pontuações são utilizadas pelo sistema para calcular métricas de desempenho dos motoristas e da frota. Elas podem influenciar relatórios, dashboards e até mesmo alertas automatizados quando determinados limites são atingidos.

Quem pode configurar as pontuações de avisos?

A capacidade de configurar pontuações depende das permissões do usuário no sistema. Usuários com acesso "Master" têm permissão total, enquanto usuários com acesso "Grupo" dependem de configurações adicionais.

É possível exportar as configurações de pontuação?

Sim, na tela de listagem existe um botão "Exportar para CSV" que permite exportar todas as configurações de pontuação para um arquivo CSV.

Por que algumas pontuações têm valores mais negativos que outras?

Os valores das pontuações refletem a gravidade dos eventos. Eventos mais críticos para a segurança ou eficiência operacional recebem pontuações mais negativas, indicando uma penalidade maior.