~~ODT~~

<PHP>
echo "<div style='display:block;float:right;'>"; 
echo "Última atualização: ";
ver('', false);
echo "</div>";
</PHP>

====== Relatório de Requisições de Veículos ======

Esta funcionalidade é utilizada pelos Gestores de Transportes com a finalidade de listar e detalhar algumas informações de requisições de deslocamento. Essa funcionalidade é utilizada pelos gestores de transportes da instituição.

===== Descrição do Caso de Uso =====

Este caso de uso inicia quando o usuário acessa a opção: SIPAC -> Transportes -> Aba de Relatórios -> Deslocamentos -> Requisições de Veículos.

As seguintes opções de filtragens são oferecidas:

  * **Unidade:** Tipo AUTOCOMPLETE, formato: DENOMINAÇÃO UNIDADE, entrada de dados: DENOMINAÇÃO.
    * **Subunidade**: Tipo - LÓGICO. Caixa para marcação se quer ou não exibir as subunidades. 
  * **Placa:** Tipo TEXTO, Formato - XXX-9999.
  * **Período:** Tipo DATA, formato: DD/MM/AAAA a DD/MM/AAAA.
  * **Motorista:** Tipo TEXTO. Autocomplete com o nome dos motoristas.
  * **Tipo Veículo:** Tipo TEXTO.
  * **Tipo de Propriedade do Veículo**: Tipo TEXTO.
  * **Modo de Exibição**: Tipo - Lógico. Escolha entre //Unidades// ou //Veículos//.

Então o sistema exibe um relatório exibe as seguintes informações: 

  * **__Data/Período__**: Formato: DD/MM/AAAA ou DD/MM/AAAA até DD/MM/AAAA. Data ou período da requisição, caso ela seja "para uma saída" ou "para um período", respectivamente.
  * **__Número da Requisição__**: Formato: Número/Ano. Número e ano da requisição de deslocamento.
  * **__Placa__**: Placa do veículo utilizado na requisição.
  * **__Km Percorrido__**: Quilometragem percorrida, não exibir o total percorrido, apenas o detalhamento da ida e volta.
    * **__Ida__**: Quilometragem de ida.
    * **__Volta__**: Quilometragem de volta.
    * **__Total__**: Soma da quilometragem de ida e volta.
  * **__Destino__**: Destino da requisição.
  * **__Passageiro__**: Nome(s) do(s) passageiro(s) da requisição.
  * **__Motorista__**:  Nome(s) do(s) motorista(s) da requisição.
  * **__Observações__**: Linha com as observações cadastradas no atendimento da requisição. Essa linha existe abaixo de cada requisição exibida no relatório.

Ao final de cada unidade listada, o relatório exibe a totalização dos Km percorridos, o [[desenvolvimento:especificacoes:sipac:transportes:casos_de_uso:frota:cadastros:valor_km_terceirizado:cadastrar_listar_alterar|valor unitário]] e o valor total dos deslocamentos (Valor Unitário * Km Percorridos).

O caso de uso é finalizado.

===== Principais Regras de Negócio =====

  * **RN01** - Apenas deslocamentos associados a requisições serão listados.
  * **RN02** - Veículos terceirizados e com propriedade cadastrada terão os valores contabilizados.
==== Resoluções/Legislações Associadas ====

Não se aplica

===== Classes Persistentes e Tabelas Envolvidas =====

^ Classe                                                              ^ Tabela                                                 ^
| br.ufrn.sipac.transportes.dominio.TrechoPercorrido                  | administrativo.transporte.trecho_percorrido            |
| br.ufrn.sipac.transportes.dominio.Veiculo                           | administrativo.transporte.veiculo                      |
| br.ufrn.sipac.transportes.dominio.ModeloVeiculo                     | administrativo.transporte.modelo_veiculo               |
| br.ufrn.sipac.cadastro.dominio.Pessoa                               | administrativo.comum.pessoa                            |
| br.ufrn.sipac.transportes.dominio.ReservaVeiculo                    | administrativo.transporte.reserva_veiculo              |
| br.ufrn.sipac.requisicoes.veiculo.dominio.RequisicaoReservaVeiculo  | administrativo.requisicoes.requisicao_reserva_veiculo  |

===== Plano de Teste =====

Sistema: SIPAC

Módulo: Transportes

Link(s): Aba de Relatórios -> Deslocamentos -> Requisições de Veículos.

Usuários: bergue

Papel que usuário deve ter: 

  * SipacPapeis.GESTOR_TRANSPORTES_GLOBAL, 
  * SipacPapeis.GESTOR_TRANSPORTES_UNIDADES, 
  * SipacPapeis.RELATORIOS_TRANSPORTES, 
  * SipacPapeis.GESTOR_TRANSPORTES_RESERVA_DESLOCAMENTO,
  * SipacPapeis.AUDITOR.

===== Cenários de Teste =====

Não se aplica.
===== Dados para o Teste =====

Não se aplica.