====== Cadastrar uma Tarefa =======

Este caso de uso trata de permitir ao docente cadastrar uma tarefa na turma virtual, de forma que os alunos possam respondê-la enviando um arquivo ou digitando o texto na própria turma virtual. Para mais informações, vide a especificação de [[desenvolvimento:especificacoes:sigaa:turma_virtual:casos_de_uso:portal_do_docente:menu_turma_virtual:atividades::tarefas|Tarefas]].
===== Descrição do Caso de Uso ======

Este caso de uso pode ser acessado através do link: //Sigaa → Portal do Docente → Turma Virtual → Atividades → Tarefas → Cadastrar Tarefa//.

O caso de uso se constitui de um único formulário. Nele, o docente pode informar os dados da tarefa a ser criada. Os dados são:

  * **Título***: Tipo - TEXTO. O nome que será visualizado por todos;
  * **Texto***: Tipo - TEXTO. Uma descrição textual da tarefa;
  * **Arquivo**: Tipo - ARQUIVO. Um arquivo que pode ser anexado à tarefa;
  * **Em grupo?*** : Tipo - TEXTO. Define se a tarefa é individual ou em grupo
  * **Tipo de Tarefa***: Tipo - TEXTO. Indica a forma que o aluno terá para responder, sendo Enviar um arquivo ou digitar um texto;
  * **Tópico de Aula***: Tipo - TEXTO. O tópico de aula da turma em que esta tarefa será cadastada;
  * **Permitir Novo Envio**: Tipo - TEXTO. Indica se o aluno pode enviar a resposta mais de uma vez;
  * **Data da Abertura***: Tipo - DATA. A data em que a tarefa vai ser criada;
  * **Hora de Abertura**: Tipo - NUMÉRICO. Formato - HH:MM. Hora em que a tarefa será criada;
  * **Data da Fechamento***: Tipo - DATA. A data final para os alunos submeterem as respostas;
  * **Hora da Fechamento**: Tipo - NUMÉRICO. Formato - HH:MM. A hora final do último dia de entrega;
  * **Notificação**: Tipo - LÓGICO. Indica se é para avisar os alunos por email que esta tarefa foi cadastrada;
  * **Criar em***: Tipo - TEXTO. O professor selecionará todas as turmas em que deseja que esta tarefa seja cadastrada.
  * **Avaliação**
    * **Possui Nota***: Tipo - TEXTO. 
    * **Abreviação***: Tipo - TEXTO. Uma sigla para a tarefa;
    * **Unidade***: Tipo - NUMÉRICO. A unidade na qual esta tarefa contará ponto;

Após cadastrar uma tarefa, um email é enviado aos alunos da turma.

** Modelo do e-mail enviado ao notificar os alunos sobre o cadastro de uma tarefa **

<code>
Assunto : Nova Tarefa Adicionada: <DESCRIÇÃO DA TAREFA> - <CODIGO DA TURMA> - <NOME DA DISCIPLINA> - <NÚMERO DA TURMA> (<ANO/PERÍODO>)

Conteúdo:

Uma nova tarefa foi cadastrada na turma: <CODIGO DA TURMA> - <NOME DA DISCIPLINA> - <NÚMERO DA TURMA> (<ANO/PERÍODO>) do SIGAA

</code>

O caso de uso se encerra.

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

  * **RN01** - A tarefa deve ser cadastrada em pelo menos uma turma da disciplina selecionada;
  * **RN02** - O arquivo a ser anexo deve ter tamanho igual ou inferior ao máximo permitido;
  * **RN03** - A quantidade de Unidades são definidas na Programa do Componente em questão, caso houver programa, caso contrário será resgatado a quantidade definida no cadastro do Componente Curricular.
  * **RN04** - Ao cadastrar uma tarefa com nota deve-se cadastrar uma avaliação referente a tarefa. Caso a unidade já possua nota é enviado um alerta para o professor, avisando que a nota será perdida.

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

Não se Aplica.  

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

^ Classe ^ Tabela |
| br.ufrn.sigaa.ava.dominio.TarefaTurma | sigaa.ava.tarefa |
| br.ufrn.sigaa.ensino.dominio.Avaliacao | sigaa.ensino.avaliacao_unidade |

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

Sistema: Sigaa

Módulo: Turma Virtual

Link: Sigaa -> Portal do Docente -> Turma Virtual -> Atividades -> Tarefas -> Cadastrar Tarefa

Usuário: selan, paulo.pires, thais, anatalia.

Papel que usuário deve ter: SigaaPapeis.DOCENTE 

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

  * Testar cadastrar em mais de uma turma para ver se os alunos de todas as turmas são notificados corretamente.
  * Verificar o que ocorre quando é realizada uma alteração na quantidade de atividades informadas pelo chefe do departamento no programa do componente (de acordo com a regra de negócio) e logo depois tenta-se alterar a unidade de uma tarefa já cadastrada.
  * Verificar a quantidade de unidades que aparece para escolha quando não existe programa do componente curricular cadastrado para aquele semestre.
  * Verificar juntamente com o caso de uso [[desenvolvimento:especificacoes:sigaa:turma_virtual:casos_de_uso:menu_turma_virtual:atividades:enviar_tarefa|Enviar Tarefa]] para ver se os prazos estão sendo atendidos na hora do aluno responder a tarefa.
  * Deve-se verificar o e-mail enviado quando o docente cadastrar uma tarefa.
  * Verificar se é possível cadastrar tarefas em várias turmas. 

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

  * Para Cadastrar ou Alterar o Programa do Componente Curricular deve ir em: 
    * [[desenvolvimento:especificacoes:sigaa:portal_do_docente:casos_de_uso:chefia:componentes_curriculares:cadastrar_programa_de_componente|Cadastrar/Alterar Programa de Componente]]: Portal do Docente -> Chefia → Componentes Curriculares → Cadastrar Programa de Componente.