~~ODT~~

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



====== Cadastrar Requisição de Veículo/Transporte ======

Este caso de uso é utilizado pelos requisitores de reserva de veículos e pelos gestores de transportes globais com a finalidade de realizarem requisições e agendamento de utilização de algum veículo da instituição. 
===== Descrição do Caso de Uso =====

Este caso de uso inicia quando o usuário acessa a opção: //SIPAC -> Portal Administrativo -> Requisições -> Veículo/Transporte -> Cadastrar Requisição//.

Inicialmente, o usuário deverá escolher o tipo de reserva que deseja realizar (Veículo para um período, Veículo para uma saída, Solicitação de Abastecimento de Veículo da Unidade e Solicitação de Abastecimento de Gerador ([[#principais_regras_de_negócio|RN08]])).

Caso a reserva seja para um período, deverá ser preenchido um formulário no seguinte formato:

  * **Beneficiado***: Tipo - AUTOCOMPLETE. Formato - NOME DO SERVIDOR - CPF.
  * **Unidade Requisitante**: Tipo - TEXTO. ([[#principais_regras_de_negócio|RN01]]).
  * **Data/Hora Inicial***: Tipo - DATA. Formato - DD/MM/AAAA HH:MM.
  * **Data/Hora Final***: Tipo - DATA. Formato - DD/MM/AAAA HH:MM.
  * **Unidade Requisitada***: Tipo - TEXTO. ([[#principais_regras_de_negócio|RN05]])
  * **Origem***: Tipo - TEXTO.
  * **Destino***: Tipo - TEXTO. 
    * **Adicionar**: Botão para adicionar mais uma linha de destino.
  * **Finalidade***: Tipo - TEXTO.
  * **Recorrência**: DIÁRIA, SEMANAL ou MENSAL. 
    * **Data Final Recorrência***: Período em que a requisição irá se repetir.  ([[#principais_regras_de_negócio|RN15 e RN16]])
  * **Telefone para Contato***: Tipo - TEXTO. Campo para digitação de um ou mais números de telefone.
  * **Quantidade de pessoas a serem transportadas**: Tipo - NUMÉRICO.
  * **Quantidade de carga que será transportada**: Tipo - NUMÉRICO.
  * **Observação**: Tipo - TEXTO.
  * **Anexar Arquivo**: Campo para anexar qualquer tipo de arquivo.

<del>No caso da reserva para uma saída, o formulário terá o seguinte formato:

  * **Beneficiado***: Tipo - AUTOCOMPLETE. Formato - NOME DO SERVIDOR - CPF.
  * **Unidade Requisitante**: Tipo - TEXTO. ([[#principais_regras_de_negócio|RN01]]).
  * **Data/Hora***: Tipo - DATA. Formato - DD/MM/AAAA HH:MM. ([[#principais_regras_de_negócio|RN02]])
  * **Unidade Requisitada***: Tipo - TEXTO. 
  * **Destino***: Tipo - TEXTO.
  * **Finalidade***: Tipo - TEXTO.
  * **Telefone para Contato***: Tipo - TEXTO. Campo para digitação de um ou mais números de telefone.
  * **Quantidade de pessoas a serem transportadas**: Tipo - NUMÉRICO.
  * **Quantidade de carga que será transportada**: Tipo - NUMÉRICO.
  * **Observação**: Tipo - TEXTO.
  * **Anexar Arquivo**: Campo para anexar qualquer tipo de arquivo.</del>

Na solicitação de abastecimento de veículo da unidade, deverá ser preenchido o seguinte formulário: ([[#principais_regras_de_negócio|RN14]])

  * **Unidade Requisitante**: Tipo - TEXTO. ([[#principais_regras_de_negócio|RN01]]).
  * **Data/Hora***: Tipo - DATA. Formato - DD/MM/AAAA HH:MM. ([[#principais_regras_de_negócio|RN03]])
  * **Motorista***: Tipo - AUTOCOMPLETE. Formato - NOME (CPF). Entrada de dados: Nome.
  * **Veículo Para Abastecimento***: Tipo - AUTOCOMPLETE. Formato - MODELO - PLACA - UNIDADE DO VEÍCULO. ([[#principais_regras_de_negócio|RN04]])
  * **Quantidade de Litros**: Tipo - NUMÉRICO.
  * **Observação**: Tipo - TEXTO.
  * **Anexar Arquivo**: Campo para anexar qualquer tipo de arquivo.

Na solicitação de abastecimento do gerador da unidade, deverá ser preenchido o seguinte formulário ([[#principais_regras_de_negócio|RN08]]): 

  * **Unidade Requisitante**: Tipo - AUTOCOMPLETE. Formato - NOME DA UNIDADE. ([[#principais_regras_de_negócio|RN09]]): 
  * **Data da Falta de Energia:***: Tipo - DATA. Hora: Formato - DD/MM/AAAA HH:MM. 
  * **Gerador Para Abastecimento***: Tipo - AUTOCOMPLETE. Formato - MODELO - PLACA - UNIDADE DO VEÍCULO. 
  * **Quantidade de Litros**: Tipo - NUMÉRICO.
  * **Observação**: Tipo - TEXTO.
  * **Anexar Arquivo**: Campo para anexar qualquer tipo de arquivo.

É disponibilizado a opção de imprimir o comprovante da requisição, com as seguintes informações (no caso de requisição de troca de pneu, apenas as informações solicitadas no cadastro): 

**INFORMAÇÕES GERAIS DA REQUISIÇÃO**
  * **__Número__**: Tipo NUMÉRICO. Formato: 9.../AAAA.
  * **__Status__**: Tipo TEXTO.
  * **__Tipo de Reserva__**: Tipo TEXTO.
  * **__Beneficiado__**: Tipo TEXTO. 
  * **__Requisitante__**: Tipo TEXTO. Formato: NOME DO USUÁRIO (LOGIN).
  * **__Unidade Requisitante__**: Tipo TEXTO. Formato: NOME DA UNIDADE (CÓDIGO DA UNIDADE).
  * **__Data/Hora inicial__**: Tipo DATA. Formato: DD/MM/AAAA HH:MM.
  * **__Data/Hora final__**: Tipo DATA. Formato: DD/MM/AAAA HH:MM.
  * **__Unidade Requisitada__**: Tipo TEXTO. Formato: NOME DA UNIDADE (CÓDIGO DA UNIDADE).
  * **Quantidade de Litros**: Tipo - DECIMAL.
  * **__Veículo Selecionado__**: Tipo - TEXTO. Formato: MARCA/MODELO PLACA: XXX -9999 - NOME DA UNIDADE (CÓDIGO DA UNIDADE).
  * **__Motorista Selecionado__**: Tipo - TEXTO. Formato: Nome (CPF).
  * **__Destino__**: Tipo TEXTO. ([[#principais_regras_de_negócio|RN06]])
  * **__Finalidade__**: Tipo TEXTO. ([[#principais_regras_de_negócio|RN06]])
  * **__Quantidade de pessoas a serem transportadas__**: Tipo NUMÉRICO. ([[#principais_regras_de_negócio|RN06]])
  * **__Quantidade de carga que será transportada__**: Tipo TEXTO. ([[#principais_regras_de_negócio|RN06]])
  * **__Arquivo Anexo__**: Download do arquivo anexo.


Na solicitação de troca de pneu: ([[#principais_regras_de_negócio|RN12]]).

===Passo 1===

  * **Unidade Requisitante***: Tipo - TEXTO. ([[#principais_regras_de_negócio|RN01]]).
  * **Veículo Para Troca de Pneu***: Tipo - AUTOCOMPLETE. Formato - MODELO - PLACA - UNIDADE DO VEÍCULO. 
  * **Observação**: Tipo - TEXTO.

===Passo 2===

Seguindo o fluxo de [[desenvolvimento:especificacoes:sipac:requisicoes:casos_de_uso:material:almoxarifado:cadastrar_requisicao|requisição de material para o almoxarifado]] omitindo o passo 2 e no passo 3 será possível buscar apenas materiais relacionados a ''PNEU''.




O caso de uso é finalizado.

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

  * **RN01** - Caso o usuário não seja gestor global, só poderão ser visualizadas as reservas restritas a sua unidade.
  * **RN02** - No caso da reserva para uma saída, o veículo ficará indisponível por uma hora (entre a hora informada e uma hora a mais).
  * **RN03** - No caso da solicitação de abastecimento de veículo da unidade, o veículo ficará indisponível por meia hora (entre a hora informada e meia hora a mais).
  * **RN04** - Na solicitação de abastecimento de um veículo da unidade, deverá ser informado um veículo que esteja disponível durante o período informado.
  * **RN05** - É permitido escolher veículos da Unidade Gestora do usuário ou de suas unidade filhas. (Adicionado em 27/04/2012, referente a tarefa 89652)
  * **RN06** - Esses campos são exibidos para as requisições destinadas a um período ou saída. (Adicionado em 27/04/2012, referente a tarefa 89653)
  * **RN07** - Se a requisição for cadastrada após às 15hrs e for sexta ou véspera de feriado, exibir aviso que ela poderá não ser atendida a tempo. (Adicionado em 01/10/2012, referente a tarefa 99019).
  * **RN08** - Para as requisições de combustível de gerador é necessário que o parâmetro //NECESSITA_AUTORIZACAO_ABASTECIMENTO_GERADORES=TRUE// e a unidade do usuário logado deve está inserida no parâmetros //UNIDADE_PERMISSAO_ABASTECIMENTO_GERADOR//. (Adicionado em 01/08/2013, referente a tarefa 117169).
  * **RN09** - Só aparecem aos veículo que tiverem veículo com o campo 'Gerador que precisa Fluxo de Autorização' = SIM (Adicionado em 01/08/2013, referente a tarefa 117169).
  * **RN10** - As unidades que não cadastrarem atesto de abastecimento ficarão bloqueadas para novas requisições. (Referente a tarefa 124341)
  * **RN11** - Definir como padrão grupo de material 3039 e denominação "PNEU" para os passos 2 e 3 omitidos.
  * **RN12** - Essa sub requisição gera uma requisição de material para almoxarifado vinculada a uma requisição de troca de pneu para transportes.
  * **RN13** - Após o cadastro de uma requisição será enviado um e-mail para a chefia imediata.
  * **RN14** - A opção será ocultada quando o parâmetro UTILIZA_REQUISICAO_ABASTECIMENTO for setado como=false
  * **RN15** - Campo obrigatório caso alguma "recorrência" tenha sido selecionada.
  * **RN16** - Data deve ser maior ou igual a data atual.
==== Resoluções/Legislações Associadas ====

Não se aplica.

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

^ Classe ^ Tabela |
| br.ufrn.sipac.requisicoes.veiculo.dominio.RequisicaoReservaVeiculo| administrativo.requisicoes.requisicao_reserva_veiculo |
| br.ufrn.sipac.transportes.dominio.ReservaVeiculo| administrativo.transporte.reserva_veiculo |




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

Sistema: SIPAC

Módulo: Portal Administrativo 

Link(s): Requisições -> Veículo/Transporte -> Cadastrar Requisição.

Usuários: bergue, marcilia

Papel que usuário deve ter: SipacPapeis.GESTOR_TRANSPORTES_GLOBAL ou SipacPapeis.REQUISITOR_RESERVA_VEICULO.

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

Para verificar se os dados foram cadastrados/alterados corretamente, pode-se verificar a listagem exibida em SIPAC -> Portal Administrativo -> Requisições -> Reserva de Veículo para Deslocamento -> Modificar Requisição.

===== Dados para o Teste =====
 
Não se aplica.