====== Moderar Observações de Docentes Sobre Turmas ======

A Comissão Própria de Avaliação (CPA) pode decidir que o [[desenvolvimento:especificacoes:sigaa:portal_do_discente:casos_de_uso:ensino:avaliacao_institucional:observacoes_dos_docentes_sobre_minhas_turmas|discente veja os comentários]] dados pelos docentes para a turma. Antes, entretanto, a CPA deve realizar um trabalho de moderação dos comentários, decidindo o que será divulgado ou não, podendo editar as observações dos docentes a fim de corrigir erros de ortografia, excluir partes que não são importantes ou pertinentes, ou até censurar o texto.

As observações dadas pelos docentes são consultas no [[desenvolvimento:especificacoes:sigaa:portal_do_discente:casos_de_uso:ensino:avaliacao_institucional:observacoes_dos_docentes_sobre_minhas_turmas|portal do discente]], sendo este trabalho realizado preferencialmente antes da divulgação do relatório.

Este caso de uso permite que a CPA possa moderar os comentários realizados pelos docentes referentes as turmas.

===== Descrição do Caso de Uso =====
Este caso de uso inicia quando o usuário acessa a opção: Portal da Avaliação Institucional → Administração → Moderação de Observações → Moderar Observações de Docentes Sobre Turmas

Ao iniciar o caso de uso, é apresentado ao usuário um formulário para busca de turmas. Para realizar a busca, o usuário deverá informar um ou mais dos seguintes parâmetros:

  * **Departamento**: departamento ao qual o usuário é associado.
  * **Ano-Período**: ano-período da Avaliação Institucional.
  * **Docente**: nome do docente.

O resultado da busca listará as turmas encontradas, agrupadas por departamento com a quantidade de comentários dados na turma. Um conjunto de ícones indicará se os comentários da turma foi finalizado ou não ((uma cruz e um "check", respectivamente) e se o usuário poderá realizar a moderadação das observações da turma (uma seta verde e uma cinza, respectivamente). 

Ao escolher uma turma para moderar, será apresentado ao usuário um formulário com três colunas:
  * à esquerda são as observações dadas pelos docentes à turmas no preenchimento da Avaliação Institucional
  * à direita é dado ao usuário um campo para editar a observação que será apresentada ao discente.
  * no centro há um link que permite copiar todo texto que o docente escreveu para o campo de edição, ou seja, copia o texto do lado esquerdo para o lado direito.

Textos que foram deixados em branco não serão exibidos ao discente. Desta forma, se o usuário não desejar que a observação dada pelo docente seja exibida, não deverá copiar o texto da esquerda para a direita, nem informada nada na caixa de texto correspondente.

Ao final do formulário de moderação de observações, são dadas as seguintes opções ao usuário:
  * Gravar: grava a moderação atual, permitindo ao usuário continuar o trabalho em outro momento. Esta operação não faz que as observações sejam vistas pelos discentes.
  * Finalizar: grava a moderação atual e permite que o discente tenha acesso às observações em seu portal. Uma vez finalizada a operação, não será dado ao usuário a possibilidade de moderar as observações da turma novamente.
  * Selecionar Outro: seleciona outra turma.
  * Cancelar: cancela a operação atual.

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

  * **RN01** - Uma vez finalizada a moderação, esta não poderá ser alterada.
  * **RN02** - O resultado da busca será apenas de docentes que tem Resultado da Avaliação, ou seja, de acordo com as regras definidas no [[desenvolvimento:especificacoes:sigaa:avaliacao_institucional:casos_de_uso:administracao:processamento::processamento_da_avaliacao_institucional|processamento]] (número mínimo de avaliações, etc.).

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

^ Classe ^ Tabela |
| br.ufrn.sigaa.avaliacao.dominio.ObservacoesDocenteTurma | sigaa.avaliacao.observacoes_docente_turma |
| br.ufrn.sigaa.ensino.dominio.Turma                      | sigaa.ensino.turma                        |
| br.ufrn.sigaa.dominio.Unidade                           | sigaa.comum.unidade                       |
| br.ufrn.rh.dominio.Servidor                             | sigaa.rh.servidor                         |
| br.ufrn.sigaa.pessoa.dominio.Pessoa                     | sigaa.comum.pessoa                        |
| br.ufrn.sigaa.avaliacao.dominio.ComentarioAvaliacaoModerado | sigaa.avaliacao.comentario_avaliacao_moderado |
====== Plano de Teste ======

Sistema: SIGAA

Módulo: Portal da Avaliação

Link(s): Administração -> Moderação de Observações -> Moderar Observações de Docentes Sobre Turmas

Usuário: edipo, medeiros

Papel que usuário deve ter: SigaaPapeis.COMISSAO_AVALIACAO, SigaaPapeis.BOLSISTA_AVALIACAO_INSTITUCIONAL

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

Moderar as observações para uma turma e verificar no [[desenvolvimento:especificacoes:sigaa:portal_do_discente:casos_de_uso:ensino:avaliacao_institucional:observacoes_dos_docentes_sobre_minhas_turmas|portal do discente]] as observações moderadas. 
===== Dados para o Teste =====

Cadastrar ao observações do docente sobre uma turma em [[desenvolvimento:especificacoes:sigaa:portal_do_docente:casos_de_uso:ensino:avaliacao_institucional:preencher_a_avaliacao_institucional|Preencher Avaliação]] e moderar suas observações.

</ifauth>