Registrar Saída/Retorno dos Veículos da Unidade

Este caso de uso é utilizado pelos requisitores de veículos ou gestores de reserva de veículo para registrar o retorno dos veículos da frota previamente reservados.

Descrição do Caso de Uso

O caso de uso é acionado quando o usuário acessa a opção: SIPAC → Módulo Transportes → Aba Deslocamento→ Saída/Retorno de Veículo → Registrar Saída/Retorno dos Veículos da Unidade (RN01).

Caso o usuário tenha privilégios apenas de SipacPapeis.REQUISITOR_RESERVA_VEICULO, o acesso ao caso de uso será através da opção: SIPAC → Módulo Transportes → Aba Deslocamento→ Saída/Retorno de Veículo → Registrar Saída/Retorno de Minhas Reservas (RN02).

O caso de uso começa apresentando a lista de veículos previamente reservados, através do caso de uso de Cadastro de Reserva de Veículo, ou tendo uma Requisição de Reserva de Veículo aprovada. Onde pode-se fazer a requisição através do caso de uso de Cadastro de Requisição de Reserva de Veículo. A lista exibirá as reservas no qual o usuário poderá efetuar o registro de saída/retorno (RN03). Será exibida a lista seguindo o modelo a seguir.

Foto do Veículo	Requisição	Beneficiado	Data Inicial	Data Final	Tipo de Reserva
	9999	NOME BENEFICIADO (CPF OU CNPJ)	DD/MM/AAAA HH:MM	DD/MM/AAAA HH:MM	DENOMINACAO TIPO DE RESERVA
<FOTO DO VEÍCULO>	Veículo: DESCRICAO COMPLETA MODELO VEICULO	Unidade do Veículo: DENOMINACAO UNIDADE
	Tipo de Uso: DENOMINACAO TIPO DE USO		Status da Reserva: DENOMINACAO STATUS RESERVA
	9999	NOME BENEFICIADO (CPF OU CNPJ)	DD/MM/AAAA HH:MM	DD/MM/AAAA HH:MM	DENOMINACAO TIPO DE RESERVA
<FOTO DO VEÍCULO>	Veículo: DESCRICAO COMPLETA MODELO VEICULO	Unidade do Veículo: DENOMINACAO UNIDADE
	Tipo de Uso: DENOMINACAO TIPO DE USO		Status da Reserva: DENOMINACAO STATUS RESERVA

Para cada veículo será exibida a opção de Registrar Saída e a de Registrar Retorno.

Os veículos disponíveis para registrar o retorno deverão estar marcados. Ao selecionar uma reserva clicando em Registrar Retorno, iniciamos o fluxo exclusivo de registro de retorno de veículo. Serão exibidos na tela os seguintes campos:

O sistema exibe os dados do veículo reservado:

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: Unidade que o veículo pertence. 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.

Logo abaixo seguem os dados da saída do veículo já cadastrada:

Beneficiado: Tipo TEXTO. formato: NOME BENEFICIADO - CPF ou CNPJ.
Data/Hora inicial reservada: Data e hora em se inicia a reserva do veículo. Formato: DD/MM/AAAA - HH:MM, Tipo: TEXTO
Data/Hora registro de saída: Formato: DD/MM/AAAA - HH:MM, Tipo: TEXTO
Data/Hora final reservado: Data e hora em que se encerra a reserva do veículo. Formato: DD/MM/AAAA - HH:MM, Tipo: TEXTO
Destino: Destino do veículo. Formato: DESCRIÇÃO, Tipo: TEXTO.
Hodômetro Inicial: Tipo TEXTO, formato: 999999.

Logo abaixo da exibição dos dados já cadastrados, seguem os dados a serem informados pelo usuário cadastrante.

Hodômetro Final: Odômetro em que o veículo retornou a unidade. Tipo NUMÉRICO, formato: 999999.
Observação: Informações adicionais sobre a saída do veículo. Formato: DESCRIÇÃO, Tipo: TEXTO.
Finalidade de Deslocamento: Finalidade do deslocamento do veículo. Formato: DESCRICAO DA FINALIDADE, Tipo: COMBO.
Passageiro: Tipo AUTOCOMPLETE, formato: NOME PASSAGEIRO - CPF, entrada de dados: NOME.

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

Passageiro: Tipo TEXTO, formato: NOME MOTORISTA - CPF.

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.

Também serão preenchidos os trechos rodados pelo veículo durante a reserva (RN04), que poderão ser adicionados quantos trechos forem necessários, contudo respeitarão o intervalo original da reserva do veículo. Essa listagem aparecerá da seguinte forma:

Nº	Pago	Ida/Volta	Finalidade de Deslocamento	Destino	Data de Saída	Data de Chegada	Odômetro Final
999	[SIM, NAO]	[IDA, VOLTA]	DENOMINACAO DA FINALIDADE	DESCRICAO DESTINO	DD/MM/AAAA HH:MM	DD/MM/AAAA HH:MM	99999999999
999	[SIM, NAO]	[IDA, VOLTA]	DENOMINACAO DA FINALIDADE	DESCRICAO DESTINO	DD/MM/AAAA HH:MM	DD/MM/AAAA HH:MM	99999999999
999	[SIM, NAO]	[IDA, VOLTA]	DENOMINACAO DA FINALIDADE	DESCRICAO DESTINO	DD/MM/AAAA HH:MM	DD/MM/AAAA HH:MM	99999999999

Na última linha é exibida a opção de adicionar um novo deslocamento e remover o último deslocamento.

Ao submeter o formulário o caso de uso é, então, finalizado.

Principais Regras de Negócio

RN01 - Para ter acesso a este caso de uso, o usuário logado deve ter um dos seguintes papeis: SipacPapeis.REQUISITOR_RESERVA_VEICULO, SipacPapeis.GESTOR_TRANSPORTES_GLOBAL ou SipacPapeis.GESTOR_TRANSPORTES_RESERVA_DESLOCAMENTO
RN02 - Caso o usuário requisitante possua apenas o papel SipacPapeis.REQUISITOR_RESERVA_VEICULO ele poderá apenas registrar a saída de veículos onde ele é o beneficiado.
RN03 - Os veículos só estarão disponíveis para efetuar o registro de retorno aqueles que já efetuaram o registro de saída.
RN04 - Os trechos deverão ter por padrão apenas um trecho, contudo poderão ter quantos trechos foram utilizados o veículo, onde a data inicial do primeiro trecho, e a data final do último trecho deverão coincidir com as datas iniciais e finais da reserva.
RN05 - O preenchimento da finalidade de Deslocamento e Hodômetro Final é obrigatório, além ter ~~pelo menos um passageiro e~~ um motorista prenchido. Os dados de finalidade de deslocamento do trecho e seu odômetro final são obrigatórios.
RN06 - O hodômetro final do último trecho deve ser o mesmo do hodômetro final do retorno.
RN07 - A Data de Chegada (DD/MM/AAAA e HH:MM) do último trecho deve ser menor ou igual a data/hora atual (DD/MM/AAAA e HH:MM).

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
br.ufrn.sipac.transportes.dominio.MovimentoVeiculo	administrativo.transporte.movimento_veiculo

Plano de Teste

Sistema: SIPAC

Módulo: TRANSPORTES

Link(s):

Aba Deslocamento→ Saída/Retorno de Veículo → Registrar Saída/Retorno dos Veículos da Unidade
Aba Deslocamento→ Saída/Retorno de Veículo → Registrar Saída/Retorno de Minhas Reservas

Usuários: bergue (Gestor de Transportes Global).

Papel que usuário deve ter:

SipacPapeis.REQUISITOR_RESERVA_VEICULO
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 → Aba Deslocamento → Saída/Retorno de Veículo → Registrar Saída/Retorno dos Veículos da Unidade.

Dados para o Teste

Não se aplica!