~~ODT~~

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

====== Empréstimos por Turno ======

Esse caso de uso é usado pelos bibliotecários para verificarem a quantidade de empréstimos realizados por turno.

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

O caso de uso se inicia quando o usuário acessa //SIGAA -> Módulo Biblioteca -> Relatórios -> Circulação -> Empréstimos -> Empréstimos Quantitativo por Turno //.

Nesse momento, são mostrados os seguintes filtros:
  * **Bibliotecas**: Tipo - TEXTO.
  * **Período (início e fim)***: Tipo - DATA. Formato - DD/MM/AAAA a DD/MM/AAAA
  * **Turno***: Tipo - TEXTO. Pode ser ''Todos'', ''Manha'', ''Tarde'' ou ''Noite''

Após escolher a opção //Gerar Relatório//, o relatório no modelo abaixo é mostrado para o usuário:

**Relatório Quantitativo de Empréstimos por Turno**

**Bibliotecas**: Texto\\ 
**Período**: DD/MM/AAAA até DD/MM/AAAA\\
**Turno**: TEXTO\\

^ Turno ^ Quantidade ^
| **Biblioteca 1**  |       |
| MANHÃ | 213  |
| TARDE | 42213  |
| NOITE | 2  |
| **Biblioteca 2**  |         |
| MANHÃ | 457  |
| TARDE | 742213  |
| NOITE | 1 |
| **TOTAIS** |   |
| MANHÃ | 670  |
| TARDE | 784426|
| NOITE | 3  |
| **TOTAL GERAL** | **785099 ** |

O caso de uso é finalizado.

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

  * **RN01**: A quantidade de empréstimos mostrada é a quantidade de **empréstimos** **+** a quantidade de ** renovações presenciais **

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

Não se aplica.

<ifauth @admin>
===== Classes Persistentes e Tabelas Envolvidas =====

^ Classe ^ Tabela |
| br.ufrn.sigaa.biblioteca.circulacao.domino.**ProrrogacaoEmprestimo** | sigaa.biblioteca.prorrogacao_emprestimo |
| br.ufrn.sigaa.biblioteca.circulacao.domino.**Emprestimo** | sigaa.biblioteca.emprestimo |
| br.ufrn.sigaa.biblioteca.circulacao.domino.**Biblioteca** | sigaa.biblioteca.biblioteca |
| br.ufrn.sigaa.biblioteca.circulacao.domino.**MaterialInformacional** | sigaa.biblioteca.material_informacional |
| br.ufrn.arq.domino.**RegistroEntrada** | sigaa.comum.registro_entrada |

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

Sistema: SIGAA

Módulo: Biblioteca

Link(s): SIGAA -> Módulo Biblioteca -> Relatórios -> Circulação -> Empréstimos ->  Empréstimos Quantitativo por Turno

Usuário: sleite, edila, margareth

Papel que usuário deve ter: SigaaPapeis.BIBLIOTECA_SETOR_CONTOLE_ESTATISTICO 


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

  * Testar com várias datas, turno e bibliotecas diferentes.
  * Verificar se a soma dos números correspondem
  * Verificar se após fazer um novo empréstims ou renovação o número aumenta dentro do período realizado.
  * Logicamente, verificar se após fazer um novo empréstimo ou renovação o número **Não** aumenta fora do período realizado.


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

[[desenvolvimento:especificacoes:sigaa:biblioteca:casos_de_uso:circulacao:modulo_de_circulacao:realizar_emprestimo | Realizar Empréstimos ]] 
\\
\\
[[desenvolvimento:especificacoes:sigaa:biblioteca:casos_de_uso:circulacao:modulo_de_circulacao:renovar_emprestimo | Renovar Material ]] 
\\
\\
[[desenvolvimento:especificacoes:sigaa:biblioteca:casos_de_uso:circulacao:modulo_de_circulacao:devolver_emprestimo | Devolver Material ]] 
\\
\\

A consulta abaixo é um exemplo da consulta realizada pelo relatório:

<code sql>
SELECT 
   b.descricao as biblioteca, 
   e.data_emprestimo as data_cadastro
FROM biblioteca.emprestimo e 
   INNER JOIN biblioteca.material_informacional mi ON (e.id_material = mi.id_material_informacional) 
   INNER JOIN biblioteca.biblioteca b ON (mi.id_biblioteca = b.id_biblioteca) 
WHERE e.ativo = trueValue() 
   -- Os filtros a seguir variam de acordo com a escolha do usuário
   AND mi.id_biblioteca IN (661399) 
   AND e.data_emprestimo >= '13/06/2010' 
   AND e.data_emprestimo <= '16/06/2011' 

UNION ALL 

SELECT 
   b.descricao as biblioteca, 
   pe.data_cadastro as data_cadastro
FROM biblioteca.prorrogacao_emprestimo pe 
   INNER JOIN biblioteca.emprestimo e ON (e.id_emprestimo = pe.id_emprestimo) 
   INNER JOIN comum.registro_entrada re ON (re.id_entrada = pe.id_registro_cadastro) 
   INNER JOIN biblioteca.material_informacional mi ON (e.id_material = mi.id_material_informacional) 
   INNER JOIN biblioteca.biblioteca b ON (mi.id_biblioteca = b.id_biblioteca) 
WHERE pe.ativo = trueValue() 
   AND pe.tipo = 5 
   AND e.ativo = trueValue() 
   AND re.canal = 'D' 
   -- Os filtros a seguir variam de acordo com a escolha do usuário
   AND mi.id_biblioteca IN (661399) 
   AND pe.data_cadastro >= '13/06/2010' 
   AND pe.data_cadastro <= '16/06/2011'
</code>

</ifauth>