~~ODT~~ echo "
"; echo "Última atualização: "; ver('', false); echo "
"; ====== Alterar Retorno/Retorno dos Veículos da Unidade ====== Este caso de uso é utilizado pelos requisitores de veículos, gestores globais de transporte ou gestores de reserva de veículo para alterar a 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 -> Alterar Retorno/Retorno dos Veículos da Unidade. Caso o usuário possua o perfil de requisitor de veículos, o caso de uso é acionado ao acessar a opção: SIPAC -> Módulo Transportes -> Aba Deslocamento-> Operações -> Saída/Retorno de Veículo -> Alterar Retorno/Retorno de Minhas Reservas ([[#principais regras de negócio|RN02]]). O caso de uso começa aparecendo a lista de veículos previamente reservados, a 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. Tal requisição pode ser feita através da funcionalidade: [[desenvolvimento:especificacoes:sipac:requisicoes:casos_de_uso:veiculo_transporte::cadastrar_requisicao| Cadastro de Requisição de Reserva de Veículo]]. A lista exibe as reservas as quais o usuário poderá alterar o registro de Retorno ([[#principais regras de negócio|RN03]]) dentro de um tempo pré-estabelecido ([[#principais regras de negócio|RN04]]). Será exibida a lista com os seguintes campos: * **__Foto do Veículo__**: A imagem do veículo escolhido. Tipo - IMAGEM. * **__Beneficiado__**: Pessoa a ser beneficiada pela reserva. Tipo TEXTO. formato: NOME BENEFICIADO - CPF ou CNPJ. * **__Data Inicial__**: Data e hora em se inicia a reserva do veículo. Formato: DD/MM/AAAA - HH:MM, Tipo: TEXTO * **__Data Final__**: Data e hora em que se encerra a reserva do veículo. Formato: DD/MM/AAAA - HH:MM, Tipo: TEXTO * **__Tipo de Reserva__**: O Tipo de reserva cadastrada. Tipo TEXTO. * **__Veículo__**: Marca/Modelo/Ano do veículo, bem como sua placa. Tipo - TEXTO, formato: MARCA/MODELO PLACA: AAA-9999. * **__Unidade__**: A qual pertence o veículo. Tipo - TEXTO, formato: DENOMINAÇÃO UNIDADE (CÓDIGO). * **__Tipo de Uso__**: Qual a principal utilidade do veículo. Tipo TEXTO. * **__Status da Reserva__**: Status em que a reserva se encontra atualmente. Tipo - TEXTO. === Alterar Retorno de Veículos === Ao selecionar a opção de alterar uma Retorno, o sistema exibe os seguintes dados: O sistema exibe os dados do veículo reservado ([[#principais regras de negócio|RN04]]): * **__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, formato: DENOMINAÇÃO UNIDADE (CÓDIGO). * **__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 segue com os dados da reserva do veículo já cadastrada: * **__Tipo de Reserva__**: O Tipo de reserva a ser cadastrada. Tipo TEXTO. * **__Beneficiado__**: Pessoa a ser beneficiada pela reserva. Tipo TEXTO. formato: NOME BENEFICIADO - CPF ou CNPJ. * **__Data/Hora Inicial__**: Data e hora em se inicia a reserva do veículo. Formato: DD/MM/AAAA - HH:MM, Tipo DATA. * **__Data/Hora Final__**: Data e hora em que se encerra a reserva do veículo. Formato: DD/MM/AAAA - HH:MM, Tipo DATA. * **__Destino__**: Destino do veículo. Formato: DESCRIÇÃO, Tipo: TEXTO. * **__Finalidade__**: Informação complementar sobre a finalidade da reserva. Formato: DESCRIÇÃO, Tipo: TEXTO. * É exibida uma listagem com os motoristas relacionados, com o campo: * **__Nº__**: Tipo NUMÉRICO. * **__Motorista__**: Tipo TEXTO, formato: NOME MOTORISTA - DOCUMENTO. * **__Odômetro de Retorno__**: Odômetro em que o veículo está realizando a Retorno. Tipo TEXTO, formato: 999999. Logo abaixo da exibição dos dados já cadastrados, seguem os dados a serem informados pelo usuário cadastrante. * **Observação**: Informações adicionais sobre a Retorno do veículos. Tipo TEXTO. * **Finalidade de Deslocamento***: Finalidade do deslocamento do veículo. Tipo TEXTO. * **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 PASSAGEIRO - CPF. O fluxo é então finalizado. === Alterar Retorno de Veículo === Tal fluxo é semelhante ao anteriormente descrito, diferenciando que ao usuário será requerida a inserção dos dados: ***Odômetro Final:** Tipo NUMÉRICO. E a definição dos trechos preenchidos, com os dados: ***Nº**: Tipo NUMÉRICO. ***Pago**: Tipo TEXTO. ***Ida/Volta**: Tipo TEXTO. Ida ou Volta. ***Finalidade de Deslocamento**: Tipo TEXTO. ***Destino**: Tipo TEXTO. ***__Data de Retorno__**: Tipo DATA, formato DD/MM/AAAA HH:MM. ***__Data de Chegada__**: Tipo DATA, formato DD/MM/AAAA HH:MM. ***Odômetro Final**: Tipo NUMÉRICO. Ao alterar o retorno, o fluxo é 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 alterar a Retorno de veículos onde ele é o beneficiado. * **RN03** - Os veículos só estarão disponíveis para efetuar a alteração de Retorno se ja houver uma Retorno cadastrada //ParametrosTransporte.QTD_MINUTOS_MINIMO_SAIDA_VEICULO//. * **RN04** - Os veículos poderão alterar Retorno mesmo que já tenha sido ultrapassado o início da reserva, ficando apenas limitado em um tempo anterior ao término da reserva. * **RN05** - O preenchimento da finalidade de Deslocamento é obrigatório. ==== 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): * SIPAC -> Módulo Transportes -> Aba Deslocamento -> Retorno/Retorno de Veículo -> Alterar Saída/Retorno dos Veículos da Unidade * SIPAC -> Módulo Transportes -> Aba Deslocamento -> Retorno/Retorno de Veículo -> Alterar Saída/Retorno de Minhas Reservas Usuários: raphaela (Gestor de Transportes Global), marcilia (Requisitor Reserva Veículo), eric (Gestor de Reserva e Deslocamento). Papel que usuário deve ter: * SipacPapeis.REQUISITOR_RESERVA_VEICULO * SipacPapeis.GESTOR_TRANSPORTES_GLOBAL * SipacPapeis.GESTOR_TRANSPORTES_RESERVA_DESLOCAMENTO. ===== Cenários de Teste ===== Para obter a lista de reservas passíveis de registro de Retorno, temos que acessar outro caso de uso, sendo esse o de [[desenvolvimento:especificacoes:sipac:transportes:casos_de_uso:deslocamento:requisicoes_de_veiculo:cadastrar| Cadastro de Reserva de Veículo]], ou também podemos, obter uma reserva [[desenvolvimento:especificacoes:sipac:requisicoes:casos_de_uso:veiculo:autorizar_requisicao_reserva_veiculo | Aprovando uma Requisição de Reserva de Veículo]]. A lista estará exibindo as reservas o qual o usuário poderá efetuar o registro de Retorno oriundas desses dois casos de uso, lembrando que estará disponíveis respeitando as regras de horário, descritas acima. Para verificar se os dados foram cadastrados/alterados corretamente, pode-se verificar a listagem exibida em SIPAC -> Módulo Transportes -> Aba Deslocamento-> Operações -> Retorno/Retorno de Veículo -> Alterar Retorno/Retorno dos Veículos da Unidade. ===== Dados para o Teste ===== Não se aplica!