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

====== Cadastrar Turma ======

Este Caso de Uso tem como finalidade criar uma turma anual para uma determinada série de ensino médio, definindo algumas características, Locais de aula, turno, capacidade dentre outras. Essa funcionalidade é utilizada pelos Gestores e Coordenadores de cursos de ensino médio.

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

Este caso de uso inicia-se quando o usuário acessa a opção SIGAA → Médio → Turma → Turma → Cadastrar.

Para criar uma turma o usuário deve seguir os seguintes passos:

=== Passo 1 ===

Para iniciar o cadastro de uma nova Turma por série é necessário informar a série, ano e o nome (A, B, C) dessa turma. Serão solicitadas as seguintes informações:

  * **Ano***: Formato - AAAA. Tipo - DATA.
  * **Curso***: Tipo - TEXTO.
  * **Série***: Tipo - TEXTO.
  * **Estrutura Curricular***: Tipo - TEXTO.
  * **Nome***: Tipo - TEXTO.
  * **Turno***: Tipo - TEXTO.
  * **Capacidade***: Tipo - NUMÉRICO.
  * **Data de Início***: Formato - DD/MM/AAAA. Tipo - DATA.
  * **Data de Fim***: Formato - DD/MM/AAAA. Tipo - DATA.
  * **Ativo**: TIPO - LÓGICO.

Requisitando apenas ao usuário confirmar a operação. 

Ao final do processamento da operação serão exibidas as informações da turma cadastrada, sendo listadas as disciplinas vinculadas a turma cadastrada, sendo estas disciplinas geradas a partir do currículo ativo para a série definida na Turma.

O caso de uso é finalizado e é emitido para o usuário uma mensagem de cadastro com sucesso.

=== Passo 2 ===

Neste ponto, é dado ao usuário a opção de gerenciamento sobre as disciplinas da turma:
  * [[desenvolvimento:especificacoes:sigaa:medio:casos_de_uso:turma:turma:alterar_disciplina | Alterar Disciplina]] ;
  * //Remover Disciplina//;
  * //Listar Alunos Matriculados na Disciplina//;


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

===Regras referentes a validações de Horários===

As disciplinas possuem horários que são exibidos ao usuário no formato DIA-TURNO-HORARIO, por exemplo, o horário 24M12 indica que a turma tem aula na segunda e quarta-feira (24), no turno da manha (M) e no primeiro e segundo horário da manha (12). Abaixo estão listadas as regras que os horários das disciplinas devem obedecer:

===Regras referentes a Docentes ===
  * **RN01** - Um professor não pode ministrar sozinho duas disciplinas que tenham algum horário em comum (choque de horário).
  * **RN02** - Se houver choque de horário entre duas disciplinas ambas tiverem mais de um professor então não é considerado choque de horário.
  * **RN03** - Se duas disciplinas tiverem exatamente os mesmos horários e um professor tiver em ambas a soma da carga horária dedicada do docente na turma deverá ser no máximo a carga horária do componente. 
  * **RN04** - Não é permitido cadastrar turma de uma estrutura curricular, que não possua disciplinas vinculadas.
  * **RN05** - Só serão relacionadas as turmas, as estruturas curriculares ativas.

=== Regras referentes a alteração de Turma ===
  * **RN06** - Quando houver pelo menos um aluno matriculado, não será possível alterar os seguintes campos da turma 'Curso', 'Série' e 'Estrutura Curricular'. 

==== Resoluções/Legislações Associadas ====
Não se aplica.

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

^ Classe ^ Tabela |
| br.ufrn.sigaa.ensino.dominio.Turma | sigaa.ensino.turma |
| br.ufrn.sigaa.ensino.medio.dominio.TurmaSerie | sigaa.medio.turma_serie |
| br.ufrn.sigaa.ensino.medio.dominio.TurmaSerieAno | sigaa.medio.turma_serie_ano |

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

Sistema: SIGAA

Módulo: Médio

Link(s): Turma -> Turma -> Cadastrar

Usuário: pamarrihan (GESTOR_MEDIO), eronilson (COORDENADOR_MEDIO)

Papel que usuário deve ter: SigaaPapeis.GESTOR_MEDIO, SigaaPapeis.COORDENADOR _MEDIO 

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

Pode-se verificar se o cadastro foi realizado corretamente através do caso de uso [[listar_alterar|Listar/Alterar Turma]].

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

Não se Aplica.