====== Relatório de Consumo Anual de Combustíveis ======

Relatório do Módulo de Transportes que tem por objetivo listar ocorrências de consumo de combustíveis por veículo no ano expecificado. Sua emissão é realizada anualmente pelos Gestores de Transporte para fins de avaliação dos gastos.

===== 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 -> Abastecimento -> Consumo Anual de Combustíveis.

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

  * **Estabelecimento:** Tipo AUTOCOMPLETE, formato: NOME FORNECEDOR COMBUSTÍVEL - DOCUMENTO FORNECEDOR, entrada de dados: NOME ou DOCUMENTO.
  * **Motorista:** Tipo AUTOCOMPLETE, formato: NOME MOTORISTA - DOCUMENTO MOTORISTA, entrada de dados: NOME ou DOCUMENTO.
  * **Placa:** Tipo TEXTO, Formato - AAA-9999.
  * **Combustível:** Tipo TEXTO.
  * **Tipo Propriedade:** Tipo TEXTO, Formato - DENOMINAÇÃO. ([[#Principais Regras de Negócio|RN03]])
  * **Tipo Uso:** Tipo Texto, Formato - DENOMINAÇÃO.
  * **Tipo Veículo**: Tipo Texto, Formato - DENOMINAÇÃO.
  * **Status Veículo**: Tipo Texto, Formato - DENOMINAÇÃO.
  * **Unidade:** Tipo AUTOCOMPLETE, formato: DENOMINAÇÃO UNIDADE, entrada de dados: DENOMINAÇÃO.
  * **Ano:** Tipo NUMÉRICO, formato: AAAA.
  * **Período:** Tipo - DATA, formato: DD/MM/AAAA de DD/MM/AAAA.

Então o sistema exibe um relatório tal qual o modelo abaixo ([[#Principais Regras de Negócio|RN01, RN02]]): 

**Relatório de Consumo Anual de Combustível**


**Estabelecimento:** ESTABELECIMENTO

**Motorista**: NOME MOTORISTA

**Placa:** AAA-9999

**Combustível:** NOME COMBUSTÍVEL

**Unidade:** NOME UNIDADE

**Ano:** AAAA

**Período:**  DD/MM/AAAA a DD/MM/AAAA

^  #^  Placa   ^  Jan  ^^  Fev  ^^  Mar  ^^  Abr  ^^  Mai  ^^  Jun  ^^  Jul  ^^  Ago  ^^  Set  ^^  Out  ^^  Nov  ^^  Dez  ^^  Total  ^^
^   ^          ^  Litros^  R$^  Litros^  R$^  Litros^  R$^  Litros^  R$^  Litros^  R$^  Litros^  R$^  Litros^  R$^  Litros^  R$^  Litros^  R$^  Litros^  R$^  Litros^  R$^  Litros^  R$^  Litros^  R$^
|  ... 9|  AAA-9999|  99,99|  99,99|  99,99|  99,99|  99,99|  99,99|  99,99|  99,99|   99,99|  99,99|  99,99|  99,99|   99,99|  99,99|  99,99|  99,99|   99,99|  99,99|  99,99|  99,99|   99,99|  99,99|  99,99|  99,99|   99,99|  99,99| 
|  ... 9|  AAA-9999|  99,99|  99,99|  99,99|  99,99|  99,99|  99,99|  99,99|  99,99|   99,99|  99,99|  99,99|  99,99|   99,99|  99,99|  99,99|  99,99|   99,99|  99,99|  99,99|  99,99|   99,99|  99,99|  99,99|  99,99|   99,99|  99,99| 
|**  TOTAL**||  **99,99**|  **99,99**|  **99,99**|  **99,99**|  **99,99**|  **99,99**|  **99,99**|  **99,99**|  **99,99**|  **99,99**|  **99,99**|  **99,99**|  **99,99**|  **99,99**|  **99,99**|  **99,99**|  **99,99**|  **99,99**|  **99,99**|  **99,99**|  **99,99**|  **99,99**|  **99,99**|  **99,99**|  **99,99**|  **99,99**|

Em seguida um relatório gráfico é exibido retratando os dados descritos acima. 

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

  * **RN01** - Só serão exibidos os filtros utilizados na consulta.
  * **RN02** - Usuário com papel SipacPapeis.GESTOR_TRANSPORTES_UNIDADES só pode ver veículos de sua unidade ou subunidades.
  * **RN03** - Tipo Propriedade não deve ser informado quando placa informada.


==== Resoluções/Legislações Associadas ====

Não se aplica

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

^ Classe ^ Tabela |
| br.ufrn.sipac.transportes.dominio.Veiculo| sipac.transporte.veiculo |
| br.ufrn.sipac.transportes.dominio.Abastecimento| sipac.transporte.abastecimento |

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

Sistema: SIPAC

Módulo: TRANSPORTE

Link(s): Aba de Relatórios -> Abastecimento -> Consumo Anual de Combustíveis.

Usuários: bergue

Papel que usuário deve ter: 

  * SipacPapeis.GESTOR_TRANSPORTES_GLOBAL, 
  * SipacPapeis.GESTOR_TRANSPORTES_UNIDADES, 
  * SipacPapeis.RELATORIOS_TRANSPORTES, 
  * SipacPapeis.GESTOR_TRANSPORTES_ABASTECIMENTO,
  * SipacPapeis.AUDITOR.
===== Cenários de Teste =====
O [[desenvolvimento:especificacoes:sipac:transportes:casos_de_uso:abastecimento:abastecimento:registrar_abastecimento|abastecimento]] deve afetar os valores e quantitativos mostradas neste relatório.

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

Informar um ano qualquer ou utilizar um modelo de veículo comum na instituição ou um número de placa conhecido. Ex:Ford/Corsa ou MYG-6134