~~ODT~~ echo "
"; echo "Última atualização: "; ver('', false); echo "
"; ====== Autorizar Requisição de Reserva de Veículo ====== Este caso de uso é utilizado pelos gestores de reserva e deslocamento para avaliarem e atenderem as reservas solicitadas pelos usuários dos veículos da frota. ===== Descrição do Caso de Uso ===== O caso de uso é acionado quando o usuário acessa a opção: SIPAC -> Portal Administrativo -> Requisições -> Veículo -> Autorizar Requisições de Reserva ([[#principais regras de negócio|RN01]]). Na página onde se encontra este caso de uso é exibida uma lista de requisições de reserva. Onde o conteúdo irá depender dos filtros aplicados pelo usuário. São requeridas as seguintes informações para a restringir a lista de veículos a ser exibida: ***Beneficiado:** Tipo AUTOCOMPLETE, formato: RAZÃO SOCIAL - CPF/CNPJ, entrada de dados: RAZÃO SOCIAL OU NOME (CNPJ ou CPF). ***Unidade Requisitante**: Tipo NUMÉRICO, AUTOCOMPLETE e TEXTO, Formato: CÓDIGO DA UNIDADE | NOME DA UNIDADE | ÁRVORE DE UNIDADES. ***Período:** Tipo DATA, Formato: DD/MM/AAAA a DD/MM/AAAA. ***Tipo do uso do veículo**: Tipo TEXTO, Formato: DENOMINAÇÃO DO TIPO DO USO DO VEÍCULO. Então é exibido uma lista de requisições para análise, onde poderemos selecioná-las para análise, a lista possui os seguintes campos: * **__Número__**: Número e ano da requisição. Formato: 999/9999. * **__Beneficiado__**: Pessoa a ser beneficiada pela reserva. Formato: RAZÃO SOCIAL OU NOME (CNPJ ou CPF). * **__Unidade Requisitante__**: Unidade que está requisitando a reserva ou saída do veículo. Formato: CÓDIGO / DENOMINAÇÃO DA UNIDADE. * **__Unidade Requisitada__**: Unidade que está sendo requisitada a reserva ou saída do veículo. Formato: CÓDIGO / DENOMINAÇÃO DA UNIDADE. * **__Tempo Decorrido__**: Tempo decorrido entre o cadastro da solicitação e a análise pelo gestor. Formato: [9d 99h 99min]. * **__Data da Solicitação__**: Data e hora que foi realizado a requisição da reserva do veículo. Formato: DD/MM/AAAA - HH:MM. * **__Tipo de Uso__**: O Tipo de uso do veículo, a ser requisitado. Formato: DENOMINAÇÃO DO TIPO DE USO DO VEÍCULO. * **__Data/Hora Inicial__**: Data e hora em se inicia a reserva do veículo. Formato: DD/MM/AAAA - HH:MM. * **__Data/Hora Final__**: Data e hora em que se encerra a reserva do veículo. Formato: DD/MM/AAAA - HH:MM. Ao clicar no botão de selecionar é direcionado para a tela de análise, será exibida a tela para visualizar os seguintes dados da requisição: * **__Número__**: Número e ano da requisição. Formato: 999/9999. * **__Tipo de Reserva__**: O Tipo de reserva a ser cadastrada. Formato: DENOMINAÇÃO DO TIPO DE RESERVA. * **__Beneficiado__**: Pessoa a ser beneficiada pela reserva. Formato: RAZÃO SOCIAL OU NOME (CNPJ ou CPF). * **__Requisitante__**: O usuário que fez a requisição de reserva. Formato: NOME (LOGIN). * **__Unidade Requisitante__**: Unidade que está requisitando a reserva ou saída do veículo. Formato: CÓDIGO / DENOMINAÇÃO DA UNIDADE. * **__Tipo de Uso__**: O Tipo de uso do veículo, a ser requisitado. Formato: DENOMINAÇÃO DO TIPO DE USO DO VEÍCULO. * **__Data/Hora Inicial__**: Data e hora em se inicia a reserva do veículo. Formato: DD/MM/AAAA - HH:MM ([[#principais regras de negócio|RN02]]). * **__Data/Hora Final__**: Data e hora em que se encerra a reserva do veículo. Formato: DD/MM/AAAA - HH:MM([[#principais regras de negócio|RN03]]). * **__Unidade Requisitada__**: Unidade que está sendo requisitada a reserva ou saída do veículo. Formato: CÓDIGO / DENOMINAÇÃO DA UNIDADE. * **__Destino__**: Destino do veículo. Formato: DESCRIÇÃO. * **__Finalidade__**: Informação complementar sobre o abastecimento. Formato: DESCRIÇÃO. * **__Quantidade de pessoas a serem transportadas__**: Quantidade de pessoas transportadas no veículo durante a reserva ou saída do veículo. Formato: 9999. * **__Quantidade de carga que será transportada__**: Quantidade de carga (em Kg) transportada no veículo durante a reserva ou saída do veículo. Formato: 9999. Caso possua, também serão mostradas as movimentações entre unidades da requisição exibida. O modelo da tabela com as movimentações é apresentado com os seguintes campos: * **__Data de Origem__**: Data e hora em que ocorreu a movimentação. Formato: DD/MM/AAAA - HH:MM. * **__Origem__**: Unidade de origem da requisição. Formato: CÓDIGO / DENOMINAÇÃO DA UNIDADE. * **__Destino__**: Unidade de destino da requisição. Formato: CÓDIGO / DENOMINAÇÃO DA UNIDADE. * **__Enviado por__**: Gestor responsável pela movimentação da requisição. Formato: RAZÃO SOCIAL OU NOME (CNPJ ou CPF). * **__Justificativa__**: Justificativa para a criação da movimentação. Formato: TEXTO. Para o fluxo de autorizar, deve-se selecionar o veículo para a criação da reserva, onde serão exibidos os seguintes dados: ([[#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. * **__Tipo de Uso__**: Qual a principal utilidade do veículo. Tipo - TEXTO. * **__Categoria__**: Qual a categoria a que pertence o veículo. Tipo - TEXTO. Deve ser apresentada uma lista de veículos disponíveis para o horário fornecido pelo requisitor da reserva. Onde o Gestor de Reserva poderá selecionar um veículo para ser utilizado no deslocamento do beneficiado ([[#principais regras de negócio|RN05]]). A lista de veículo será mostrada com os seguintes campos: * **__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. * **__Status__**: Status atual do veículo. Tipo - TEXTO. * **__Cor__**: A cor predominante do veículo. Tipo - TEXTO. * **__Unidade__**: A Unidade qual pertence o veículo. Tipo - TEXTO. * **__Proprietário__**: O proprietário do veículo. 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. Ao selecionar o veículo e autorizar a requisição, é finalizado o fluxo de autorização da requisição de reserva. Mas podemos ter mais dois fluxos altenativos: ===Repassar Requisição de Reserva=== Este fluxo alternativo é iniciado ao clicar no botão "Repassar Requisição". Ao clicar deve-se mostrar a tela, onde o gestor detalhará para qual unidade será repassada a requisição de reserva e a justificativa do repasse ([[#principais regras de negócio|RN06]]). A tela deverá ter os seguinte campos: * **Unidade Requisitada***: Unidade que será redirecionada a requisição de reserva. Formato: CÓDIGO / DENOMINAÇÃO DA UNIDADE, Tipo: NUMÉRICO, AUTOCOMPLETE e TEXTO. * **Justificativa***: Texto com a justificativa do repasse da requisição. Formato: DESCRICAO JUSTIFICATIVA, Tipo: TEXTO. Ao enviar estes dados, é finalizado o fluxo alternativo. ===Negar Requisição de Reserva=== Este fluxo alternativo é iniciado ao clicar no botão "Negar Autorização". Será apresentada a tela onde o gestor irá descrever a justificativa para negar a requisição de reserva de veículo ([[#principais regras de negócio|RN07]]). A tela terá apenas o campo: * **Justificativa***: Texto com a justificativa para a negação da requisição de reserva. Formato: DESCRICAO JUSTIFICATIVA, Tipo: TEXTO. Ao enviar a justificativa, o status da requisição vai para "NEGADA", e será finalizado este fluxo alternativo ([[#principais regras de negócio|RN08]]). ===== 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.GESTOR_TRANSPORTES_GLOBAL ou SipacPapeis.GESTOR_TRANSPORTES_RESERVA_DESLOCAMENTO. * **RN02** - O horário de início e término deve ser múltiplo de 30 minutos, para facilitar o controle de reservas. * **RN03** - Não poderá autorizar requisições com a data Inicial retroativas ao momento da autorização. * **RN04** - Será exibido apenas os veículos disponíveis no horário em que foi requisitado o veículo. Ou seja, os veículo que não possuam uma reserva ativa no período. * **RN05** - A lista de veículos também deverá ter apenas veículos do tipo de veículo especificado na requisição. * **RN06** - O preenchimento dos campos Unidade Requisitada e Justificativa são obrigatórios. * **RN07** - O preenchimento do campo Justificativa é obrigatório. * **RN08** - Uma vez negada a requisição ela não poderá ser aberta novamente. * **RN09** - Para todos os fluxos serão enviados emails para o requisitante e beneficiado com os detalhes da operação. ==== 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 | | br.ufrn.sipac.requisicoes.veiculo.dominio.MovimentoRequisicaoReservaVeiculo | administrativo.requisicoes.movimento_requisicao_reserva | ====== Plano de Teste ====== Sistema: SIPAC Módulo: Transportes Link(s): Deslocamento -> Reserva de Veículos para Deslocamento -> Autorizar Requisições de Reserva Usuários: raphaela (Gestor de Transportes Global), aluizio (Gestor de Reserva e Deslocamento). Papel que usuário deve ter: SipacPapeis.GESTOR_TRANSPORTES_GLOBAL ou SipacPapeis.GESTOR_TRANSPORTES_RESERVA_DESLOCAMENTO. ===== Cenários de Teste ===== Para verificar se os dados foram alterados corretamente, pode-se verificar a listagem exibida em SIPAC -> Portal Administrativo -> Requisições -> Veículo -> Listar/Alterar Requisições de Reserva. ===== Dados para o Teste ===== Não se aplica!