~~ODT~~

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

====== Histórico de Compras do Material/Serviço ======

Este caso de uso permite aos funcionários do setor de compras e de licitação emitir um relatório para o acompanhamento do histórico de compras de um determinado material ou serviço. 


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

Este caso de uso inicia quando o usuário acessa a opção: //SIPAC -> Módulo Compras/Licitação -> Aba Relatórios -> Gerenciais → Histórico de Compra do Material/Serviço//.

Ao acessar o caso de uso o sistema apresenta os filtros:

  ***Código**: Tipo NUMÉRICO.
  ***Unidade Gestora**: Tipo TEXTO, formato: DENOMINAÇÃO GESTORA (CÓDIGO).
  ***Fornecedor**: Tipo AUTOCOMPLETE, formato: DENOMINAÇÃO FORNECEDOR, entrada de dados: DENOMINAÇÃO.
  ***Por Período**: Tipo DATA, formato: De DD/MM/AAAA Até DD/MM/AAAA.
  ***Período Integral**: Tipo LÓGICO.
  ***Exibir Gráfico**: Tipo LÓGICO.
  ***Especificação**: Tipo LÓGICO.
  ***Ocorrências do Material**: Tipo LÓGICO. ([[historico_de_compra_do_material_servico#Principais Regras de Negócio|RN01]])

O sistema exibe o relatório no seguinte formato:


**Histórico de Compra de um Material/Serviço**

**Material/serviço:** CÓDIGO - DENOMINAÇÃO MATERIAL - UNIDADE DE MEDIDA

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

^  HISTÓRICO DO MATERIAL/SERVIÇO  ^^^^^^^^
|Data |	Licitação | Unidade Gestora | Ganhador | Marca | Estimado | Licitado | Difer.* | 
| DD/MM/AAAA | SIGLA LICITAÇÃO - 9.../AAAA | CÓDIGO - DENOMINAÇÃO UNIDADE | DOCUMENTO - DENOMINAÇÃO GANHADOR | DENOMINAÇÃO MARCA | R$ 99,99 |R$ 99,99 | R$ 99,99 |
| Difer.* = (Valor Estimado - Valor Ganho da Licitação) ||||||||

^ OCORRÊNCIAS                                                     ^^^^
^ Data              ^ Usuário      ^ Unidade            ^ Descrição  ^
| DD/MM/AAAA HH:MM  | Denominação  | Denominação Unid.  | Descrição  |


^ PROCESSOS ^^^^^ 
^ Processo ^ Licitação ^ Status ^ Unid. Gestora ^ Data Cadastro ^ 
| 9.../AAAA | SIGLA - 9.../AAAA | STATUS | CÓDIGO - SIGLA UNIDADE GESTORA | DD/MM/AAAA |

É EXIBIDO UM RELATÓRIO GRÁFICO ILUSTRANDO OS DADOS DA TABELA 'HISTÓRICO DO MATERIAL/SERVIÇO'.

Então o caso de uso é finalizado. 

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

  * **RN01** - A quantidade de ocorrências que podem ser visualizadas é indicada no parâmetro **//QUANTIDADE_MAXIMA_EXIBICAO_OCORRENCIAS//**.
==== Resoluções/Legislações Associadas ====
  
Não se aplica. 

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

^ Classe                                                         ^ Tabela                                     ^
| br.ufrn.sipac.compras.dominio.ItemProcessoCompra               | adminitrativo.compras.item_processo_compra |
| br.ufrn.sipac.compras.dominio.ProcessoCompra                   | adminitrativo.compras.processo_compra      |
| br.ufrn.sipac.requisicoes.material.dominio.ModificacaoMaterial | administrativo.comum.modificacao_material |
| br.ufrn.sipac.requisicoes.materiaL.dominio.SolicitaAtualizacaoPrecoMat  |administrativo.comum.solicitacao_atualiza_preco_material                                          |

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

Sistema: SIPAC

Módulo: Compras/Licitação

Link(s): Aba de Relatórios -> Gerenciais -> Histórico de Compra do Material/Serviço

Usuários: nnaa

Papel que usuário deve ter: SipacPapeis.GESTOR_LICITACAO ou SipacPapeis.GESTOR_COMPRA ou SipacPapeis.GESTOR_RELATÓRIO_COMPRA.

===== Cenários de Teste ===== 
Não se aplica.
===== Dados para o Teste ===== 
Para alterar o parâmetro da **RN01** podemos usar:
<code sql>
UPDATE comum.parametro SET valor = <QUANTIDADE> WHERE nome = 'QUANTIDADE_MAXIMA_EXIBICAO_OCORRENCIAS'
</code>