~~ODT~~

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

====== Banco de Questões ======

Pensando em agilizar o cadastro de questionários para a turma virtual, foi desenvolvido um banco de questões que armazena as questões já utilizadas pelo docente em questionários antigos. Permitindo, posteriormente, que ele adicione as mesmas em questionários novos.
O docente pode, também, adicionar novas questões diretamente no banco, separando por categorias ou subcategorias, sem associá-las a um questionário previamente.
Para utilizar o banco de questões, o docente deve ter ministrado ou estar ministrando pelo menos uma turma.

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

O caso de uso inicia ao docente acessar o caminho Sigaa -> Portal do Docente -> Turma Virtual -> Atividades -> Questionários -> Banco de Questões . Inicialmente exibe duas listagens de categorias de questões. A primeira, lista as categorias próprias do docente; A segunda, as categorias que outros docentes compartilharam com este. 

  * **__Nome__**: Tipo - TEXTO.
  * **__Dono__**: Tipo - TEXTO. (Exibido para as categorias compartilhadas)

Com as seguintes operações para as categorias próprias:

  * //Gerar Relatório das Perguntas //: Gera Relatório das Perguntas da categoria;
  * //Alterar Categoria//: Altera o nome da categoria;
  * //Remover Categoria//: Remove a categoria;
  * //Gerenciar compartilhamento//: Exibe a tela de compartilhamento da categoria;

Ao selecionar a operação de gerenciar compartilhamento da categoria, será exibida uma tela contendo a lista de nomes dos docentes com quem a categoria está compartilhada e um link para adicionar novos compartilhamentos. Ao selecinoar este link, será exibido um formuláiro onde o docente informa parte do nome do docente com quem deseja compartilhar a categoria, seleciona o nome correto na lista exibida e seleciona a opção "Compartilhar". Na mesma tela também é possível remover os compartilhamentos da categoria.

Dentro de cada categoria, são listados os títulos das perguntas a elas associadas. O docente pode, então, adicionar categorias, adicionar subcategorias ou gerenciar as perguntas em cada categoria. Para cadastrar uma categoria, basta selecionar a opção "Cadastrar categoria". No formulário seguinte, somente o nome da categoria é necessário para efetuar o cadastro.

  * //Nova Categoria//: Permite cadastrar uma nova categoria para agrupar questões. Solicita o segunte Campo:
    * **Nome**: Tipo - TEXTO. O nome da categoria.

Para cadastrar uma subcategoria, basta selecionar a opção "Cadastrar subcategoria". No formulário seguinte, somente o nome da subcategoria é necessário para efetuar o cadastro.

  * //Nova Subcategoria//: Permite cadastrar uma nova subcategoria para agrupar questões. Solicita o segunte Campo:
    * **Categoria**: Selecionar a categoria pai.
    * **Nome**: Tipo - TEXTO. O nome da categoria.
    * **Quantidade de questões mutáveis**: Tipo - INTEIRO. A quantidade de questões que serão mutáveis quando o discente estiver respondendo o questionário.

Em relação às subcategorias próprias, é possível realizar as seguintes operações:

  * //Alterar Subcategoria//: Altera o nome da subcategoria;
  * //Remover Subcategoria//: Remove a subcategoria;

Em relação às perguntas, é possível realizar as seguintes operações:

  * //Nova Pergunta//: Permite cadastrar uma nova pergunta. Solicita os seguintes campos:
      *  **Categoria:*** Tipo - TEXTO. A categoria na qual a pergunta será cadastrada;
      *  **Subcategoria:*** Tipo - TEXTO. A subcategoria na qual a pergunta será cadastrada;
      *  **Tipo de pergunta:*** Tipo - TEXTO. O tipo da pergunta (se é numérica, de múltipla escolha, dissertativa, etc);
      *  **Pergunta:*** Tipo - TEXTO. O título da pergunta;
      *  **Descrição da Pergunta:** Tipo - TEXTO. Uma descrição mais detalhada da pergunta;
      *  **Resposta:** A resposta da pergunta;
      *  **Alternativa:** A alternativa da pergunta;
        * **Texto**: Tipo - TEXTO.
        * **Feedback**: Tipo - TEXTO.
      *  **Feedback acerto:** Tipo - TEXTO. A mensagem a ser exibida ao discente acertar a pergunta;
      *  **Feedback erro:** Tipo - TEXTO. A mensagem a ser exibida ao discente errar a pergunta;
    
  * //Gerar Relatório de todas Categorias //: Gera um relatório para impressão contendo todas as perguntas de todas as categorias e subcategorias. O relatório possui as seguintes opções:  
      *  **Imprimir mostrando resposta:** Tipo - BOOLEANO. 
      *  **Imprimir mostrando feedbacks:** Tipo - BOOLEANO. 
      *  **Imprimir mostrando categorias compartilhadas:** Tipo - BOOLEANO. 

  * //Alterar Pergunta//: Altera as informações da pergunta;
  * //Remover Pergunta//: Remove a pergunta do banco de questões;
  * //Gerar Relatório das Perguntas//: Gera relatório com todas as perguntas da categoria e subcategorias (se houverem);
  * //Compartilhar Categoria//: Permite que o docente adicione ou remova compartilhamentos.
O caso de uso é finalizado.

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

  * **RN01**: Só é possível cadastrar uma subcategoria para uma categoria que não possui perguntas.
  * **RN02**: Não é possível cadastrar perguntas à categorias que possuem subcategorias.
==== Resoluções/Legislações Associadas ====

Não se aplica

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

^ Classe ^ Tabela |
| br.ufrn.sigaa.ava.questionarios.dominio.CategoriaPerguntaQuestionarioTurma | sigaa.ava.categoria_pergunta_questionario_turma |

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

Sistema: SIGAA

Módulo: Portal do Docente

Link(s): Portal do Docente -> Turma Virtual -> Atividades -> Questionários -> Banco de Questões

Usuário: selan

Papel que usuário deve ter: Qualquer docente com acesso a turma virtual

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

Verificar se a listagem está exibindo somente as categorias criadas pelo próprio usuário.


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

Não se aplica