~~ODT~~

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

====== Oferta e Demanda de Materiais em Estoque ======

Esse caso de uso é utilizado pelos gestores de almoxarifado com a finalidade de criar um relatório contendo todas as ofertas e demandas de um determinado material num período de tempo.

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

O caso de uso é acionado quando o usuário acessa a opção: SIPAC -> Módulo Almoxarifado -> Aba Relatórios -> Movimentação -> Oferta e Demanda de Materiais em Estoque.

O sistema inicia solicitando inicialmente que sejam fornecidos os dados:

  * **Almoxarifado***: Tipo TEXTO ([[#pRINCIPAIS REGRAS DE NEGÓCIO|RN01]]).
  * **Grupo de Material***: Tipo TEXTO, formato: CÓDIGO GRUPO MATERIAL - NOME GRUPO MATERIAL. ([[#principais_regras_de_negocio|RN04]])
  * **Ano***: Tipo NUMÉRICO, formato: AAAA.
  * **Liquidação**: Tipo TEXTO, formato: SIGLA TIPO LICITAÇÃO / 9... / AAAA.
  * **Exibir Somente os materiais ativos**: Tipo LÓGICO.
  * **Exibir somente os materiais com valores diferente de zero**: Tipo LÓGICO.
  * **Exibir a especificação do material**: Tipo LÓGICO.
  * **Ordenar por pregão**: Tipo LÓGICO.

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

**Relatório da Oferta e Demanda de Materiais em Estoque**

**Ano:** AAAA

**Almoxarifado:** NOME ALMOXARIFADO

**Grupo Material:** 	CÓDIGO - GRUPO MATERIAL ([[#principais_regras_de_negocio|RN04]])

^ Material ^ Última Compra ^  Prazo Ressuprimento em dias ^  Prazo para Pedido Compra ^ Unidade ^  Estoque Mínino ^  Saldo Atual ^  Consumo AAAA ^  Méd./Mês AAAA ([[#pRINCIPAIS REGRAS DE NEGÓCIO|RN02]]) ^  Aut./Mês AAAA ^  Consumo (AAAA anterior) ^  Méd./Mês (AAAA anterior) ([[#pRINCIPAIS REGRAS DE NEGÓCIO|RN02]])^ Méd. Últ. ''M'' Meses ^ 
| 999999999999\\ DENOMINAÇÃO MATERIAL\\ Especificação:XXXXXX | SIGLA LICITAÇÃO 9.../AAAA - Unidade Gestora |  9999 |  99.99 |  99.99 |  99.99 |  99.99 |  99.99 |  99.99 |  99.99 |  99.99 |  99.99 |  99.99 |

Materiais que atingiram autonomia mínima ([[#pRINCIPAIS REGRAS DE NEGÓCIO|RN03]])

**Quantidade de itens retornados:** 99
 

O Caso de uso é finalizado.


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

  * **RN01** - O sistema apenas disponibiliza os almoxarifados aos quais o usuário é associado. 
  * **RN02** - O tempo de análise será parametrizado através do parâmetro QUANT_MESES_REL_OFERTA_DEMANTA_MATERIAIS, que define o tempo de meses considerados na média.
  * **RN03** - Deverão ser listados em vermelho aqueles materiais que tenham atingido a autonomia mínima, facilitando assim a visualização dos que necessitam reposição. 
  ***RN04** - A terminologia Grupo de Material pode ser ajustada para Elemento de Despesa Detalhado, ver [[desenvolvimento:especificacoes:sipac:patrimonio:ajuste_de_parametros#altera%C3%A7%C3%B5es_no_arquivo_terminologias.properties_ufrn|Terminologias]].

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

^ Classe ^ Tabela |
| br.ufrn.sipac.almoxarifado.comuns.dominio.Almoxarifado | administrativo.almoxarifado.almoxarifado |
| br.ufrn.sipac.almoxarifado.saidas.dominio.AtendimentoReqMaterial | administrativo.almoxarifado.atendimento_req_material |
| br.ufrn.sipac.almoxarifado.comuns.dominio.MovimentacaoEstoque | administrativo.almoxarifado.movimentacao_estoque |
| br.ufrn.sipac.compras.dominio.ItemProcessoCompra | administrativo.compras.item_processo_compra |
| br.ufrn.sipac.compras.dominio.ProcessoCompra | administrativo.compras.processo_compra |
| br.ufrn.sipac.requisicoes.material.dominio.Material | administrativo.public.material |
| br.ufrn.sipac.requisicoes.material.dominio.GrupoMaterial | administrativo.public.grupo_material |

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

Sistema: SIPAC

Módulo: ALMOXARIFADO

Link(s): Almoxarifado -> Aba de Relatórios -> Movimentação -> Oferta e Demanda de materiais em estoque

Usuários: 
  * genibaldo (Almoxarife do almoxarifado central.)
  * ery (ALMOXARIFADO - CCSA)

Papel que usuário deve ter:
    *SipacPapeis.GESTOR_ALMOXARIFADO; ou
    *SipacPapeis.AUDITOR_ALMOXARIFADO.

===== Cenários de Teste =====
O atendimento de requisição de material deve afetar as quantidades mostradas neste relatório.  Dessa forma, pode-se anotar a quantidade movimentada no ano corrente de determinado material, criar uma requisição deste material e atende-la.  As seguintes colunas do relatório deverão ser afetadas: 

  * Saldo Atual - deve ter a quantidade diminuida
  * Consumo <ano> - deve ter sua quantidade aumentada
  * Média de consumo do mês <ano> - pode ter sua quantidade aumentada
  * Autonomia Mês <ano> - pode ter sua quantidade diminuída

Pode-se atender requisições através do caso de uso **//SIPAC -> Almoxarifado -> Requisições -> Atendimento de Requisições -> Atendimento de Requisições //**

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

Escolher o Almoxarifado (sugestao: ALMOXARIFADO CENTRAL) ;
Escolher o Grupo de Material (sugiro 3017 - MATERIAL DE PROCESSAMENTO DE DADOS);
Informar o ano;

Gere o relatório e anote alguma das "Ultimas Compras" listadas e utilize-as para testes de filtragem por "Liquidação".

*As sugestões são para o usuário genibaldo