====== Gerenciar Solicitações de Levantamento Bibliográfico ======

Qualquer discente ou servidor pode solicitar levantamento bibliográfico, indicando para isto o tema ou área que deve ser realizado o levantamento. O bibliotecário irá realizar o levantamento e postar as fontes encontradas na forma de texto no SIGAA. Ao postar os resultados, o usuário solicitante é notificado via e-mail e pode acessar o resultado no sistema.

Os servidores podem solicitar levantamento bibliográfico de infra-estrutura, indicando para isto a biblioteca e opcionalmente o setor da biblioteca que deseja que seja realizado o levantamento bibliográfico de infra-estrutura.

Antes de realizar este caso de uso é necessário que primeiro tenha sido realizada uma solicitação de levantamento bibliográfico por um discente ou um funcionário (veja a seção Dados para Teste).

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

Somente as bibliotecas que oferecem o serviço de Levantamento Bibliográfico podem receber este tipo de solicitação.

O funcionário da biblioteca busca por solicitações através dos filtros:
  * **Biblioteca**. Para restringir as solicitações a uma dada biblioteca. Esse campo pode ficar sem ser preenchido.
  * **Situação**. ''Não finalizadas, Todas, Aguardando validação, Validada ou Finalizada''.
  * **Infra-estrutura**. ''Sim, não ou ambos''.

Encontrando uma solicitação em aberto, ele pode escolher uma das opções: //Visualizar/Finalizar Solicitação//, //Validar Solicitação//, //Enviar Para Outra Biblioteca//

=== Fluxo Alternativo 1 : Visualizar / Finalizar ===
O sistema exibe os dados informados pelo usuário no caso de uso [[desenvolvimento:especificacoes:sigaa:portal_do_discente:casos_de_uso:biblioteca:solicitacoes_de_levantamento_bibliografico|Solicitações de Levantamento Bibliográfico]].
Após a pesquisa, o funcionário informa:
  * **Fontes Pesquisadas** (//Informação Obrigatória//)
  * **Observações**
  * **Arquivo**
  * **Finalizar Pesquisa e Enviar Email para o Solicitante**. Pode ser ''SIM ou NÃO''. Caso seja escolhida esta opção, a pesquisa é finalizada e um email é enviado para o usuário.

== Modelo do email de notificação de atendimento de solicitação ==
  Assunto: [SIGAA - Biblioteca] Pesquisa bibliográfica finalizada
  Texto:
  Sua solicitação de Levantamento Bibliográfico foi finalizada. Você pode verificá-la através do SIGAA, acessando o link da Biblioteca.
  
  Atenciosamente,
  Setor de Informação e Referência.

=== Fluxo Alternativo 2 : Validação de solicitações de infra-estrutura ===

Uma solicitação de levantamento de infra-estrutura inicializa com o status **Aguardando Validação** e pode ser validada pelo funcionário clicando na opção //Validar Solicitação//. Após esse passo, a solicitação passa a ter o status **Validada** e pode ser atendida.


=== Fluxo Alternativo 3 : Transferência de Solicitações ===

Caso uma biblioteca não possa atender à solicitação por algum motivo, poderá enviá-la a outra biblioteca. O funcionário então escolhe a opção //Enviar para outra biblioteca//, escolhe a outra biblioteca e confirma a transferência.

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

  - Uma biblioteca só pode receber solicitações de levantamento bibliográfico se estiver marcada como tal em [[desenvolvimento:especificacoes:sigaa:biblioteca:casos_de_uso:cadastros:bibliotecas::listar|Listar bibliotecas]].
  - Uma solicitação de levantamento bibliográfico pode estar em um dos seguintes estados:
    * **Aguardando validação** Inicialmente uma solicitação de levantamento de infra-estrutura tem esse valor.
    * **Validada** Solicitações de levantamento bibliográfico inicializam com esse status.
    * **Finalizada** A solicitação foi atendida ou foi cancelada por algum motivo.
  - Administradores gerais das bibliotecas podem gerenciar e atender todas solicitações de qualquer biblioteca. Administradores locais de uma biblioteca setorial só podem gerenciar e atender solicitações feitas a essa biblioteca.
  - Solicitações para uma biblioteca setorial só podem ser transferidas para a biblioteca central.
  - Um email de notificação é enviado para o usuário quando a solicitação é atendida.

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

^ Classe ^ Tabela |
| br.ufrn.sigaa.biblioteca.informacao_referencia.dominio.LevantamentoBibliograficoInfra | biblioteca.levantamento_bibliografico_infra |

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

Sistema: Sigaa

Módulo: Biblioteca

Links: SIGAA -> Biblioteca -> Informação e Referência -> Levantamento Bibliográfico -> Gerenciar Solicitações de Levantamento Bibliográfico

Papéis:
  * Geral: SigaaPapeis.BIBLIOTECA_SETOR_INFO_E_REF
  * Local: SigaaPapeis.BIBLIOTECA_SETOR_INFO_E_REF_BIBLIOTECARIO

Usuário:
  * Geral: clediane, margareth
  * Local: ekanzaki (Música), joaobosco (CCS)

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

  * Primeiramente, criar novas requisições de levantamento bibliográfico e de infra-estrutura usando discentes e servidores.
  * Utilizar os diferentes tipos de atendente de biblioteca (central e local) para verificar as regras de negócio.
  * Transferir solicitações para outra biblioteca e testar com os atendentes da biblioteca correspondente. Verificar também a regra de negócio associada.
  * Verificar se os emails de aviso estão sendo enviados.
  * Verificar se os dados dos atendimentos à solicitações estão disponíveis para os usuários que os pediram.

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

  * [[desenvolvimento:especificacoes:sigaa:biblioteca:casos_de_uso:cadastros:bibliotecas::listar|Listar bibliotecas]]. Para verificar ou alterar que bibliotecas estão habilitadas a prestar o serviço de levantamento bibliográfico e infra-estrutura.
  * [[desenvolvimento:especificacoes:sigaa:portal_do_discente:casos_de_uso:biblioteca:solicitacoes_de_levantamento_bibliografico|Solicitações de um discente]] ou [[desenvolvimento:especificacoes:sigaa:biblioteca:casos_de_uso:modulo_servidor:solicitacoes:solicitar_levantamento_bibliografico_e_de_infra_estrutura|Solicitações de um servidor]]. Para criar e acompanhar solicitações de levantamento bibliográfico e infra-estrutura de um usuário.
  * [[desenvolvimento:especificacoes:sigaa:biblioteca:casos_de_uso:cadastros:cursos_associados:listar|Cursos associados a Biblioteca]]. Para verificar ou alterar que cursos estão ligados a que bibliotecas setoriais.