~~ODT~~


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

====== Acompanhamento dos Livros Solicitados ======

Essa funcionalidade pode ser utilizada pelos gestores de compra de livros com a finalidade de gerar relatórios para acompanhamento da situação dos livros solicitados às editoras contratadas.

Pré-condições:

  * [[desenvolvimento:especificacoes:sipac:compra_de_materiais_informacionais:casos_de_uso:operacoes:requisicoes_de_materiais_informacionais_do_contrato:cadastrar_requisicao|Cadastrar Requisição de Livros]].

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

Este caso de uso é iniciado quando o usuário acessa a opção no caminho: SIPAC -> Compra de Materiais Informacionais -> Aba Operações -> Contratos -> Acompanhamento dos Livros Solicitados.

Ao acessar o caso de uso, apresenta-se ao usuário os seguintes filtros para a geração do relatório:

  * **Período da Solicitação***: Formato - DD/MM/AAAA à DD/MM/AAAA. Tipo DATA. É o período do cadastro de uma requisição de livros para o fornecedor.
  * **Contrato**: Formato - 9999/AAAA. Tipo NUMÉRICO. É o contrato referente a requisição de um livro.
  * **Status**: Tipo TEXTO. É o status dos livros solicitados. Pode ser: ''CADASTRADO'', ''AGUARDANDO ATENDIMENTO'', ''INDISPONÍVEL'', ''ESGOTADO'', entre outros.
  * **Editora**: Tipo TEXTO. Denominação da Editora.

Ao realizar a busca, serão listados os livros de acordo com os dados informados na busca, mostrando um relatório com as seguintes informações sobre os livros encontrados:

**ACOMPANHAMENTO DOS LIVROS SOLICITADOS**:
  * **__Periodo__**: Formato - DD/MM/AAAA - DD/MM/AAAA. Tipo DATA.
  * **__Contrato__**: Formato - 9999/AAAA. Tipo NUMÉRICO. Essa informação é mostrada caso a consulta seja feita pelo filtro de **Contrato**.
  * **__Status__**: Tipo TEXTO. Essa informação é mostrada caso a consulta seja feita pelo filtro de **Status**.
  * **__Editora__**: Tipo TEXTO. Essa informação é mostrada caso a consulta seja feita pelo filtro de **Editora**.

^ ISBN ^ Título ^ Editora ^ Status ^ Quant. Solicitada ^
| **Contrato**: Formato - 9999/AAAA. Tipo NUMÉRICO.|||||
|  9999| XXXX | XXXX | XXXX |  99|
|  ------ | ------ | ------ | ------  |  ------ |
|  ------ | ------ | ------ | ------  |  ------ |
|  ------ | ------ | ------ | ------  |  ------ |
|  **Total por editora**: Tipo Numérico.||||| 
|  **Total por Contrato**: Tipo Numérico.|||||
| **Justificativa Negação**: Tipo TEXTO. Campo mostrado de acordo com a ([[#principais_regras_de_negócio|RN01]]).|||||
|  **Total Geral**: Tipo Numérico.|||||

Com isto, o caso de uso é finalizado.

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

  * **RN01** - As informações da Justificativa do Status são mostradas, somente, para os livros que estão em situação de Indisponível ou Esgotado.

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

Não se aplica.

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


^ Classe ^ Tabela |
| br.ufrn.sipac.requisicoes.livrocontrato.dominio.ItemLivroContrato | administrativo.requisicoes.item_livro_contrato |
| br.ufrn.sipac.requisicoes.livrocontrato.dominio.Livro | administrativo.requisicoes.livro |
| br.ufrn.sipac.requisicoes.livrocontrato.dominio.RequisicaoLivroContrato | administrativo.requisicoes.requisicao_livro_contrato |
| br.ufrn.sipac.contratos.dominio.Contrato | administrativo.contratos.contrato |

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

Sistema: SIPAC.

Módulo: Compra de Materiais Informacionais.

Link(s): Aba Operações -> Contratos -> Acompanhamento dos Livros Solicitados.

Usuário: san.

Papel que usuário deve ter: SipacPapeis.GESTOR_COMPRA_MATERIAIS_INFORMACIONAIS.

===== Cenários de Teste =====

Verificar se o fluxo do caso de uso está funcionando corretamente e se consegue obter os relatórios dos livros pesquisados.


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

Para obter os contratos de requisições de livros solicitados a fim de utilizá-los na busca, use esta consulta:
  SELECT contrato.numero, contrato.ano FROM contratos.contrato JOIN requisicoes.requisicao_livro_contrato ON requisicao_livro_contrato.id_contrato = contrato.id;

E para solicitar mais livros, pode-se utilizar o seguinte caso de uso: [[desenvolvimento:especificacoes:sipac:compra_de_materiais_informacionais:casos_de_uso:operacoes:requisicoes_de_materiais_informacionais_do_contrato:cadastrar_requisicao|Cadastrar Requisição de Livros]].