[[sigaa:tecnico:documentacao_tecnica:aba_turma| << Voltar]]    

<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 para um Componente Curricular, definindo algumas características, como Horários, Locais de aula, Docentes entre outras. Essa funcionalidade é utilizada pelos Coordenadores de cursos técnicos.
===== Descrição do Caso de Uso =====

Este Caso de Uso está especificado em  [[desenvolvimento:especificacoes:sigaa:graduacao:casos_de_uso:matriculas_e_programas:turmas:criar_turma|Criar Turma]] de Graduação.

=== Passo 1 ===

O usuário deverá escolher um componente curricular para o qual será criada a turma da lista de resultados da busca por componentes curriculares.
São solicitados para a busca de componente curricular:

  * **Código**: código do componente curricular.
  * **Nome**: nome do componente curricular.
  * **Tipo**: tipo do componente curricular.	
  * **__Unidade Responsável__**: unidade responsável pelo componente curricular.

O resultado da busca tratá uma lista de componentes curriculares, de acordo com os parâmetros informados para a busca, detalhando o Código, Nome, Crédito Total, Carga Horária Total, Tipo (Disciplina, Atividade, etc) e se está Ativo ou não.

=== Passo 2 ===

Os seguintes dados da turma já virão preenchidos:
  * **__Componente Curricular__**: tipo - TEXTO. Código e nome do componente curricular selecionado no passo anterior.
  * **__Tipo do Componente__**: tipo - TEXTO. Exemplo: disciplina, atividade, etc.
  * <del>Cr</del> **__Ch Total__**: tipo - TEXTO e NUMÉRICO. Total de créditos e carga horária do componente curricular.
  * **__Tipo da Turma__**: tipo - TEXTO. Exemplo: Regular, de Férias, etc.
  * **__Modalidade__**: tipo - TEXTO. Exemplo: Presencial.

São solicitados os Dados Básicos da Turma:

  * **Ano-Período***: Tipo - DATA.
  * **Capacidade de Alunos***: Tipo - NUMÉRICO.
  * **Local***: Tipo - TEXTO e NUMÉRICO.
  * **Observações ao Aluno**: Tipo - TEXTO.
  * **Inicio***: Tipo - DATA.
  * **Fim***: Tipo - DATA.

=== Passo 3 ===

São informadas os dados da turma cadastrados no passo anterior.

Neste passo é exibida uma grade para se definir o horário da turma. O usuário deverá selecionar quais dias e horários da semana a turma terá aula.

A grade de horários exibida pode ter os horários do domingo habilitados ou não, de acordo com a regra de negócio [[#Principais Regras de Negócio|RN02]].

=== Passo 4 ===

São informadas os dados recém cadastrados e solicitados dados sobre os docentes:

  * **Docentes***: Formato - SIAPE NOME DO DOCENTE. Tipo - AUTOCOMPLETE. Inicialmente, é dado ao usuário a opção por buscar docentes de sua unidade.
  * **Carga Horária***: Tipo - NUMÉRICO.

Caso o componente curricular defina que o horário do docente pode ser flexível, o usuário deverá informar também:

    * **Período***: período que o docente lecionará na turma
    * **Horários no Período***: horário que o docente lecionará para o referido período.

Os docentes incluídos serão listados informando o nome do Docente, o horário (caso o horário do docente seja flexível), a carga horária, bem como uma opção de remover o docente da turma.

=== Passo 5 ===

Ao final são exibidas as informações cadastradas com opções de retornar para alguma edição ou confirmar a turma.

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

Neste ponto, é dado ao usuário a opção de:
  * Cadastrar Turma para o mesmo Componente Curricular;
  * Cadastrar Turma para outro Componente Curricular;
  * Consultar, Alterar ou Remover Turma;
  * Voltar ao Menu Principal


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

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

As turmas 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 turmas devem obedecer:
  * **RN01** Se a turma for de uma disciplina que aceite horário flexível, é possível fragmentar o horário. Por exemplo entre 10/08 e 10/09 a turma possuir o horário 24M12 e no resto de semestre ser 35M12. As validações devem verificar o choque também nos períodos.
  * **RN02** Se a unidade gestora acadêmica que oferta a turma tiver configurado, os horários do domingo podem estar habilitados na grade de horários. Parâmetro definido por: HABILITAR_HORARIOS_DOMINGO.

===Regras referentes a Docentes ===
  * **RN03** Um professor não pode ministrar sozinho duas turmas que tenham algum horário em comum (choque de horário).
  * **RN04** Se houver choque de horário entre duas turmas e ambas tiverem mais de um professor então não é considerado choque de horário.
  * **RN05** Se duas turmas 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. 

==== Resoluções/Legislações Associadas ====
Não se aplica.
<ifauth @admin>
===== Classes Persistentes e Tabelas Envolvidas =====

^ Classe ^ Tabela |
| br.ufrn.sigaa.ensino.dominio.Turma | sigaa.ensino.turma |


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

Sistema: SIGAA

Módulo: Técnico

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

Usuário: viana

Papel que usuário deve ter: SigaaPapeis.GESTOR_TECNICO 

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

Pode-se verificar se o cadastro foi realizado corretamente através do caso de uso [[alterar_remover|Alterar/Remover Turma]].
===== Dados para o Teste =====

Para testar a RN02, habilitar/desabilitar o parâmetro HABILITAR_HORARIOS_DOMINGO na tabela ensino.parametros_gestora_academica.
É suficiente alterar o valor do parâmetro somente para a unidade do usuário que se está testando.
</ifauth>