~~ODT~~

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

====== Relatório de Consumo de Itens de Manutenção por Veículo ======

Esta funcionalidade é utilizada pelos gestores de transportes globais e de unidades com a finalidade de listar o consumo de um determinado item de manutenção de um veículo em um período de tempo. 

===== 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 -> Gastos -> Consumo de Itens de Manutenção por Veículo.

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


  * **Unidade:** Tipo AUTOCOMPLETE, formato: DENOMINAÇÃO UNIDADE (CÓDIGO), entrada de dados: DENOMINAÇÃO ou CÓDIGO  ([[#Principais Regras de Negócio|RN01]]).
  * **Item de Manutenção:** Tipo AUTOCOMPLETE, formato: DENOMINAÇÃO ITEM, entrada de dados: DENOMINAÇÃO.
  * **Veículo:** Tipo AUTOCOMPLETE, formato: AAA-9999, entrada de dados: PLACA, MODELO ou MARCA DO VEICULO 
  * **Tipo de Item de Manutenção:** Tipo TEXTO, formato: DESCRICAO TIPO DE ITEM, entrada de dados: MATERIAL ou SERVIÇO 
  * **Período:*** Tipo DATA, formato: DD/MM/AAAA até DD/MM/AAAA.

Então o sistema exibe um relatório tal qual o modelo abaixo: 

**Relatório de Consumo de Itens de Manutenção por Veículo**


**Unidade:** DENOMINAÇÃO UNIDADE

**Item de Manutenção**: DENOMINAÇÃO ITEM

**Veículo**: DESCRIÇÃO VEÍCULO

**Tipo de Item de Manutenção**: DESCRIÇÃO TIPO ITEM DE MANUTENCAO

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

^  #^Item  ^Unidade Beneficiada ^ Data da Manutenção ^Preço Unitário ^Qtd. ^Total ^
|  1|DENOMINACAO ITEM |  CODIGO NOME UNIDADE | DD/MM/AAAA | R$ 99,99|  99,9|R$ 99,99|
|  2|DENOMINACAO ITEM |  CODIGO NOME UNIDADE | DD/MM/AAAA | R$ 99,99|  99,9|R$ 99,99|
|  3|DENOMINACAO ITEM |  CODIGO NOME UNIDADE | DD/MM/AAAA | R$ 99,99|  99,9|R$ 99,99|
|  **Total:**|||||  **99.999,9**|  **R$ 999.999,99**|

Ao final do relatório deve ser impresso local e data e ainda espaços para a assinatura do 
encarregado do serviço e do diretor da divisão.


O caso de uso é finalizado.

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

  ***RN01** - Aos gestores de transportes de unidades só estarão disponíveis as unidades às quais pertence e subordinadas.

==== 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.ManutencaoNova| sipac.transporte.manutencao_nova |
| br.ufrn.sipac.transportes.dominio.ManutencaoItemNovo| sipac.transporte.manutencao_item_novo |

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

Sistema: SIPAC

Módulo: TRANSPORTE

Aba de Relatórios -> Gastos -> Consumo de Itens de Manutenção por Veículo

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 =====

A [[desenvolvimento:especificacoes:sipac:transportes:casos_de_uso:operacoes:operacoes:manutencao_nova:cadastrar|manutenção]] deve afetar os valores e quantitativos mostradas neste relatório.

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

Informar um período e unidade qualquer que saiba existir manutenções.

Dados para gerar o relatório:

<code sql>
SELECT u.codigo_unidade, u.nome AS unidade, v.placa, i.denominacao AS item, mn.data
FROM transporte.manutencao_item_novo min 
INNER JOIN transporte.item_manutencao i ON i.id_item_manutencao = min.id_item_manutencao
INNER JOIN transporte.manutencao_nova mn ON mn.id_manutencao = min.id_manutencao 
INNER JOIN transporte.veiculo v ON v.id_veiculo = mn.id_veiculo 
INNER JOIN comum.unidade u ON u.id_unidade = mn.id_unidade_beneficiada
WHERE mn.custeada_instituicao = true
ORDER BY u.codigo_unidade, mn.data
</code>