Pontos de Interesse - Categorias de Pontos de Interesse

Visão Geral

O módulo de Categorias de Pontos de Interesse permite gerenciar diferentes tipos de locais que são relevantes para o sistema de gerenciamento de frota "CONCEPT RASTREAMENTO". Esta funcionalidade é essencial para organizar, categorizar e visualizar pontos específicos que têm importância para a operação logística da empresa. Para acessar clique no menu FROTAS, na seção PONTOS DE INTERESSE clique na opção CATEGORIAS DE PONTO DE INTERESSE.

Elementos da Interface

Tela de Listagem (Grupos Ponto de Interesse)

Seção de Filtros

• Nome: Campo de texto para filtrar registros pelo nome da categoria
• Botões de Ação:
  • Pesquisa: Inicia a busca com os filtros aplicados
  • Limpar Filtros: Restaura os valores padrão nos filtros
  • Novo: Redireciona para a tela de cadastro de nova categoria
  • Exportar para CSV: Gera um arquivo CSV com os dados da listagem atual

Tabela de Resultados

• Colunas:
  • #: Numeração sequencial
  • Nome: Nome da categoria de ponto de interesse
  • Descrição: Detalhamento sobre a finalidade da categoria
• Registros: Linhas com dados das categorias cadastradas
• Contador: Exibe o total de registros encontrados

Tela de Edição (Categoria Ponto de Interesse)

Seção de Erros

• Área para exibição de mensagens de validação e erros do formulário

Formulário

• Nome: Campo obrigatório de texto para o nome da categoria
• Descrição: Campo de texto para detalhes adicionais
• Ícone: Seletor obrigatório de ícone visual para representar a categoria
• Cor: Seletor de cor em formato hexadecimal para personalizar a exibição visual da categoria

Botões de Ação

• Gravar: Salva as alterações realizadas
• Excluir: Remove a categoria (visível apenas em modo de edição)
• Voltar: Retorna para a tela de listagem sem salvar alterações

Fluxo de Trabalho

O gerenciamento de categorias de pontos de interesse segue um fluxo simples:

1. Visualização: Na tela de listagem, o usuário pode ver todas as categorias cadastradas
2. Filtragem: Aplicar filtros para encontrar categorias específicas
3. Criação: Iniciar o cadastro de novas categorias
4. Edição: Modificar as informações de categorias existentes
5. Exclusão: Remover categorias que não são mais necessárias

Regras de Negócio

• Cada categoria deve possuir um nome único e obrigatório
• O ícone é obrigatório para identificação visual da categoria
• A cor padrão para novas categorias é vermelho (#FF0000)
• Apenas usuários com permissão adequada podem criar, editar ou excluir categorias
• Existe validação de acesso baseada em:
  • Usuários com acesso Master têm permissão completa
  • Usuários de Grupo precisam ter capacidade Master ou permissão específica de alteração

Instruções Passo a Passo

Como pesquisar categorias

1. Acesse a tela de listagem "Grupos Ponto de Interesse"
2. Digite o termo desejado no campo "Nome"
3. Clique no botão de pesquisa (ícone de lupa)
4. Visualize os resultados na tabela abaixo

Como criar uma nova categoria

1. Na tela de listagem, clique no botão "Novo" (ícone de mais)
2. Preencha o campo obrigatório "Nome"
3. Opcionalmente, adicione uma "Descrição"
4. Selecione um ícone no campo "Ícone" (obrigatório)
5. Escolha uma cor clicando no seletor de cores
6. Clique no botão "Gravar"

Como editar uma categoria existente

1. Na tela de listagem, clique em qualquer linha da tabela para selecionar uma categoria
2. Modifique os campos desejados
3. Clique no botão "Gravar" para salvar as alterações

Como excluir uma categoria

1. Na tela de listagem, selecione a categoria a ser excluída
2. Na tela de edição, clique no botão "Excluir"
3. Confirme a exclusão quando solicitado

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. Selecione o local para salvar o arquivo "GrupoPontoInteresse.csv"

Permissões e Acessos

O sistema possui três níveis de acesso que afetam as permissões neste módulo:

1. Acesso Master: Permissão total para criar, editar e excluir categorias
2. Acesso Grupo: Permissões baseadas em:
   • Flag de capacidade Master
   • Flag específica de permissão para alteração
3. Acesso Individual: Permissões limitadas

Processamento de Dados

• Os dados são enviados via servidor REST
• O formato de saída é JSON
• Existe verificação de autenticação (redirecionamento para login em caso de sessão expirada)
• As operações disponíveis incluem:
  • FindAll: Para listar registros
  • Insert: Para criar novos registros
  • Update: Para modificar registros existentes
  • Delete: Para remover registros

Perguntas Frequentes

Posso ter duas categorias com o mesmo nome?

Não, cada categoria deve ter um nome único para evitar confusão e manter a organização do sistema.

Como altero a cor de uma categoria?

Na tela de edição, clique no seletor de cores ao lado do campo "Ícone" e escolha a cor desejada. A cor será atualizada quando você clicar em "Gravar".

Posso criar uma categoria sem ícone?

Não, o ícone é obrigatório para melhor identificação visual nas interfaces que utilizam estas categorias.

É possível filtrar as categorias por descrição?

Atualmente, o sistema permite apenas a filtragem pelo nome da categoria.

Como faço para ver todos os pontos de interesse associados a uma categoria?

Esta funcionalidade está disponível em outro módulo do sistema. Na tela atual, gerenciamos apenas as categorias, não os pontos específicos.

O que acontece com os pontos de interesse quando excluo uma categoria?

Recomenda-se verificar se existem pontos associados antes de excluir uma categoria, pois isso pode afetar a visualização e categorização desses pontos.

É possível transferir pontos de uma categoria para outra?

Essa operação deve ser realizada no módulo de gestão de pontos de interesse, não na gestão de categorias.

Quem pode visualizar as categorias que eu criar?

As categorias são visíveis para todos os usuários que têm acesso ao sistema, mas apenas usuários com permissões adequadas podem modificá-las ou excluí-las.