~~ODT~~ echo "
"; echo "Última atualização: "; ver('', false); echo "
"; ====== Autorizar Requisições ====== 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 -> Transporte -> Deslocamento -> Requisições de Veículo -> Autorizar Requisições //. ====Passo 1==== Ao acessar o 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: ***Número/Ano**: Tipo: NUMÉRICO, formato: 9.../AAAA. ***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, TEXTO(AUTOCOMPLETE). Pode ser buscada pelo código ou pelo nome ou selecionada pela árvore de unidades. ***Unidade Requisitada**: Tipo: NUMÉRICO, TEXTO. ***Período da Reserva:** Tipo: DATA, Formato: DD/MM/AAAA a DD/MM/AAAA. ***Tipo de uso do veículo**: Tipo TEXTO. ***Tipo de Reserva**: Tipo TEXTO. ***Ocultar Requisições Vencidas**: Tipo - LÓGICO. ***Todas Requisições Pendentes**: Tipo - LÓGICO. Então é exibido uma lista de requisições para análise, onde poderemos selecioná-las para análise, a lista possui os seguintes campos: * **__Requisição__**: Tipo: NUMÉRICO. Número e ano da requisição. Formato: 999/9999. * **__Tipo de Reserva__**: Tipo: TEXTO. * **__Beneficiado__**: Tipo: TEXTO. Pessoa a ser beneficiada pela reserva. Formato: RAZÃO SOCIAL OU NOME - CNPJ ou CPF. * **__Unidade Requisitante__**: Tipo: TEXTO. Unidade que está requisitando a reserva ou saída do veículo. Formato: DENOMINAÇÃO DA UNIDADE (CÓDIGO). * **__Unidade Solicitada__**: Tipo: TEXTO. Unidade que está sendo requisitada a reserva ou saída do veículo. Formato: DENOMINAÇÃO DA UNIDADE (CÓDIGO). * **__Tempo Decorrido__**: Tipo: DATA. Tempo decorrido entre o cadastro da solicitação e a análise pelo gestor. Formato: [9d 99h 99min]. * **__Placa__**: Placa do veículo, para os casos de requisição para abastecimento. Tipo - TEXTO. * **__Data da Solicitação__**: Tipo: DATA. Data e hora que foi realizado a requisição da reserva do veículo. Formato: DD/MM/AAAA - HH:MM. * **__Tipo de Uso__**: Tipo: TEXTO. O Tipo de uso do veículo, a ser requisitado. Formato: DENOMINAÇÃO DO TIPO DE USO DO VEÍCULO. * **__Data Inicial__**: Tipo: DATA. Data e hora em que se inicia a reserva do veículo. Formato: DD/MM/AAAA HH:MM. * **__Data Final__**: Tipo: DATA. Data e hora em que se encerra a reserva do veículo. Formato: DD/MM/AAAA HH:MM. Para cada um dos registros encontrados é possível //Visualizar Requisição de Reserva// ou //Selecionar a Requisição// para autorização. ====Passo 2==== ===Visualizar Requisição de Reserva=== Para cada tipo de requisição, seguem os fluxos abaixo: * [[desenvolvimento:especificacoes:sipac:fluxos:fluxo_visualizar_requisicao_reserva_de_veiculo|Visualizar Requisição de Reserva de Veículo]]. * Para as requisições de troca de pneu, na tela de visualizar requisição também serão exibidos os dados da requisição de material associada a mesma: * **__Número__**: Tipo - TEXTO. Formato - 9.../AAAA. * **__Status__**: Tipo - TEXTO. * **__Grupo de Material__**: Tipo - NUMÉRICO. * **__Unidade Orçamentária__**: NOME DA UNIDADE DE CUSTO. * **__Unidade Requisitante__**: NOME DA UNIDADE REQUISITANTE. * **__Data__**: Tipo - TEXTO. Formato: DD/MM/AAAA. * **__Valor__**: Tipo - TEXTO. Formato: R$ 99,99. * **__Observações__**: Tipo - TEXTO. ===Selecionar Requisição=== São exibidas as informações do fluxo de [[desenvolvimento:especificacoes:sipac:fluxos:fluxo_visualizar_requisicao_reserva_de_veiculo|Visualizar Requisição de Reserva de Veículo]]. É possível //Autorizar//, //Retornar//, //Negar// ou //Repassar a Requisição// ([[#principais regras de negócio|RN09]]). ==Fluxo Alternativo 1 - Autorizar Requisição== Para os tipos de reservas para um período ou uma saída, o gestor deve informar se a reserva será necessário abastecimento. Caso seja indicado a necessidade de um abastecimento deverá ser informada a quantidade litros a ser abastecida ([[#principais regras de negócio|RN11]]). Os campos exibidos logo após os dados da requisição são: * **Necessita Abastecimento?**: Tipo - BOOLEANO. Se a reserva necessita ou não de abastecimento. * **Quantidade de Litros**: Tipo - NUMÉRICO. Quantidade a ser abastecida pela reserva. Para autorizar a requisição, 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__**: Tipo - IMAGEM. A imagem do veículo a ser escolhido. * **__Modelo__**: Tipo - TEXTO. Modelo do veículo, bem como sua placa. * **__Denominação__**: Tipo - TEXTO. A denominação dada ao veículo em seu cadastro no sistema. * **__Cor__**: Tipo - TEXTO. A cor predominante do veículo. * **__Unidade__**: Tipo - TEXTO. Unidade a qual pertence o veículo. * **__Tipo de Uso do veículo__**: Tipo - TEXTO. Qual a principal utilidade do veículo. * **__Categoria__**: Tipo - TEXTO. Qual a categoria a que pertence o veículo. 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__**: Tipo - IMAGEM. A imagem do veículo a ser escolhido. * **__Marca/Modelo__**: Tipo - TEXTO. Marca/Modelo do veículo, bem como sua placa. Tipo - TEXTO. * **__Denominação__**: Tipo - TEXTO. A denominação dada ao veículo em seu cadastro no sistema. * **__Status__**: Tipo - TEXTO. Status atual do veículo. * **__Cor__**: Tipo - TEXTO. A cor predominante do veículo. * **__Unidade__**: Tipo - TEXTO. A Unidade qual pertence o veículo. * **__Proprietário__**: Tipo - TEXTO. O proprietário do veículo. * **__Tipo de Uso__**: Tipo - TEXTO. Qual a principal utilidade do veículo. * **__Categoria__**: Tipo - TEXTO. Qual a categoria a que pertence o veículo. **Motoristas da Reserva** * **Motorista***: Tipo - TEXTO, AUTOCOMPLETE. ([[#principais regras de negócio|RN14]]) Ao adicionar um ou mais motoristas, estes são exibidos conforme listado abaixo com opção de remoção. * **__Nº__**: Tipo: NUMÉRICO. * **__Motorista__**: Tipo - TEXTO. Ao selecionar o veículo e autorizar a requisição, é finalizado o fluxo de autorização da requisição de reserva. Para uma requisição de troca de pneu, são exibidos os dados que constam no [[desenvolvimento:especificacoes:sipac:fluxos:fluxo_visualizar_requisicao_troca_de_pneu|fluxo de troca de pneu]], existe apenas a opção de confirmar atendimento, que direciona o usuário para a funcionalidade de [[desenvolvimento:especificacoes:sipac:transportes:casos_de_uso:gastos_manutencao:manutencao:cadastrar|cadastro de manutenção de veículo]]. ===Fluxo Alternativo 2 - 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***: Tipo: TEXTO. Unidade que será redirecionada a requisição de reserva. Formato: DENOMINAÇÃO DA UNIDADE (CÓDIGO). * **Justificativa***: Tipo: TEXTO. Texto com a justificativa do repasse da requisição. Ao enviar estes dados, é finalizado o fluxo alternativo. ===Fluxo Alternativo 3 - Negar Requisição de Reserva=== Este fluxo alternativo é iniciado ao clicar no botão "Negar". 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***: Tipo: TEXTO. Texto com a justificativa para a negação da requisição de reserva. Ao enviar a justificativa, o status da requisição será "NEGADA", e será finalizado este fluxo alternativo ([[#principais regras de negócio|RN08]]). ===Fluxo Alternativo 4 - Retornar Requisição de Reserva=== Este fluxo alternativo é iniciado ao clicar no botão "Retornar". Será apresentada a tela onde o gestor irá descrever a justificativa para retorno da requisição de reserva de veículo ([[#principais regras de negócio|RN15]]). A tela terá apenas o campo: * **Justificativa***: Tipo: TEXTO. Texto com a justificativa para o retorno da requisição de reserva. Ao enviar a justificativa, o status da requisição será "RETORNADA", e será finalizado este fluxo alternativo ([[#principais regras de negócio|RN08]]). O caso de uso é finalizado. ===== Principais Regras de Negócio ===== * **RN01** - O horário de início e término deve ser múltiplo de 30 minutos, para facilitar o controle de reservas. * **RN02** - Não poderá autorizar requisições com a data Inicial retroativa ao momento da autorização. * **RN03** - Serão exibidos apenas os veículos disponíveis no horário em que foi requisitado o veículo, ou seja, os veículos que não possuam uma reserva ativa no período. * **RN04** - A lista de veículos também deverá ter apenas veículos do tipo de veículo especificado na requisição. * **RN05** - O preenchimento dos campos Unidade Requisitada e Justificativa são obrigatórios. * **RN06** - O preenchimento do campo Justificativa é obrigatório. * **RN07** - Uma vez negada a requisição ela não poderá ser aberta novamente. * **RN08** - Para todos os fluxos serão enviados emails para o requisitante e beneficiado com os detalhes da operação. * **RN09** - Só será possível repassar uma requisição que não seja uma solicitação de abastecimento. * **RN10** - Só poderão ser adicionados motoristas que a sua carteira não esteja vencida, ou esteja no período de 30 dias após o vencimento. * **RN11** - Para reservas de um período ou para uma saída o campo //Quantidade de Litros// só deverá ser exibido e de preenchimento obrigatório, caso //Necessidade de Abastecimento// esteja marcado. * **RN12** - São listadas apenas as requisições de troca de pneu que tiveram a requisição de material associada atendida. * **RN13** - Só poderão ser atendidas as requisições que tiverem itens de manutenção associados ao material requisitado. * **RN14** - Não poderá ser adicionado um motorista que já tenha sido adicionado em outra requisição de horário concomitante. * **RN15** - A requisição RETORNADA será passível de alteração e reenvio. ==== 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 -> Requisições de Veículo -> Autorizar Requisições Usuários: bergue Papel que usuário deve ter: * SipacPapeis.GESTOR_TRANSPORTES_UNIDADES, * SipacPapeis.GESTOR_TRANSPORTES_GLOBAL, * 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 ===== Para testar o caso de uso terá que se cadastrar requisições de veículo para poder seguir da autorização de reserva. Para isso terá que se utilizar 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]] antes de poder autorizar, negar ou repassar uma requisição.