~~ODT~~


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

====== Acompanhamento da Situação dos Livros Solicitados ======

Essa funcionalidade é utilizada pelo gestor de compras de livros com a finalidade de gerar relatórios para acompanhamento da situação de livros solicitados aos fornecedores, bem como verificar em quais requisições os mesmos se encontram e se caso já estejam tombados informar os termos de responsabilidade. Como pré-condição para o acompanhamento da situação dos livros solicitados, temos 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]].

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

Este caso de uso inicia quando o usuário acessa a opção: Sipac -> Módulo Compras de Materiais Informacionais-> Aba Operações -> Contratos -> Acompanhamento da Situação dos Livros Solicitados.

Ao acessar o caso de uso, apresenta-se ao usuário os seguintes dados que servem como 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 em um relatório, mostrando as seguintes informações sobre os livros encontrados:

**Acompanhamento da Situação dos Livros Solicitados**:
  * **__Periodo__**: Formato - DD/MM/AAAA - DD/MM/AAAA. Tipo DATA.
  * **__Contrato__**: Formato - 9999/AAAA. Tipo NUMÉRICO.
  * **__Status__**: Tipo TEXTO.
  * **__Editora__**: Tipo TEXTO.

^ Título ^ISBN ^  Solicitado ^ Pendente Entrega ^Entregue ^ Esgotado  ^
| **Editora**: Tipo TEXTO.|||||| 
| XXXX |  9999| XXXX |  99|  99|  99|  
| ------ | ------ | ------ | ------  | ------ | ------ |
| ------ | ------ | ------ | ------  | ------ | ------ |
| ------ | ------ | ------ | ------  | ------ | ------ |
| |**TOTAL**: Tipo NUMÉRICO.|  99|  99|  99|  99|
| |**TOTAL GERAL**: Tipo NUMÉRICO.|  99|  99|  99|  99|
|  **TOTAL EDITORAS**: Tipo NUMÉRICO.  ||||||

Ainda existem duas opções disponíveis:

  * //Visualizar Requisições//
  * //Visualizar Termos de Responsabilidade//([[#principais_regras_de_negócio |RN01]]) : Serão listados todos os termos de responsabilidade onde este livro está presente.
=== Fluxo Alternativo 1 :  Visualizar Requisições ===
Nesta opção serão listadas todas as requisições em que este livro foi solicitado.

Primeiramente, serão exibidos os dados do livro com as seguintes informações:  
  * **__Título__**: Tipo Texto.
  * **__Autor__**: Tipo Texto.
  * **__ISBN__**: Tipo TEXTO.
  * **__Editora__**: Tipo TEXTO.

Também é exibida uma lista de requisições que contém o livro selecionado. Com as seguintes informações:
  * **__Requisição__**: Formato - 9999/AAAA . Tipo NUMÉRICO.
  * **__Contrato__**: Formato - 9999/AAAA. Tipo NUMÉRICO.
  * **__Lote__**: Tipo TEXTO.
  * **__Fonte Orçamentária__**: Tipo TEXTO.
  * **__Status__**: Tipo TEXTO.

=== Fluxo Alternativo 2 : Visualizar Termos de Responsabilidade ===

Nesta opção serão listados todos os termos de responsabilidade em que este livro foi tombado.
 	   	 
Primeiramente, irá aparecer uma lista de termos de responsabilidades em que o livro selecionado foi tombado, com as seguintes informações:
  * **__Número/Ano__**: Formato - 9999/AAAA . Tipo NUMÉRICO.
  * **__Data__**: Formato - DD/MM/AAAA. Tipo DATA.
  * **__Unidade Responsável__**: Formato CÓDIGO DA UNIDADE - NOME DA UNIDADE Tipo TEXTO - NUMÉRICO.
  * **__Tipo__**: Tipo TEXTO.

O caso de uso se encerra.

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

  * **RN01** - Só ira exibir os termos de responsabilidade associados ao livro, caso a quantidade entregue seja maior que um. Contudo, isso não garante que o item foi tombado.

==== 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: Compras de Materiais Informacionais

Link(s): Aba Operações -> Contratos -> Acompanhamento da Situação 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]].