# Controles de Frota - Veículos Externos

## Visão Geral da Interface

A funcionalidade apresentada faz parte do sistema de gerenciamento de frota da plataforma CONCEPT RASTREAMENTO, especificamente a funcionalidade de "Veículos Externos". O sistema permite o registro e gerenciamento de veículos que podem ser utilizados em dois contextos principais: "Portaria" ou "Geral".

O sistema possui um design moderno com uma barra lateral de navegação escura à esquerda, e o conteúdo principal exibido na área central branca. A interface segue um padrão consistente com campos de formulário bem organizados, botões de ação claramente identificados, e uma tabela para a visualização dos registros. Para acessar a opção utilize o menu FROTAS e a seção CONTROLE DE FROTA e opção VEÍCULOS EXTERNOS.

## Elementos da Interface e suas Funções

### Tela de Listagem de Veículos Externos

1. **Filtros de Pesquisa**:
    
    
    - **Tipo**: Seletor com opções "Portaria" e "Geral" (determina o contexto de uso do veículo)
    - **Marca**: Campo de texto para filtrar por marca do veículo
    - **Modelo**: Campo de texto para filtrar por modelo do veículo
    - **Placa**: Campo de texto para filtrar por placa do veículo
    - **Nome Motorista**: Campo de texto para filtrar por nome do motorista
    - **Só ativos?**: Caixa de seleção para filtrar apenas veículos ativos
2. **Botões de Ação**:
    
    
    - **Pesquisa**: Botão com ícone de lupa para executar a pesquisa com os filtros aplicados
    - **Limpar Filtros**: Botão para resetar todos os campos de filtro
    - **Novo**: Botão com ícone de adição para cadastrar um novo veículo
    - **Exportar para CSV**: Botão para exportar a lista atual para arquivo CSV
3. **Tabela de Resultados**:
    
    
    - **Colunas**: Numeração (#), Marca, Modelo, Placa, Cor, Motorista, Status (Ativo/Inativo), Usuário, Cadastro
    - A tabela permite seleção de linha única
    - Clicar em uma linha direciona o usuário para a tela de edição

### Tela de Cadastro/Edição de Veículo Externo

1. **Campos do Formulário**:
    
    
    - **Usar Em**: Seletor com opções "Portaria" ou "Geral"
    - **Tipo Veículo**: Seletor de tipo de veículo (visível apenas quando "Usar Em" = "Geral")
    - **Marca**: Seletor com lista de marcas de veículos
    - **Modelo**: Seletor com lista de modelos de veículos
    - **Modelo Outro**: Campo de texto que aparece quando "Outro" é selecionado no campo Modelo
    - **Cor**: Campo de texto para a cor do veículo
    - **Placa**: Campo de texto com máscara para placa de veículo (formato AAA-9X99)
    - **Nome Motorista**: 
        - Campo de texto simples (quando "Usar Em" = "Portaria")
        - Seletor de motoristas cadastrados (quando "Usar Em" = "Geral")
    - **Ativo**: Caixa de seleção para definir se o veículo está ativo
    - **Data/Hora Cadastro**: Campo informativo, exibido apenas em modo de edição
2. **Mensagens e Alertas**:
    
    
    - Alerta de cobrança mensal para veículos do tipo "Geral" (R$ 25,00/mês)
    - Aviso de que alterações em veículos "Geral" já cadastrados devem ser feitas através de outra funcionalidade
    - Painel de erros de validação quando campos obrigatórios não são preenchidos
3. **Botões de Ação**:
    
    
    - **Gravar**: Salva as informações do veículo
    - **Inativar/Ativar**: Alterna o status de ativação do veículo (visível apenas para veículos existentes)
    - **Excluir**: Remove o veículo do sistema
    - **Voltar**: Retorna para a tela de listagem

## Fluxo de Trabalho e Propósito

O sistema tem como propósito gerenciar dois tipos de veículos externos:

1. **Veículos de Portaria**: Veículos simples registrados para controle de entrada/saída, sem funcionalidades avançadas.
2. **Veículos Gerais**: Veículos que terão acesso a todas as funcionalidades da plataforma mediante pagamento de mensalidade (R$ 25,00/mês).

### Fluxo de Trabalho Principal:

1. O usuário acessa a tela de listagem de veículos externos
2. Aplica filtros para encontrar veículos específicos ou visualiza todos os registros
3. Para adicionar um novo veículo, clica no botão "Novo"
4. Preenche o formulário com os dados do veículo
5. Confirma a operação clicando em "Gravar"
6. Para editar ou excluir um veículo existente, seleciona o registro na tabela e é direcionado para a tela de edição

## Instruções Passo a Passo

### Como Adicionar um Novo Veículo Externo:

1. Na tela de listagem, clique no botão "Novo" (ícone +)
2. Selecione o tipo de uso no campo "USAR EM" (Portaria ou Geral)
3. Se selecionou "Geral", escolha o tipo de veículo no campo correspondente
4. Selecione a marca do veículo
5. Selecione o modelo do veículo
6. Se o modelo não estiver na lista, selecione "Outro" e preencha o campo adicional
7. Digite a cor do veículo
8. Digite a placa do veículo no formato correto (AAA-9X99)
9. Para veículos de portaria: digite o nome do motorista Para veículos gerais: selecione o motorista na lista
10. Mantenha a caixa "Ativo" marcada se o veículo estiver em uso
11. Clique em "Gravar" para salvar o registro
12. Se for um veículo do tipo "Geral", confirme a autorização da cobrança mensal

### Como Pesquisar Veículos:

1. Na tela de listagem, preencha os campos de filtro conforme necessário
2. Para filtrar por tipo de veículo, selecione a opção desejada (Portaria/Geral)
3. Para filtrar por marca, modelo, placa ou motorista, digite os termos de busca
4. Para ver apenas veículos ativos, mantenha a caixa "Só ativos?" marcada
5. Clique no botão de pesquisa (ícone de lupa)
6. Para limpar todos os filtros, clique no botão "Limpar Filtros"

### Como Editar um Veículo Existente:

1. Na tela de listagem, localize o veículo desejado
2. Clique na linha correspondente para abrir a tela de edição
3. Para veículos de portaria: modifique os campos conforme necessário
4. Para veículos gerais: note que alterações devem ser feitas através da funcionalidade "CONFIGURAÇÃO -> ALTERAÇÃO VEÍCULOS"
5. Para alterar o status de ativação, use o botão "INATIVAR" ou "ATIVAR"
6. Clique em "Gravar" para salvar as alterações

### Como Excluir um Veículo:

1. Na tela de listagem, localize o veículo desejado
2. Clique na linha correspondente para abrir a tela de edição
3. Clique no botão "Excluir"
4. Confirme a operação quando solicitado

### Como Exportar a Lista de Veículos para CSV:

1. Na tela de listagem, aplique os filtros desejados
2. Clique no botão "Exportar para CSV" (ícone de salvar)
3. O arquivo será automaticamente baixado para o seu computador

## Regras de Negócio

1. **Validação de Campos Obrigatórios**:
    
    
    - Marca, Modelo, Cor, Placa e Nome do Motorista são campos obrigatórios
    - Para veículos do tipo "Geral", o Tipo de Veículo também é obrigatório
2. **Verificação de Duplicidade**:
    
    
    - O sistema verifica se já existe um veículo com a mesma placa cadastrado
    - Não é permitido cadastrar dois veículos com a mesma placa
3. **Controle de Acesso**:
    
    
    - Apenas usuários com perfil "Master" podem ativar/inativar ou cadastrar veículos do tipo "Geral"
    - Usuários com acesso de grupo podem modificar veículos se tiverem a permissão "grupoPodeSeAlterar"
4. **Cobrança para Veículos Gerais**:
    
    
    - Veículos do tipo "Geral" estão sujeitos a uma mensalidade de R$ 25,00
    - O usuário deve confirmar a autorização dessa cobrança ao cadastrar um novo veículo
5. **Regras de Edição**:
    
    
    - Veículos do tipo "Geral" já cadastrados não podem ser editados diretamente nesta tela
    - Alterações devem ser feitas através da funcionalidade "CONFIGURAÇÃO -> ALTERAÇÃO VEÍCULOS"
6. **Regras de Exclusão**:
    
    
    - A exclusão de veículos do tipo "Geral" requer permissão de acesso "Master"

## Perguntas Frequentes

### Qual a diferença entre veículos de "Portaria" e "Geral"?

Veículos de "Portaria" são utilizados apenas para controle de entrada e saída, enquanto veículos "Gerais" têm acesso a todas as funcionalidades da plataforma de rastreamento mediante pagamento de mensalidade.

### Por que não consigo editar um veículo do tipo "Geral"?

Veículos do tipo "Geral" já cadastrados devem ser editados através da funcionalidade "CONFIGURAÇÃO -> ALTERAÇÃO VEÍCULOS" para garantir a consistência dos dados no sistema de rastreamento.

### Como faço para inativar temporariamente um veículo?

Na tela de edição do veículo, clique no botão "INATIVAR". O veículo permanecerá no sistema, mas não aparecerá nas pesquisas que têm o filtro "Só ativos?" marcado.

### É possível cadastrar dois veículos com a mesma placa?

Não. O sistema verifica a existência de veículos com a mesma placa e impede o cadastro duplicado.

### Posso exportar apenas os veículos ativos para um relatório?

Sim. Aplique o filtro "Só ativos?" e depois clique no botão "Exportar para CSV".

### Como cadastrar um motorista que não está na lista?

Os motoristas devem ser cadastrados previamente no módulo de Motoristas. Após o cadastro, eles aparecerão na lista de seleção.

### Qual o formato correto para placas de veículos no sistema?

O sistema aceita placas no formato AAA-9X99 (três letras, seguidas de um número, uma letra e dois números).

### A cobrança da mensalidade para veículos "Gerais" é automática?

Sim. Ao cadastrar um veículo do tipo "Geral", você autoriza a cobrança mensal de R$ 25,00, que será processada automaticamente pelo sistema.

### Por que aparece um alerta de erro quando tento gravar um veículo?

O sistema exige que todos os campos obrigatórios sejam preenchidos. Verifique se todos os campos marcados com erro foram preenchidos corretamente.

### Quem tem permissão para cadastrar veículos do tipo "Geral"?

Apenas usuários com perfil "Master" ou usuários com acesso de grupo que possuam a capacidade "Master" podem cadastrar veículos do tipo "Geral".