~~ODT~~ echo "
"; echo "Última atualização: "; ver('', false); echo "
"; ====== 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 ([[#principais regras de negócio|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 ([[#principais regras de negócio|RN02]]). O caso de uso começa apresentando a lista de veículos previamente reservados, através do caso de uso de [[desenvolvimento:especificacoes:sipac:transportes:casos_de_uso:deslocamento:requisicoes_de_veiculo:cadastrar| 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 [[desenvolvimento:especificacoes:sipac:requisicoes:casos_de_uso:veiculo_transporte::cadastrar_requisicao| 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 ([[#principais regras de negócio|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 | | | | **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 | | | | **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 ([[#principais regras de negócio|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!