Equipamentos de Viagens

Equipamentos de Viagem

Visão Geral

O sistema de Gestão de Equipamentos de Viagem é um módulo dentro da plataforma CONCEPT RASTREAMENTO, dedicado ao gerenciamento de equipamentos utilizados em viagens. Este sistema permite cadastrar, listar, editar e excluir equipamentos, como veículos, associando-os a tipos específicos e números de placa.

Interface do Sistema

O sistema possui duas telas principais:

1. Tela de Listagem (Equipamentos de Viagens) - Interface para pesquisa e visualização dos equipamentos cadastrados
2. Tela de Edição/Cadastro (Equipamento de Viagem) - Interface para inserção de novos equipamentos ou edição dos existentes

Tela de Listagem (Equipamentos de Viagens)

Elementos da Interface

• Título da Página: "Equipamentos de Viagens" (no topo da tela)

• Seção de Filtros: Um card expansível que contém os filtros de pesquisa

  • Campo "Tipo": Campo de texto livre para filtrar por tipo de equipamento
  • Campo "Placa": Campo de texto com máscara para formato de placa de veículo
  • Botões de ação:
    • Pesquisar (ícone de lupa): Realiza a busca com os filtros definidos
    • Limpar Filtros (ícone de arquivo): Remove todos os filtros inseridos
    • Novo (ícone de mais): Cria um novo registro
    • Exportar para CSV (ícone de salvar): Exporta os dados mostrados para um arquivo CSV

• Tabela de Resultados: Exibe os equipamentos encontrados com as colunas:

  • # (Número sequencial)
  • TIPO: Identifica o tipo de equipamento/veículo
  • PLACA: Mostra o número da placa do equipamento
  • STATUS: Indica se o equipamento está "ATIVO" ou "INATIVO"

• Contador de Registros: Mostra o total de registros encontrados

Fluxo de Trabalho

1. O usuário pode inserir critérios de filtro nos campos disponíveis
2. Ao clicar no botão de pesquisa, o sistema exibe os equipamentos que atendem aos critérios
3. O usuário pode selecionar um registro da tabela para edição
4. Alternativamente, pode criar um novo registro clicando no botão de adição
5. Os resultados podem ser exportados para um arquivo CSV

Tela de Edição/Cadastro (Equipamento de Viagem)

Elementos da Interface

• Título da Página: "Equipamento de Viagem" (no topo da tela)
• Formulário de Edição:
  • Campo "Tipo": Campo de texto obrigatório que descreve a categoria do equipamento
  • Campo "Placa": Campo de texto obrigatório com máscara específica para placas (formato AAA-#X##)
  • Checkbox "Ativo": Indica se o equipamento está ativo (disponível apenas para edição de registros existentes)
• Botões de Ação:
  • Gravar: Salva as informações inseridas (verde)
  • Excluir: Remove o registro do sistema (vermelho, visível apenas para equipamentos já cadastrados)
  • Voltar: Retorna à tela de listagem sem fazer alterações

Fluxo de Trabalho

1. Ao criar um novo equipamento, o usuário insere os dados nos campos obrigatórios
2. Ao editar um equipamento existente, os campos aparecem preenchidos com os dados atuais
3. Após fazer as alterações desejadas, o usuário clica em "Gravar" para salvar
4. Caso deseje excluir o registro, pode clicar em "Excluir" (apenas para equipamentos existentes)
5. Se quiser cancelar a operação, basta clicar em "Voltar" para retornar à listagem

Validações do Sistema

• Campo Tipo:

  • Obrigatório
  • Não possui restrição de formato

• Campo Placa:

  • Obrigatório
  • Deve seguir o formato específico (AAA-#X##, onde A=letra, X=letra, #=número)
  • Deve ser único no sistema (não pode haver dois equipamentos com a mesma placa)

• Status:

  • Por padrão, novos equipamentos são cadastrados como "Ativo"
  • Pode ser alterado apenas em modo de edição

Instruções Passo a Passo

Como Pesquisar Equipamentos

1. Acesse a tela "Equipamentos de Viagens"
2. Na seção de filtros, preencha os campos desejados:
   • Tipo: Digite parte ou todo o tipo do equipamento
   • Placa: Digite parte ou toda a placa do equipamento
3. Clique no botão de pesquisa (ícone de lupa)
4. Os resultados serão exibidos na tabela abaixo dos filtros
5. Para limpar os filtros, clique no botão com ícone de arquivo

Como Cadastrar um Novo Equipamento

1. Na tela de listagem, clique no botão de adição (ícone de mais)
2. Na tela de cadastro, preencha os campos obrigatórios:
   • Tipo: Insira o tipo do equipamento (ex: "BI-TREM", "TRUCADO")
   • Placa: Insira a placa no formato correto (ex: "FHF-6822")
3. Clique no botão "Gravar" para salvar
4. Se a placa já existir no sistema, será exibida uma mensagem de erro
5. Caso contrário, o sistema retornará à tela de listagem com o novo equipamento cadastrado

Como Editar um Equipamento Existente

1. Na tela de listagem, clique no registro que deseja editar
2. Na tela de edição, altere os campos desejados
3. O campo "Ativo" pode ser desmarcado para inativar o equipamento
4. Clique em "Gravar" para salvar as alterações
5. O sistema retornará à tela de listagem

Como Excluir um Equipamento

1. Na tela de listagem, clique no registro que deseja excluir
2. Na tela de edição, clique no botão "Excluir"
3. Confirme a exclusão quando solicitado
4. O sistema removerá o registro e retornará à tela de listagem

Como Exportar Dados para CSV

1. Na tela de listagem, realize uma pesquisa para filtrar os dados desejados
2. Clique no botão de exportação (ícone de salvar)
3. O sistema gerará um arquivo CSV chamado "EquipamentosViagens.csv" com os dados da tabela
4. O arquivo será baixado automaticamente pelo navegador

Regras de Negócio

1. Unicidade de Placa: O sistema não permite o cadastro de dois equipamentos com a mesma placa
2. Validação de Campos Obrigatórios: Os campos Tipo e Placa são sempre obrigatórios
3. Formato de Placa: A placa deve seguir o formato específico configurado no sistema
4. Status do Equipamento: Um equipamento pode estar Ativo ou Inativo, mas novos equipamentos são sempre cadastrados como Ativos inicialmente
5. Verificação de Duplicidade: Ao tentar gravar um equipamento com uma placa já existente, o sistema verifica se o ID do registro é diferente. Se for, significa que é outro equipamento tentando usar a mesma placa, e uma mensagem de erro é apresentada

Perguntas Frequentes

É possível cadastrar dois equipamentos com a mesma placa?

Não, o sistema não permite a duplicidade de placas. Cada equipamento deve ter uma placa única.

Como faço para inativar temporariamente um equipamento?

Na tela de edição do equipamento, desmarque a opção "Ativo" e clique em "Gravar". O equipamento permanecerá no sistema, mas com status "INATIVO".

Qual formato de placa é aceito pelo sistema?

O sistema aceita placas no formato AAA-#X##, onde AAA são letras, # são números e X é uma letra (exemplo: FHF-6822).

Posso reativar um equipamento inativado?

Sim, basta editar o equipamento, marcar a opção "Ativo" novamente e clicar em "Gravar".

Como exporto apenas alguns equipamentos específicos para CSV?

Aplique os filtros desejados na tela de listagem para exibir apenas os equipamentos que você quer exportar, e então clique no botão de exportação para CSV.

Posso editar a placa de um equipamento já cadastrado?

Sim, você pode editar a placa de um equipamento, mas se a nova placa já estiver associada a outro equipamento, o sistema não permitirá a alteração.

Os registros excluídos podem ser recuperados?

Não, uma vez excluído um registro, ele não pode ser recuperado através da interface. A operação de exclusão é permanente.

Como filtrar apenas por equipamentos ativos ou inativos?

Atualmente, o sistema não possui um filtro específico para status. É necessário pesquisar todos os equipamentos e identificar visualmente pela coluna STATUS.