~~ODT~~

<PHP>
echo "<div style='display:block;float:right;'>"; 
echo "Última atualização: ";
ver('', false);
echo "</div>";
</PHP>



====== Cadastrar Reserva de Veículo ======

Este caso de uso é utilizado pelos gestores de transportes reserva deslocamento para cadastrar uma reserva para um veículo. 
Com uma reserva, é possível informar o uso de um veículo com antecedência, evitando conflitos de horários com
outras pessoas que pretendem utilizar o mesmo veículo. 

===== Descrição do Caso de Uso =====

Este caso de uso inicia quando o usuário acessa a opção:: SIPAC -> Módulo Transportes -> Aba Deslocamento-> Requisições de Veículo -> Cadastrar 

O caso de uso começa com o usuário acessando o sistema e preenchendo os dados do cadastro como segue abaixo:
  * **Tipo de Reserva**: O Tipo de reserva a ser cadastrada. Tipo TEXTO.
  * **Beneficiado**: Tipo AUTOCOMPLETE, formato: NOME BENEFICIADO - CPF ou CNPJ, entrada de dados: NOME. Pessoa a ser beneficiada pela reserva. 
  * **Data/Hora Inicial**: Data e hora em se inicia a reserva do veículo. Formato: DD/MM/AAAA - HH:MM, Tipo: TEXTO  ([[#principais regras de negócio|RN01]]).
  * **Data/Hora Final**: Data e hora em que se encerra a reserva do veículo. Formato: DD/MM/AAAA - HH:MM, Tipo: TEXTO ([[#principais regras de negócio|RN02]]).
  * **Destino**: Destino do veículo. Formato: DESCRIÇÃO, Tipo: TEXTO.
  * **Finalidade**: Informação complementar sobre o abastecimento. Formato: DESCRIÇÃO, Tipo: TEXTO.
  * **Motorista**: Tipo AUTOCOMPLETE, formato: NOME MOTORISTA - CPF, entrada de dados: NOME. 

Ao adicionar um motorista, ele é incluído numa listagem com o campo:

  ***__Motorista__**: Tipo TEXTO, formato: NOME MOTORISTA - CPF.

Lembrando que, para cada registro, o sistema exibe a opção de removê-lo após uma confirmação.

O sistema exibe os dados do veículo reservado ([[#principais regras de negócio|RN03]]):

   * **__Foto do Veículo__**: A imagem do veículo a ser escolhido. Tipo - IMAGEM.
   * **__Marca/Modelo__**: Marca/Modelo/Ano do veículo, bem como sua placa. Tipo - TEXTO.
   * **__Denominação__**: A denominação dada ao veículo em seu cadastro no sistema. Tipo - TEXTO.
   * **__Cor__**: A cor predominante do veículo. Tipo - TEXTO.
   * **__Unidade__**: A qual pertence o veículo. Tipo - TEXTO.
   * **__Tipo de Uso__**: Qual a principal utilidade do veículo. Tipo - TEXTO.
   * **__Categoria__**: Qual a categoria a que pertence o veículo. Tipo - TEXTO.

Deve-se se conter também um formulário para realizar busca dos veículos disponíveis que o usuário está autorizado a selecionar ([[#principais regras de negócio|RN04]]), a busca pode ser filtrada pelos seguintes campos:

  * **Período**: Período em que o carro se encontra disponível.  Tipo DATA, Formato: DD/MM/AAAA a DD/MM/AAAA.([[#principais regras de negócio|RN05]])
  * **Tipo de uso do veículo**: O Tipo de uso do veículo . Formato: DENOMINAÇÃO DO TIPO DE USO, Tipo: TEXTO.

Será apresentado ao usuário a lista de veículos disponíveis para reserva, com os dados:

  ***__Foto__**: Tipo IMAGEM.
  ***__Modelo__**: Tipo TEXTO, formato: DENOMINAÇÃO MODELO - PLACA: NÚMERO PLACA.
  ***__Denominação__**: Tipo TEXTO.
  ***__Status__**: Tipo TEXTO.
  ***__Cor__**: Tipo TEXTO.
  ***__Unidade__**: Tipo TEXTO, formato: DENOMINAÇÃO UNIDADE (CÓDIGO).
  ***__Tipo de Uso do Veículo__**: Tipo TEXTO.
  ***__Proprietário__**: Tipo TEXTO, formato: NOME ou RAZÃO SOCIAL (CPF ou CNPJ).
  ***__Categoria__**: Tipo TEXTO.

Após a seleção do veículo e posterior cadastro, o caso de uso é, então, finalizado.

===== Principais Regras de Negócio =====

  * **RN01** - <del>O horário de início e término deve ser múltiplo de 30 minutos, para facilitar o controle de reservas.</del>
   * **RN02** - O preenchimento dos atributos data/hora inicial e data/hora final é obrigatório.
   * **RN03** - Ao efetuar uma busca dos veículos disponíveis deve-se utilizar como padrão o período entre data/hora inicial e data/hora final.
   * **RN04** - <del>A lista de veículos deve aparecer veículos sem reserva no período informado.</del>
   * **RN05** - Ao persistir deve-se garantir que o veículo selecionado também não foi escolhido no momento da gravação.
   * **RN06** - Caso o usuário não seja gestor global, só poderão ser visualizadas as reservas restritas a sua unidade.
   * **RN07** - Quando o parâmetro é false, a opção "Para um Abastecimento" não é exibida.
==== Resoluções/Legislações Associadas ====

Não se aplica.

===== Classes Persistentes e Tabelas Envolvidas =====

^ Classe ^ Tabela |
| br.ufrn.sipac.transportes.dominio.ReservaVeiculo| administrativo.transporte.reserva_veiculo |

====== Plano de Teste ======

Sistema: SIPAC

Módulo: TRANSPORTES

Link(s): SIPAC → Módulo Transportes → Aba Deslocamento→ Requisições de Veículo → Cadastrar

Usuários: bergue

Papel que usuário deve ter: 

  * SipacPapeis.GESTOR_TRANSPORTES_UNIDADES,
  * SipacPapeis.GESTOR_TRANSPORTES_GLOBAL, 
  * SipacPapeis.GESTOR_TRANSPORTES_RESERVA_DESLOCAMENTO.

===== Cenários de Teste =====

Para verificar se os dados foram cadastrados/alterados corretamente, pode-se verificar a listagem exibida em SIPAC -> Módulo Transportes -> Deslocamento-> Operações -> Reserva -> Cadastrar.


===== Dados para o Teste =====

Não se aplica!