~~ODT~~

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


====== Planos de Matrículas de Discente Ingressantes ======

O Plano de Matrícula de Discente Ingressantes permite que os alunos ingressantes sejam matriculados automaticamente em um conjunto de turmas definido pelo coordenador do curso no ato do cadastramento na instituição.

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

Este caso de uso inicia quando o usuário acessa a opção: 

**Como coordenador:**
//SIGAA -> Portal do Coordenador de Graduação -> Matrículas -> Alunos Ingressantes -> Plano de Matrícula -> Gerenciar Planos de Matrículas//.

**Como gestor:**
//SIGAA -> Graduação -> Matrículas e Programas -> Turmas -> Planos de Matrículas de Discentes Ingressantes//.

É apresentado ao usuário uma lista dos Planos de Matrículas cadastrados com a opção de filtrar a listagem por ano-período:

  * **Ano-Período***: Tipo - NUMÉRICO.
  * **__Curso__**: Tipo - TEXTO.

O resultado da busca é:
  * **Ano-Período**: Tipo - NUMÉRICO.
  * **Código**: Tipo - TEXTO.
  * **Matriz Curricular**: Tipo - TEXTO.
  * **Turmas**: Tipo - TEXTO.
  * **Capacidade**: Tipo - NUMÉRICO.
  * **Discentes Atendidos**: Tipo - NUMÉRICO.

O usuário poderá escolher um Plano da lista para visualizar, alterar ou remover. O caso de uso para alterar um plano de matrícula é o mesmo de cadastrar:

Para cadastrar ou alterar um Plano de Matrícula, o usuário deverá informar uma matriz curricular, capacidade do plano de matrícula e selecionar as turmas em que os discentes ingressantes serão matriculados para o plano de matrícula:

  * **__Ano-Período__**: Tipo - NUMÉRICO.
  * **__Código__**: Tipo - TEXTO.
  * **__Curso__**: Tipo - TEXTO.
  * **Matriz Curricular***: Tipo - TEXTO.
  * **Capacidade***: Tipo - NUMÉRICO.

^ Turma ^ Docentes ^ Horário ^ Local |
| Tipo - TEXTO | Tipo - TEXTO | Tipo - TEXTO | Tipo - TEXTO |

Se desejar, o usuário poderá selecionar a turma para visualizar os detalhes do [[desenvolvimento:especificacoes:sigaa:graduacao:casos_de_uso:ddp:componentes_curriculares:visualizar_componente_curricular|Componente curricular]].

Em seguida é apresentado ao usuário os dados informados anteriormente para a confirmação antes do cadastramento.

  * **__Ano-Período__**: Tipo - NUMÉRICO.
  * **__Código__**: Tipo - TEXTO.
  * **__Curso__**: Tipo - TEXTO.
  * **__Matriz Curricular__**: Tipo - TEXTO.
  * **__Capacidade__**: Tipo - NUMÉRICO.

^ Componente Curricular ^ Cód. Turma ^ Horário ^ Docentes |
| Tipo - TEXTO | Tipo - TEXTO | Tipo - TEXTO | Tipo - TEXTO |
^ Quadro de Horário ^^^|
|Tipo - TEXTO ||||

  * **Visualizar**
    * Ao acessar esta opção, serão exibidas as mesmas informações para confirmação de cadastro.
  * ** Remover**
    * Para remover um plano de matrícula, basta acessar a opção e confirmar a operação. 

O usuário tem a opção de gerar um relatório utilizando o mesmo formulário de busca por Planos de Matrícula. O relatório exibirá uma tabela no formato:


^ Turma        ^ Capacidade da Turma ^  PLANO(S) DE MATRÍCULA  ^^^^^^^^^^^^^
^ :::          ^ :::                 ^  MATRIZ CURRICULAR 1                               ^^^^  MATRIZ CURRICULAR 2                                 ^^^^  ...  ^  MATRIZ CURRICULAR N                                            ^^^^ 
^ :::          ^ :::                 ^  TURMA 1        ^  TURMA 2        ^ ... ^  TURMA N        ^  TURMA 1      ^  TURMA 2        ^  ...  ^  TURMA N        ^  ...  ^  TURMA 1         ^  TURMA 2        ^  ...  ^  TURMA N      ^
| TIPO - TEXTO | TIPO - NUMÉRICO     | TIPO - NUMÉRICO | TIPO - NUMÉRICO | ... | TIPO - NUMÉRICO | TIPO NUMÉRICO | TIPO - NUMÉRICO |  ...  | TIPO - NUMÉRICO |  ...  |  TIPO - NUMÉRICO | TIPO - NUMÉRICO |  ...  | TIPO NUMÉRICO | 


O caso de uso é finalizado.

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

   * <del>  **RN01** - Não poderá haver duas descrições idênticas para o mesmo ano-período e matriz curricular.</del>
  * **RN02** - O coordenador do curso poderá ver apenas os planos cadastrados para o curso coordenado.
  * **RN03** - Ao atualizar a reserva de vagas para discentes ingressantes, a somatória de todas reservas da turma não deverá ultrapassar a capacidade da turma.
  * **RN04** - Não permitir excluir uma turma se ela estiver ligada a um plano.
  * **RN05** - O cadastro/remoção/alteração de planos obedecerá o período definido em  [[desenvolvimento:especificacoes:sigaa:graduacao:casos_de_uso:administracao:operacoes_administrativas:calendario_universitario|calendário acadêmico]]
  * **RN06** - Apenas serão passíveis de inserção no plano de matrícula turmas de componentes OPTATIVOS, COMPLEMENTARES e OBRIGATÓRIOS do 1º nível da estrutura curricular;
 * **RN07** - Apenas turmas com reserva de vagas para uma determinado curso podem estar presentes no plano de matrícula de ingressantes do curso.
==== Resoluções/Legislações Associadas ====

Não se aplica.

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

^ Classe ^ Tabela |
| br.ufrn.sigaa.ensino.dominio.PlanoMatriculaIsgressantes | sigaa.ensino.plano_matricula_ingressantes |


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

Sistema: SIGAA

Módulo: Portal do Coordenador de Graduação.

Link(s):  Matrículas -> Alunos Ingressantes -> Plano de Matrícula -> Gerenciar Planos de Matrículas

Usuário: amccampos

Papel que usuário deve ter: SigaaPapeis.COORDENADOR_CURSO

===== Cenários de Teste =====
  - [[desenvolvimento:especificacoes:sigaa:graduacao:casos_de_uso:matriculas_e_programas:turmas:criar_turma|Criar turmas]] com reservas de vagas para o Curso e Matriz Curricular dos ingressantes.
  - Cadastrar o Plano de Matrícula para o curso dos ingressantes

Outros cenários:

- Validar choque de horários entre as turmas do plano, na inserção de uma nova turma no plano e na alteração do horário da turma.

- Verificar pré-requisito e co-requisito quando adicionar uma turma no plano


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

Não se aplica.