~~ODT~~

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


====== Relatório de Comparativo de Consumo de Combustível ======

Relatório do Módulo de Transportes que tem por objetivo permitir a comparação do consumo dos veículos em relação ao seu consumo médio informado pelo fabricante. Sua emissão é realizada a qualquer tempo pelos Gestores de Transporte para fins de identificar inconsistências.

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

Este caso de uso inicia quando o usuário acessa a opção: //SIPAC -> Módulo Transportes -> Aba de Relatórios -> Abastecimento -> Comparativo de Consumo de Combustível//.

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

  * **Unidade:** Tipo AUTOCOMPLETE, formato: DENOMINAÇÃO UNIDADE (CÓDIGO DA UNIDADE), entrada de dados: DENOMINAÇÃO ou CÓDIGO.
    * **Incluir sub-unidades:** Tipo LÓGICO.
  * **Tipo de Identificação:** Tipo TEXTO.
  * **Tipo de Uso:** Tipo TEXTO.
  * **Categoria:** Tipo TEXTO.
  * **Tipo Propriedade:** Tipo TEXTO.
  * **Marca:** Tipo TEXTO.
  * **Modelo:** Tipo TEXTO.
  * **Período:*** Tipo DATA, formato: DD/MM/AAAA a 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 Comparativo de Consumo de Combustível**


**Marca:** XXXXXXXXXXXXXXXX

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

^                                                                                                                   # ^  Placa     ^ Marca     ^ Modelo   ^ Tipo Propriedade  ^ Ano Mod.  ^   CMM ^  Deslocamento(km) ^  Abastecimento(litros) ^  Consumo(Km/l) ^ Análise ([[#Principais Regras de Negócio|RN03]])  ^
|                                                                                                                  99 |  AAA-9999  | XXXXXXXX  | XXXXXXX  | XXXXXXX           |      9999 |  99,9 |              99,9 |                   99,9 |           99,9 | XXXXXXXX                                          |
|                                                                                                                  99 |  AAA-9999  | XXXXXXXX  | XXXXXXX  | XXXXXXX           |      9999 |  99,9 |              99,9 |                   99,9 |           99,9 | XXXXXXXX                                          |
|                                                                                                                                                                                   Total:|||||||     99999,9|   99999999,9|   999999,9|                                                   |
| Consumo médio: 99,9 (Km/l)                                                                                                                                                                                                                                                                              |||||||||||
| Desvio Padrão: 99,9 (Km/l)                                                                                                                                                                                                                                                                              |||||||||||
| CMM:Consumo médio do modelo informada pelo fabricante em Km/l (média dos menores consumos por tipo de combustível)                                                                                                                                                                                      |||||||||||

O **Consumo médio** é a soma de todos os "Consumo(Km/l)" dividido pela quantidade de veículos;

O **Desvio Padrão** é obtido pelos valores de "Consumo(Km/l)" de cada veículo.

O sistema também exibe um gráfico de representando 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** - A análise deve serguir a seguinte fórmula:
    * Consumo > CMM+Desvio padrão -> ACIMA DO NORMAL
    * Consumo < CMM-Desvio padrão -> ABAIXO DO NORMAL
    * Se não é ACIMA OU ABAIXO DO NORMAL então é considerado NORMAL


==== 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 → Comparativo de Consumo de Combustível

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]] e a [[desenvolvimento:especificacoes:sipac:transportes:casos_de_uso:frota:frota:veiculo:listar_alterar|alteração de dados do veículo]] deve afetar os dados mostrados neste relatório.

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

Informar um período qualquer e a partir do resultado obtido alterar as opções de filtragem de forma a restringir cada vez mais os dados.