~~ODT~~


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


====== Gerenciar Suspensões ======


Permite aos bibliotecários realizar operações sobre as suspensões geradas para os usuários da biblioteca.

Esse caso de uso estão envolvidos os bibliotecários do setor de circulação.

Pré-condições:  Um empréstimo deve ter sido devolvido com atraso e a variabilidade de suspensão deve está ativa (o parâmetro SISTEMA_TRABALHA_COM_SUSPENSAO deve possuir o valor 'true' ).

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

Este caso de uso inicia quando o usuário acessa a opção:  **//SIGAA -> Biblioteca -> Circulação -> Gerenciar Suspensões //**

Entrando na opção, o usuário é redirecionado para a [[desenvolvimento:especificacoes:sigaa:biblioteca:casos_de_uso:circulacao:busca_padrao_usuarios_biblioteca | busca padrão dos usuários da biblioteca ]].

Ao selecionar o usuário da biblioteca, o operador é redirecionado para um página que lista as suspensões ativas do usuário. São apresentados os seguintes dados do usuário:
  * **__Matrícula__**: Tipo - NUMÉRICO
  * **__Nome__**: Tipo - TEXTO
  * **__Categoria do Usuário__**: Tipo - TEXTO
  * **__Curso__**: Tipo - TEXTO
  * **__Centro__**: Tipo - TEXTO
  * **__Email__**: Tipo - TEXTO

Para cada suspensão são apresentados as seguintes informações:

  * **__Início__**: O início da suspensão. Tipo - Data.
  * **__Fim__**: O fim do período de suspensão. Tipo - Data.  

Para **suspensões automáticas** geradas a partir de devoluções atrasadas dos materiais são mostradas as seguintes informações:

  * **__Material do empréstimo:: __**: O material do empréstimo que gerou a suspensão. Tipo - TEXTO.  
  * **__Data do empréstimo__**: A data em que o empréstimo foi feito. Tipo - DATA. Formato - dd/MM/yyyy  
  * **__Prazo__**: O prazo do empréstimo. Tipo - TEXTO.  Formato - dd/MM/yyyy  HH:mm
  * **__Data da devolução__**: A data em que o material foi devolvido. Tipo - TEXTO. Formato - dd/MM/yyyy  HH:mm

Para as **suspensões manuais** são mostradas as seguintes informações:

  * **__Usuário que cadastrou a suspensão: __**: O usuário que cadastrou a suspensão no sistema. Tipo - TEXTO.  
  * **__Data do Cadastro__**: A data de cadastro da suspensão. Tipo - TEXTO.  
  * **__Motivo do Cadastro__**: O motivo do cadastro na suspensão manual. Tipo - TEXTO. 

\\
\\
\\
As suspensões são geradas automaticamente quando o usuário  [[desenvolvimento:especificacoes:sigaa:biblioteca:casos_de_uso:circulacao:modulo_de_circulacao:devolver_emprestimo | devolve um empréstimo ]] em atraso e o parâmetro SISTEMA_TRABALHA_COM_SUSPENSAO está ativado.

\\
\\
\\
**OBSERVAÇÃO.:** A verificação dos parâmetros da biblioteca pode ser realizada em: [[desenvolvimento:especificacoes:sigaa:biblioteca:casos_de_uso:cadastros:configuracoes_do_sistema:configuracoes_de_circulacao | Biblioteca -> Cadastro -> Configurações do Sistema  -> Configurações de Circulação ]].

\\
\\
\\



Caso o usuário possua suspensões cadastradas é mostrada 2 operações a serem realizadas sobre as suspensão: 

  * **Cadastrar Nova Suspensão**: Cadastra uma nova suspensão manualmente para o usuário.
  * **Estornar Suspensão **: Estorna a suspensões do usuário (utilizando quando a suspensão não foi gerada por culpa do usuário).


===== Cadastrar Nova Suspensão =====
Essa operação permite ao operador cadastrar uma nova suspensão manual para o usuário selecionado na pesquisa.
Para cadastrar uma suspensão manual o operador deve informar os seguintes dados:
   * **Data Final***: A data em que a suspensão acaba. Tipo - NMÉRICO.
   * **Motivo da criação da suspensão***: Tipo - TEXTO.


     No cadastro de suspensões manuais o sistema disponibiliza uma "calculadora" 
     para o usuário realizar o calculo dos dias da suspensão que precisa ser 
     aplicada ao usuário.
     Para isso ele fornece os seguintes dados: Prazo para Devolução, a Data da      
     Devolução, Tipo do Prazo e a Quantidade de Empréstimos
     O sistema calcula: Quantidade de Dias em Atraso, Quantidade de Dias Suspenso e a Data fim da suspensão. 



===== Estorna uma Suspensão =====

  * Por último pode-se **estorna uma suspensão** indevida. Selecionado as suspensões ativas mostrada ao se selecionar um usuário no início do caso de uso.
    * **Motivo***: O motivo do estorno. Tipo - TEXTO
    * **Senha***: A senha do operador. Tipo - TEXTO

\\
\\

O caso de uso é finalizado.

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

   * **RN01** - Apenas usuários com o papel de BIBLIOTECA_SETOR_CIRCULACAO_BIBLIOTECARIO e BIBLIOTECA_ADMNISTRADOR_GERAL podem estornar ou criar suspensões manualmente.
   * **RN02** - No caso do estorno da suspensão, o motivo do estorno deve ser informado.
   * **RN03** - No caso da criação de uma suspensão, o motivo e uma data maior hoje ou maior que a data de termino da últma suspensão devem ser informados.
   * **RN04** - O valor da suspensão é calculado com a seguinte formula:** // quantidade de dias em atraso * valor da suspensão por dia de atraso //**  para empréstimos cujo prazo é contado por dia.  Para empréstimos por hora, se atrasou menos de 24 horas = **//valor da suspensão por hora de atraso//**, se atrasou mais de 24 horas = ** //valor da suspensão por hora de atraso//** + (  **// quantidade de dias em atraso** * **valor da suspensão por dia de atraso //**  ). O valor da suspensão por dia de atraso e o valor da suspensão por hora de atraso podem ter seus valores encontrados no link:  Biblioteca -> Cadastro -> parâmetros gerais da biblioteca, nos parâmetros: VALOR_SUSPENSAO_USUARIO_ATRASO_POR_DIA e VALOR_SUSPENSAO_USUARIO_ATRASO_POR_HORA respectivamente.

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

Não se Aplica.  

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

^ Classe ^ Tabela |
| ufrn.sigaa.biblioteca.circulacao.dominio.SuspensaoUsuariobiblioteca|  sigaa.biblioteca.suspensao_usuario_biblioteca |


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

Sistema: SIGAA

Módulo: BIBLIOTECA

Link(s): 
SIGAA -> Biblioteca -> Circulação -> Gerenciar de Suspensões

Usuário: margareth (Administradora geral biblioteca), kallinebezerra (Bibliotecária de circulação), arletemoura (usuário comum de circulação)

Papel que usuário deve ter: 

  * Para criar e estornas suspensões: SigaaPapeis.BIBLIOTECA_ADMINISTRADOR_GERAL, SigaaPapeis.BIBLIOTECA_SETOR_CIRCULACAO_BIBLIOTECARIO.


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

Verifique se após devolver um empréstimos atrasado uma suspensão é gerada com o valor correto (**RN04**)..

Ative e desative os parâmetros: SISTEMA_TRABALHA_COM_MULTA e SISTEMA_TRABALHA_COM_SUSPENSAO. A multa e suspensão só devem ser gerados caso o respectivo parâmetro esteja ativado. Caso nenhum dos dois esteja ativo o usuário não recebe qualquer punição. Caso os dois estejam ativos e usuário fica multado e suspenso.



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

Para realizar empréstimos utilize o caso de uso: [[ desenvolvimento:especificacoes:sigaa:biblioteca:casos_de_uso:circulacao:modulo_de_circulacao:realizar_emprestimo | Sigaa -> Biblioteca -> Circulação -> Modulo de Circulação -> Realizar empréstimos ]]

Para verificar as multas no banco utilizar o sql : 
<code sql> 
select * from biblioteca.suspensao_usuario_biblioteca
</code>

</ifauth>