Cor Localidade
Cores por Localidade
Introdução
O módulo "Cores por Localidade" é uma funcionalidade do sistema de gerenciamento de frota que permite associar cores específicas a diferentes localidades. Esta ferramenta é particularmente útil para visualização rápida em mapas e relatórios, possibilitando identificar instantaneamente a localidade de um veículo ou evento através de um código visual de cores.
Visão Geral
Este módulo consiste em duas telas principais:
- Tela de Pesquisa: Onde é possível visualizar todas as associações de localidades e cores existentes, além de filtrar, adicionar, editar e exportar registros.
- Tela de Edição: Onde é possível criar novas associações ou modificar associações existentes.
Tela de Pesquisa de Cores por Localidade
Descrição da Interface
A tela de pesquisa apresenta uma interface organizada e intuitiva para gerenciar as cores associadas a diferentes localidades. Na parte superior, há um cabeçalho com o título "Cores Localidade". Logo abaixo, encontra-se um painel de filtros retrátil que permite restringir os resultados exibidos. A parte principal da tela é ocupada por uma tabela que lista todas as localidades com suas respectivas cores.
Elementos da Interface
Painel de Filtros
- Campo "Nome da Localidade": Campo de texto livre para filtrar localidades pelo nome.
- Botão de Pesquisa: Ícone de lupa que executa a busca com os filtros aplicados.
- Botão de Limpar Filtros: Ícone de arquivo que reseta todos os filtros aplicados.
- Botão Novo: Ícone de adição que redireciona para a tela de criação de um novo registro.
- Botão Exportar para CSV: Ícone de salvamento que exporta os dados da tabela para um arquivo CSV.
Tabela de Resultados
- Coluna "NOME": Exibe o nome da localidade.
- Coluna "COR": Exibe a cor associada à localidade como um bloco colorido.
Paginação
- Indicador de Registros: Mostra a contagem de registros exibidos e o total.
- Controles de Paginação: Permite navegar entre as páginas de resultados.
Operações Principais
Como Filtrar Localidades
- Clique no campo "Nome da Localidade" no painel de filtros.
- Digite o nome ou parte do nome da localidade desejada.
- Clique no botão de pesquisa (ícone de lupa).
- A tabela atualizará mostrando apenas os registros que correspondem ao filtro aplicado.
Como Limpar Filtros
- Clique no botão de limpar filtros (ícone de arquivo).
- Todos os campos de filtro serão resetados para seus valores padrão.
- A tabela exibirá novamente todos os registros disponíveis.
Como Adicionar Nova Localidade
- Clique no botão de adicionar (ícone de adição).
- O sistema redirecionará para a tela de edição para criar um novo registro.
Como Editar Localidade Existente
- Localize o registro desejado na tabela.
- Clique em qualquer parte da linha do registro.
- O sistema redirecionará para a tela de edição com os dados do registro selecionado.
Como Exportar Dados para CSV
- Configure os filtros desejados para exibir apenas os registros de interesse (opcional).
- Clique no botão de exportar (ícone de salvamento).
- Um arquivo CSV chamado "CorLocalidade.csv" será gerado e baixado automaticamente.
- O arquivo conterá todos os registros exibidos na tabela, com os valores separados por ponto e vírgula (;).
Tela de Edição de Cores por Localidade
Descrição da Interface
A tela de edição permite criar novos registros ou modificar registros existentes de associação entre localidades e cores. Ela apresenta um formulário simples com campos para o nome da localidade e seleção da cor correspondente, além de botões para executar ações.
Elementos da Interface
Formulário de Edição
- Campo "Nome da Localidade": Campo de texto para inserir o nome da localidade.
- Seletor de Cores: Interface visual que permite selecionar uma cor específica do espectro de cores disponível.
- Botão "Gravar": Salva as alterações realizadas no formulário.
- Botão "Excluir": Remove o registro atual (visível apenas ao editar um registro existente).
- Botão "Voltar": Retorna à tela de pesquisa sem salvar alterações.
Validações do Formulário
- O campo "Nome da Localidade" é obrigatório e não pode estar em branco.
- Uma cor deve ser selecionada antes de salvar o registro.
- O sistema verifica se o usuário tem permissão para salvar ou excluir registros.
Operações Principais
Como Adicionar Nova Localidade e Cor
- Na tela de edição de um novo registro, digite o nome da localidade no campo "Nome da Localidade".
- Clique no seletor de cores para abrir a paleta.
- Selecione a cor desejada.
- Clique no botão "Gravar" para salvar o novo registro.
- O sistema retornará automaticamente para a tela de pesquisa após o salvamento.
Como Editar uma Localidade Existente
- Na tela de edição de um registro existente, modifique o nome da localidade conforme necessário.
- Clique no seletor de cores para alterar a cor associada, se desejado.
- Clique no botão "Gravar" para salvar as alterações.
- O sistema retornará automaticamente para a tela de pesquisa após o salvamento.
Como Excluir uma Localidade
- Na tela de edição de um registro existente, clique no botão "Excluir".
- Confirme a ação se solicitado.
- O registro será removido e o sistema retornará para a tela de pesquisa.
Como Retornar sem Salvar
- Clique no botão "Voltar" para retornar à tela de pesquisa sem salvar alterações.
Regras de Negócio
Permissões e Restrições
- Apenas usuários com permissão adequada podem gravar ou excluir registros.
- Usuários com capacidade de "master" têm acesso completo às operações de gravação e exclusão.
- Usuários em um grupo com permissão para alteração também podem gravar e excluir.
- Todos os usuários podem visualizar os registros, independentemente das permissões.
Persistência de Dados
- As cores são armazenadas tanto em formato hexadecimal (por exemplo, "#FF0000" para vermelho) quanto em formato numérico para compatibilidade com diversos componentes do sistema.
- Ao salvar, o sistema converte automaticamente o código hexadecimal para o valor numérico correspondente.
Consulta e Filtragem
- A pesquisa por nome de localidade é case-insensitive (não diferencia maiúsculas de minúsculas).
- Os resultados são exibidos em ordem alfabética crescente por nome de localidade.
Perguntas Frequentes
Por que associar cores a localidades?
As cores associadas às localidades são utilizadas em mapas, gráficos e relatórios do sistema para facilitar a identificação visual de veículos ou eventos por região geográfica. Isso proporciona uma maneira rápida e intuitiva de analisar a distribuição da frota.
Posso utilizar a mesma cor para diferentes localidades?
Sim, embora não seja recomendado para evitar confusão na identificação visual. O sistema não impõe restrições técnicas sobre a reutilização de cores, mas para melhor usabilidade, é aconselhável atribuir cores distintas a cada localidade.
Como as cores são exibidas em outros módulos do sistema?
As cores definidas neste módulo são utilizadas automaticamente em mapas interativos, relatórios gráficos e outras visualizações que apresentam dados organizados por localidade.
Quais formatos de cor são suportados?
O sistema trabalha com cores em formato hexadecimal (por exemplo, #FF0000 para vermelho). O seletor de cores permite escolher visualmente a cor desejada sem necessidade de conhecer os códigos hexadecimais.
Posso importar uma lista de localidades e cores?
Atualmente, o sistema não oferece uma funcionalidade direta para importação em massa. Cada associação de localidade e cor precisa ser criada individualmente através da interface.
O que acontece com as referências a uma localidade quando ela é excluída?
Quando uma localidade é excluída deste módulo, ela não será mais associada à cor correspondente em qualquer visualização do sistema. É importante verificar se a localidade não está sendo utilizada em outras partes do sistema antes de excluí-la.
Como posso ver todas as localidades cadastradas de uma vez?
Na tela de pesquisa, deixe o campo de filtro em branco e clique no botão de pesquisa. O sistema exibirá todas as associações de localidades e cores cadastradas, sujeitas à paginação se houver muitos registros.