~~ODT~~

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



====== Registrar Abastecimento ======

Este caso de uso é utilizado pelos gestores de transportes para controlar todos os abastecimentos realizados no veículo da frota da instituição. 

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

O caso de uso é acionado quando o usuário acessa a opção: SIPAC -> Módulo Transportes -> Aba Abastecimento -> Abastecimento -> Registrar Abastecimento.

O caso de uso começa com o usuário acessando o sistema e preenchendo os dados do cadastro como segue abaixo:
  * **Placa**: Nesse campo será informado a placa do veículo que ocorreu o evento. Tipo AUTOCOMPLETE, formato: XXX-9999, entrada de dados: PLACA.

Nesse momento são mostrados os dados referentes a placa inserida:
   * **__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.

Caso esteja alterando um abastecimento que tenha sido importado através de arquivo serão exibidos os seguintes dados:
== Com requisição definida ==
   * **__Número__**: Tipo - TEXTO, formato: 9.../AAAA.
   * **__Status__**: Tipo - TEXTO.
   * **__Tipo de Reserva__**: Tipo - TEXTO.
   * **__Beneficiado__**: Tipo - TEXTO, formato: NOME DO BENEFICIADO - CPF.
   * **__Requisitante__**: Tipo - TEXTO, formato: NOME DO REQUISITANTE (LOGIN).
   * **__Unidade Requisitante__**: Tipo - TEXTO, formato: NOME DA UNIDADE (CÓDIGO DA UNIDADE).
   * **__Tipo de Uso__**: Tipo - TEXTO.
   * **__Data/Hora inicial__**: Tipo - DATA, formato: DD/MM/AAAA HH:MM.
   * **__Data/Hora final__**: Tipo - DATA, formato: DD/MM/AAAA HH:MM.
   * **__Unidade Requisitada__**: Tipo - TEXTO, formato: NOME DA UNIDADE (CÓDIGO DA UNIDADE).
   * **__Destino__**: Tipo - TEXTO.
   * **__Finalidade__**: Tipo - TEXTO.
   * **__Quantidade de pessoas a serem transportadas__**: Tipo - NUMÉRICO.
   * **__Quantidade de carga que será transportada__**: Tipo - NUMÉRICO.
==Sem requisição definida==
Aparecerá a seguinte mensagem para o usuário do sistema:
(Nenhuma requisição foi associada a esse abastecimento).
\\


Os dados que o usuário poderá informar serão os seguintes:
  * **Unidade**: Nesse campo será a unidade beneficiada com o abastecimento.  Tipo TEXTO, formato: DENOMINAÇÃO UNIDADE.
  * **Data/Hora da Transação**: Data e hora em que ocorreu o abastecimento. Formato: DD/MM/AAAA - HH:MM, Tipo: TEXTO  ([[#principais regras de negócio|RN03]]).
  * **Data Postagem**: Data do processamento do abastecimento pela empresa contratada. Se não é contratual é a data atual. Formato: DD/MM/AAAA - HH:MM, Tipo: TEXTO.  ([[#principais regras de negócio|RN03]])
  * **Estabelecimento**: Posto de combustível (Pessoa Jurídica) que forneceu o produto. Tipo AUTOCOMPLETE, formato: DENOMINAÇÃO ESTABELECIMENTO, entrada de dados: DENOMINAÇÃO ou CNPJ.
  * **Origem do Abastecimento**: O Tipo de origem do combustível. Formato: DENOMINAÇÃO DO TIPO DA ORIGEM, Tipo: TEXTO(COMBO).
  * **Doador**: Pessoa ou empresa que doou o combustível. Tipo AUTOCOMPLETE, formato: NOME - CPF, entrada de dados: NOME ou CPF ([[#principais regras de negócio|RN06]]).
  * **Combustível**: O Tipo de combustível do abastecimento. Tipo TEXTO.
  * **Motorista**: Motorista responsável no momento do abastecimento. Tipo AUTOCOMPLETE, formato: NOME - CPF, entrada de dados: NOME ou CPF.
  * **Quantidade (l)**: Quantidade abastecida de combustível em litros. Tipo NUMÉRICO.
  * **Valor total (R$)**: Custo total do abastecimento. Tipo NUMÉRICO.
  * **Hodômetro**: O hodômetro do veículo no momento do abastecimento. Tipo NUMÉRICO.o
  * **Observação**: Informação complementar sobre o abastecimento. Tipo TEXTO.

O caso de uso é finalizado.
===== Principais Regras de Negócio =====

   * <del>**RN01** - Para ter acesso a este caso de uso, o usuário logado deve ter um dos seguintes papeis: SipacPapeis.GESTOR_TRANSPORTES_UNIDADES ou SipacPapeis.GESTOR_TRANSPORTES_GLOBAL </del>.
   * **RN02** - O usuário informará a placa do carro, para obter qual o veículo será cadastrado o evento.
   * **RN03** - A data deve ser preenchida com a data e hora em que ocorreu o abastecimento.
   * **RN04** - Os campos: veículo, data/hora transação, tipo de origem, combustível e motorista são de preenchimento obrigatório.
   * **RN05** - O campo hodômetro será de preenchimento obrigatório, caso o hodômetro do veículo não esteja com defeito.
   * **RN06** - O campo doador será obrigatório exclusivamente quando tipo de origem do abastecimento for Doação. Uma mensagem de erro será informada caso seja preenchido um doador para uma origem de abastecimento diferente.
   * **RN07** - O campo Unidade, será definido pela unidade da requisição, caso não se tenha uma requisição de veículo associada, poderá ser colocada manualmente.

==== Resoluções/Legislações Associadas ====
Não se aplica.

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

^ Classe ^ Tabela |
| br.ufrn.sipac.transportes.dominio.TipoCombustivel | administrativo.transporte.tipo_combustivel |
| br.ufrn.sipac.transportes.dominio.AbastecimentoVeiculo | administrativo.transporte.abastecimento |




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

Sistema: SIPAC

Módulo: TRANSPORTES

Link(s): SIPAC → Módulo Transportes → Aba Abastecimento → Abastecimento → Registrar Abastecimento. 

Usuários: bergue

Papel que usuário deve ter: 
  * SipacPapeis.GESTOR_TRANSPORTES_GLOBAL.

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

Para verificar se os dados foram cadastrados/alterados corretamente, pode-se verificar a listagem exibida em Menu Transportes -> Veículo -> Abastecimento -> Listar/Alterar.


===== Dados para o Teste =====

Não se aplica!