~~ODT~~ echo "
"; echo "Última atualização: "; ver('', false); echo "
"; ====== Registrar Saída/Retorno de Minhas Reservas ====== Este caso de uso é utilizado pelos requisitores de veículos, gestores globais de transporte ou gestores de reserva de veículo para registrar a saída 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. 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 -> Registrar Saída/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á efetuar o registro de saída ([[#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. * **__Motorista__**: Nome do motorista ou de um dos motoristas da reserva. * **__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. === Registrar Saída de Veículos === Ao selecionar a opção de registrar uma saída, o sistema exibe os seguintes dados: O sistema exibe os dados do veículo reservado ([[#principais regras de negócio|RN04]]) ([[#principais regras de negócio|RN06]]): * **__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. * **__Hodômetro de Saída__**: Hodômetro em que o veículo está realizando a saída. 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 saída 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. === Registrar Retorno de Veículo === Tal fluxo é semelhante ao anteriormente descrito, diferenciando que ao usuário será requerida a inserção dos dados: ***Hodô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 Saída__**: Tipo DATA, formato DD/MM/AAAA HH:MM. ***__Data de Chegada__**: Tipo DATA, formato DD/MM/AAAA HH:MM. ***Hodômetro Final**: Tipo NUMÉRICO. Ao registrar o retorno, o fluxo é finalizado. ========== O caso de uso é 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 saída em um tempo pré determinado pelo parâmetro //ParametrosTransporte.QTD_MINUTOS_MINIMO_SAIDA_VEICULO//. * **RN04** - Os veículos poderão efetuar saída 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. * **RN06** - 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): * SIPAC -> Módulo Transportes -> Aba Deslocamento -> Saída/Retorno de Veículo -> Registrar Saída/Retorno dos Veículos da Unidade * SIPAC -> Módulo Transportes -> Aba Deslocamento -> Saída/Retorno de Veículo -> Registrar Saída/Retorno de Minhas Reservas Usuários: bergue (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, * SipacPapeis.GESTOR_TRANSPORTES_UNIDADES. ===== Cenários de Teste ===== Para obter a lista de reservas passíveis de registro de saída, 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 saída 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 -> Saída/Retorno de Veículo -> Registrar Saída/Retorno dos Veículos da Unidade. ===== Dados para o Teste ===== Não se aplica!