~~ODT~~

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


====== Gerenciar Plano de Curso ======

Com o novo regulamento para os cursos de graduação, os professores são obrigados a cadastrar o plano de curso antes do primeiro dia de aula do período letivo.
Plano de curso é semelhante ao programa de componentes curriculares porém ficam associados à turma e não ao componente. É composto por metodologia, procedimentos de avaliação da aprendizagem, tópicos de aulas, avaliações e indicações de referências que serão aplicados à turma.

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

Esse caso de uso pode iniciar a partir de dois modos:

  * Ao tentar acessar uma turma (//Sigaa -> Portal do Docente -> Turma Virtual//) que não possua um plano de curso enviado, o professor é direcionado ao formulário do cadastro do plano de curso.
  * Através do caminho //Sigaa -> Portal do Docente -> Ambientes Virtuais -> Turmas Virtuais Abertas//.

Ao entrar no formulário, ao topo será exibida uma tela com as seguintes informações:
  * **__Turma__**: Tipo - TEXTO. Formato - CÓDIGO - DISCIPLINA - TURMA: CÓDIGO (ANO.PERÍODO) 
  * **__Carga Horária Total__**: Tipo - NUMÉRICO.
  * **__Horário__**: Tipo - TEXTO.
  * **__Pré-Requisitos:__**: Tipo - TEXTO.
  * **__Ementa:__**: Tipo - TEXTO.

Logo abaixo são exibidos os campos para informação dos dados do plano de curso da turma:
 
  * **Metodologia***: Tipo - TEXTO.
  * **Procedimentos de Avaliação da Aprendizagem***: Tipo - TEXTO.
  * **Horário de atendimento**: Tipo - TEXTO.

As outras informações do plano de curso são compostas por tópicos de aula, avaliações e indicações de referência. Para cada um destes é exibido um formulário e uma listagem onde o docente vai inserindo os itens:

===Tópicos de Aulas=== 

Para cadastrar um tópico de aula ([[gerenciar_plano_de_curso#principais_regras_de_negócio|RN01]]), o docente deve informar:
    * **Data Inicial***: Tipo - DATA.
    * **Data Final***: Tipo - DATA.
    * **Descrição***: Tipo - TEXTO.
    * **Conteúdo**: Tipo - TEXTO.

Caso a turma seja de ensino à distância, os tópicos de aula são exibidos em uma tabela de acordo com os itens do programa, sendo possíveis usá-los para incluir nos tópicos de aula. Os seguintes campos são mostrados:
  * **__Aula__**: Tipo - TEXTO.
  * **__Descrição__**: Tipo - TEXTO.

Abaixo são mostradas os tópicos de aulas que vão sendo inseridas com as seguintes informações:
    * **__Início__**: Tipo - DATA. Formato - DD/MM/AAAA.
    * **__Fim__**: Tipo - DATA. Formato - DD/MM/AAAA.
    * **__Descrição__**: Tipo - TEXTO.

Além disso, é possível alterar ou remover um tópico de aula.

===Avaliações===

Para cadastrar uma avaliação([[gerenciar_plano_de_curso#principais_regras_de_negócio|RN02]]), o docente deve informar os seguintes dados:
    * **Descrição***: Tipo - TEXTO.
    * **Data**: Tipo - DATA.
    * **Hora**: Tipo - TEXTO.
Abaixo são mostradas as avaliações cadastradas:
    * **__Data__***: Tipo - DATA.
    * **__Hora__***: Tipo - TEXTO. Formato - HH:MM.
    * **__Descrição__**: Tipo - TEXTO.

===Indicação de Referência===

Para cadastrar uma indicação de referência ([[gerenciar_plano_de_curso#principais_regras_de_negócio|RN03]]), o docente deve informar o tipo do material, o link onde ele está disponível (se estiver) e o título. 
    * Para os materiais cujo tipo é **Livro**, o docente deve realizar uma busca nos materiais da biblioteca e selecionar o item correto. Caso não encontre, serão exibidos os seguintes campos paar preenchimento:
      * **Autor***: Tipo - TEXTO.
      * **Editora***: Tipo - TEXTO.
      * **Ano***: Tipo - TEXTO.
      * **Edição***: Tipo - TEXTO.

     * Também será exibida a opção para **Visualizar Informações sobre os Exemplares ** do livro como:    
          * **Biblioteca**: Biblioteca que se encontra o exemplar.
          * **Código de Barras**: Código de barras do exemplar.
          * **Tipo do Material**: Tipo do material do exemplar.
          * **Coleção**: Tipo de coleção do exemplar.
          * **Status**: Status do exemplar.
          * **Situação**: Situação do exemplar (Caso o exemplar esteja emprestado será exibido a data em que o livro deve ser devolvido).

Ao preencher o título, será exibida uma lista de materiais existentes na biblioteca com aquele título. O docente pode, também, informar quais indicações de referência são básicas ou complementares, selecionando as respectivas opções na listagem das indicações de referência(//Mudar o tipo da indicação para Básica// ou //Mudar o tipo da indicação para Complementar//). É possível realizar a importação dos tópicos de aula e indicações de referência de turmas anteriores.

    * Para o tipo **Artigo**, são apresentados os seguintes campos para preenchimento:
      * **Nome ou Título***: Tipo - TEXTO.
      * **Autor***: Tipo - TEXTO.
      * **Ano***: Tipo - NUMÉRICO.
      * **Endereço (URL)***: Tipo - TEXTO.

    * Para o tipo **Revista**, são apresentados os seguintes campos para preenchimento:
      * **Nome ou Título***: Tipo - TEXTO.
      * **Autor***: Tipo - TEXTO.
      * **Editora***: Tipo - TEXTO.
      * **Edição***: Tipo - TEXTO.
      * **Ano***: Tipo - NUMÉRICO.
      * **Endereço (URL)***: Tipo - TEXTO.

    * Para o tipo **Site**, são apresentados os seguintes campos para preenchimento:
      * **Nome ou Título**: Tipo - TEXTO.
      * **Endereço (URL)**: Tipo - TEXTO.

    * Para o tipo **Outro**, são apresentados os seguintes campos para preenchimento:
      * **Nome ou Título***: Tipo - TEXTO.
      * **Endereço (URL)**: Tipo - TEXTO.

Em seguida o sistema apresenta os materiais cadastrados:
      * **__Tipo de Material__**: Tipo - TEXTO.
      * **__Descrição__**: Tipo - TEXTO.

O docente também tem a opção de **Remover Indicação de Referência** caso haja necessidade.

Após preenchido o plano de curso, o docente pode salvar as alterações feitas, através da opção "Salvar" ou concluir o plano de curso e obter acesso à turma virtual, através da opção "Salvar e Enviar".

O caso de uso é finalizado.

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

  * **RN01** - O plano de curso deve conter um número mínimo de tópico de aulas de acordo com a quantidade de aulas. Este número mínimo é uma porcentagem salva no banco como um parâmetro. Atualmente é 50%.
  * **RN02** - O plano de curso deve conter todas as avaliações do componente.
  * **RN03** - O plano de curso deve conter pelo menos uma indicação de referência.
  * **RN04** - Caso Docente não tenha cumprido uma certa % (PERCENTUAL_NOTIFICAR_TURMAS_PLANO_CURSO_NAO_CADASTRADOS) da Carga Horária do componente curricular será enviado uma notificação para o docente e chefe  da unidade (ao qual o componente curricular em questão está relacionado) acerca do plano de ensino não cadastrado. [[desenvolvimento:especificacoes:arquitetura:servicos:timers:planosdeensinonaocadastradostimer|PlanosdeEnsinoNaoCadastradosTimer]]
==== Resoluções/Legislações Associadas ====

**RESOLUÇÃO No 227/2009-CONSEPE, de 03 de dezembro de 2009**

**Art. 42**. Para os componentes curriculares nos quais há formação de turmas, cada turma deve ser detalhada por um plano de curso que contenha:

  - Metodologia;
  - Procedimentos de avaliação da aprendizagem;
  - Referências;
  - Cronograma das aulas e avaliações.

§ 1o É obrigatória a implantação pelo professor, antes do início do período letivo, do plano de curso no sistema de registro e controle acadêmico.

§ 2o É obrigatória a apresentação pelo professor, no primeiro dia de aula do período letivo, do programa do componente curricular e do plano de curso da turma.



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


^ Classe ^ Tabela |
| br.ufrn.sigaa.ensino.dominio.PlanoCurso | sigaa.ensino.plano_curso |
| br.ufrn.sigaa.ensino.dominio.Turma | sigaa.ensino.turma |
| br.ufrn.sigaa.ava.dominio.TopicoAula | sigaa.ava.topico_aula |
| br.ufrn.sigaa.ava.dominio.DataAvaliacao | sigaa.ava.data_avaliacao |
| br.ufrn.sigaa.ava.dominio.IndicacaoReferencia | sigaa.ava.indicacao_referencia |

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

Sistema: SIGAA

Módulo: Portal do Docente

Link(s): Ambientes Virtuais -> Turmas Virtuais -> Turmas Abertas -> Gerenciar Plano de Curso

Usuário: selan, jonas (docente graduação), apuena (docente ead), jacome(discente graduação), adrirn (discente ead)

Papel que usuário deve ter: Ser usuário docente

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

  - Testar o fluxo completo do caso de uso (cadastro, alteração)
  - Testar se o caso de uso está restrito apenas a docentes.
  - Testar se durante o acesso a uma turma que não possua plano de curso, o fluxo é desviado para o cadastro e consequente para a turma virtual.

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

<code sql>

A consulta exibe os planos de cursos que já foram finalizadas e o docente da turma

SELECT p.id_plano_curso, p.id_turma,p.metodologia, p.finalizado, cc.codigo, de.nome, t.codigo, u.login as docente FROM ensino.plano_curso p
INNER JOIN ensino.turma t ON (p.id_turma = t.id_turma)
INNER JOIN ensino.componente_curricular cc ON (t.id_disciplina = cc.id_disciplina)
INNER JOIN ensino.docente_turma d ON (t.id_turma = d.id_turma)
INNER JOIN ensino.componente_curricular_detalhes de ON (cc.codigo = de.codigo)
INNER JOIN comum.usuario u on (d.id_docente = u.id_servidor)
WHERE t.ano = 2016 AND t.periodo = 1
and finalizado = 'f' 
order by cc.codigo
</code>