~~ODT~~

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

====== Gerenciar Solicitações de Agendamento de Serviços ======

Qualquer aluno ou servidor (técnico administrativo ou professor) da UFRN pode solicitar agendamento com os bibliotecários para realização de algum serviço, como receber orientação para normalização de algum trabalho por ele produzido.

A normalização é uma validação que é realizada pelo bibliotecário, verificando se o trabalho encontra-se dentro das normas estruturais estabelecidas, isto inclui estrutura do documento, referências bibliográficas, formatação, entre outras.
 
Os bibliotecários da seção de informação e referência podem utilizar esse caso de uso para atender ou cancelar uma requisição de qualquer tipo de agendamento de serviços cadastrados, como o agendamento de orientação para normalização.

Os tipos de agendamentos possiveis devem ser cadastrados através do caso de uso [[desenvolvimento:especificacoes:sigaa:biblioteca:casos_de_uso:cadastros:tipos_de_agendamentos:gerenciar_tipos_de_agendamento|Gerenciar Tipos de Agendamentos]]

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

O caso de uso inicia-se exibindo uma busca pelas solicitações em:

Sigaa → Biblioteca → Informação e Referência → Gerenciar Solicitações → Agendamentos

Através dos seguintes filtros:

  * **Número da Solicitação** - O número da solicitação.
  * **Tipo de Agendamento** - limita o tipo do agendamento da solicitação.
  * **Biblioteca** - limita a biblioteca responsável pelo atendimento da solicitação.
  * **Data da solicitação** - limita o intervalo de tempo no qual foi feita a solicitação.
  * **Nome do Solicitante** - A pessoa que fez a solicitação.
  * **Buscar solicitações atendidas** - se selecionado, inclui as solicitações já atendidas na busca.
  * **Buscar solicitações confirmadas** - se selecionado, inclui as solicitações confirmadas na busca.
  * **Buscar solicitações canceladas** - se selecionado, inclui as solicitações canceladas na busca.
  * **Buscar Solicitações Removidas pelo Usuário**: Buscas aquelas solicitações que o usuário removou antes de do bibliotecário atender.

O sistema retorna a lista de solicitações de acordo com os filtros. Para cada item, as opções disponíveis são: //Visualizar//, //Atender//, //Notificar//, //Transferir//, //Cancelar//.

=== Fluxo Alternativo 1 : Visualizar===

Escolhendo essa opção os dados da solicitação são mostrados (os mesmos dados descritos na opção de //Visualizar// - Fluxo Alternativo 1 do caso de uso de [[desenvolvimento:especificacoes:sigaa:portal_do_discente:casos_de_uso:biblioteca:solicitacoes:agendamento_de_servicos|Solicitações de Agendamento de Serviços]]

Dependendo do status da solicitação, informações adicionais são mostradas:
  * Quando a solicitação foi atendida: //**Atendida por**// e //**Data do Atendimento**//

=== Fluxo Alternativo 2 : Atender===

Se a solicitação está com o status //Solicitada//, o bibliotecário pode atendê-la através dessa ação. Os dados da solicitação são exibidos (como descrito no fluxo alternativo 1) e o bibliotecário deve preencher os seguintes campos:
  * **Data de atendimento**
  * **Horário de atendimento**
  * **Comentários** (Opcional)
Após preencher esses dados, o bibliotecário pode atender a solicitação. Ao atender a solicitação, um email é enviado ao usuário que realizou a solicitação e um outro para todos os bibliotecários do mesmo setor daquele que atendeu, para que eles possam substituí-lo em caso de ausência do mesmo no dia do agendamento.

== Modelo de email de notificação de atendimento de solicitação ==
  Assunto: [SIGAA - Biblioteca] Solicitação atendida
  Texto:
  Caro(a) usuário,
  
  A sua solicitação de orientação foi atendida. Por favor, realize a confirmação da mesma por meio do sistema.
  
  Atenciosamente,
  Setor de Informação e Referência
  

=== Fluxo Alternativo 3 : Notificar ===
Escolhendo essa opção é mostrado um formulário onde o bibliotecário pode notificar um usuário ou setor da biblioteca sobre o atendimento da solicitação.

== Modelo do email de notificação ==
  Prezado setor de ,

  Informamos que a solicitação de Orientação número 1144 do usuário: 
  LEONOR DE ARAUJO BEZERRA OLIVEIRA para a biblioteca: Biblioteca Setorial do Centro de Ciências Humanas, Letras e
  Artes - CCHLA está aguardando atendimento pelo seu setor.

  Atenciosamente,
  Setor de Informação e Referência

=== Fluxo Alternativo 4 : Transferir===
Se a solicitação está com o status //Solicitada//, essa opção fica disponível ao bibliotecário. Ao escolhê-la, é mostrada a lista de bibliotecas do sistema. O bibliotecário deve escolher uma delas e escolher a ação //Transferir Solicitação// para transferí-la. O usuário que solicitou a orientação de normalização é informado da transferência por email.
== Modelo do email de notificação de transferência ==
  Assunto: [SIGAA - Biblioteca] Solicitação transferida
  Texto:
  Caro(a) usuário,
  
  A sua solicitação de orientação sua foi transferida da <nome da biblioteca fonte> para a <nome da biblioteca destino>.
  
  Atenciosamente,
  Setor de Informação e Referência

=== Fluxo Alternativo 5 : Cancelar===
Se a solicitação não foi nem atendida nem cancelada, essa opção é habilitada. Escolhendo essa ação, os dados da solicitação são mostrados e o bibliotecário tem a opção de confirmar o cancelamento. Deve ser incluído obrigatoriamente o **motivo** do cancelamento da solicitação. A solicitação passa a ter o status //Cancelada// e o usuário é notificado por email do ocorrido.
== Modelo do email de notificação de transferência ==
  Assunto: [SIGAA - Biblioteca] Solicitação NÃO atendida
  Texto:
  Caro(a) usuário,

  A sua solicitação de orientação não pôde ser atendida. Motivo: <motivo>
  
  Atenciosamente,
  Setor de Informação e Referência

===== Principais Regras de Negócio =====
  - Uma solicitação feita para uma biblioteca setorial só pode ser transferida para a biblioteca central.
  - Quando uma solicitação do usuário é atendida, ele deverá receber uma notificação via e-mail e o resultado da solicitação deverá estar disponível no sistema(o horário que foi agendado e a aprovação ou não do horário pelo usuário).
  - Cada bibliotecário só deve visualizar e consequentemente atender as solicitações que foram encaminhadas à sua biblioteca.
  - As solicitações são são atendidas por quem tem papel de bibliotecário do sertor de informações referência.
  - O usuário com papel de administrador geral das bibliotecas poderá visualizar todas as solicitações de todas as bibliotecas.
  - A solicitação de normalização e catalogação pode estar em uma das 4 situações abaixo:
    * **Solicitado**: Indica que o usuário solicitou a orientação de normalização mas ainda nenhuma ação foi realizada.
    * **Atendido**: Significa que a solicitação de orientação já foi atendida pelos bibliotecários. 
    * **Confirmado**: Este status indica que o usuário aprovou o horário definido pelo bibliotecário e confirma o comparecimento na data agendada.
    * **Cancelado**: Este status indica que a solicitação foi cancelada pelo usuário ou pelo bibliotecário.
  - Quando uma solicitação for transferida ou cancelada, o usuário que a criou deve receber um email informando do ocorrido.


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

Não se Aplica.  

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

^ Classe ^ Tabela |
| br.ufrn.sigaa.biblioteca.informacao_referencia.dominio.SolicitacaoOrientacao| sigaa.biblioteca.solicitacao_orientacao|

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

Sistema: Sigaa

Módulo: Biblioteca

Links: Sigaa -> Biblioteca -> Informação e Referência -> Gerenciar Solicitações -> Agendamento de Orientação

Login:
  * margareth (administrador geral)
  * antonia (bibliotecária catalogação BCZM)
  * ericamelo (bibliotecária informação e referênica BCZM )

Papel que usuário deve ter: 
  * SigaaPapel.BIBLIOTECA_SETOR_INFO_E_REF  (apenas visualiza)
  * SigaaPapel.BIBLIOTECA_SETOR_INFO_E_REF_BIBLIOTECARIO
  * SigaaPapel.BIBLIOTECA_ADMINISTRADOR_GERAL



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

  * Criar solicitações usando o caso de uso citado abaixo, em //Dados para o teste//.
  * Atender as solicitações.
  * Remover solicitações.
  * Transferir solicitações e depois atendê-las.
  * Verificar se os usuários estão recebendo as notificações de atendimento, transferência e cancelamento.

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

  * Para verificar as solicitações feitas pelos usuários, pode-se utilizar por exemplo  o caso de uso [[desenvolvimento:especificacoes:sigaa:portal_do_discente:casos_de_uso:biblioteca:solicitacoes:agendamento_de_servicos|Solicitações de Agendamento de Serviços]]
  * Para verificar as bibliotecas que executam as solicitações, vide o caso de uso [[desenvolvimento:especificacoes:sigaa:biblioteca:casos_de_uso:cadastros:bibliotecas:gerenciar_bibliotecas|Gerenciar Bibliotecas]]