~~ODT~~

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

====== Realizar Matrícula ======

Matrícula é o ato que vincula o aluno, regular ou especial, a componentes curriculares, oferecidos em turmas ou não, num determinado período letivo.

Este caso de uso permite que o próprio discente solicite a matrícula em componentes curriculares. 

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

Este caso de uso inicia-se quando o usuário acessa a opção SIGAA -> Portal Discente -> Ensino -> Matrícula On-Line -> Realizar Matrícula.

Ao acessar o caso de uso  o sistema disponibiliza as seguintes opções de matrículas abaixo:  ([[#principais_regras_de_negócio|RN01]], [[#principais_regras_de_negócio|RN07]], [[#principais_regras_de_negócio|RN08]], [[#principais_regras_de_negócio|RN09]] e [[#principais_regras_de_negócio|RN10]])

== Disciplinas ==
Esta opção exibe uma lista com as turmas disponíveis do currículo do aluno. ([[#principais_regras_de_negócio|RN04]], [[#principais_regras_de_negócio|RN05]] e [[#principais_regras_de_negócio|RN06]]).
      * Ver as turmas do programa: esta especificação esta descrita em [[desenvolvimento:especificacoes:sigaa:graduacao:casos_de_uso:matriculas_e_programas:matriculas:matricular_aluno#Ver as turmas da Estrutura Curricular|Ver as turmas da Estrutura Curricular]] do Módulo Graduação.
      * Ver orientações da coordenação
        * Solicitações de Matrícula Analisadas
          * **__Componente Curricular__**: Formato - TURMA - CÓD. DISCIPLINA - DISCIPLINA, Tipo - TEXTO.
          * **__Situação__**: Tipo: TEXTO.
          * **__Submetida em__**: Formato - DD/MM/AAAA, Tipo - DATA.
          * **__Analisada em__**: Formato - DD/MM/AAAA, Tipo - DATA.
          * **__Analisada por__**: Tipo - TEXTO.
          * **__Status da Matrícula__**: Tipo - TEXTO.
      * Informações do Aluno
          * **__Discente__**: Formato - MATRÍCULA - NOME DO DISCENTES, Tipo: NUMÉRICO e TEXTO.
          * **__Curso__**: Tipo: TEXTO.
          * **__Currículo__**: Tipo: NUMÉRICO.
      * Turmas Selecionadas
      * Horários das Turmas Selecionadas
== Atividades Complementares ==
Esta opção exibe uma lista com as atividades complementares do currículo do aluno.
      * Sugestão de Atividades
          * **__Atividade__**: Formato - COD. DISCIPLINA - DISCIPLINA, Tipo: TEXTO.

Para cada atividade o sistema disponibiliza a seguinte opção: 
      * Ver detalhes da atividade:
        * Esta opção permite que o usuário visualize os seguintes dados do componente curricular:
          * **__Dados Gerais do Componente Curricular__** 
            * **__Código__**: Tipo - TEXTO e NUMÉRICO.
            * **__Nome__**: Tipo - TEXTO.
            * **__Unidade Responsável__**: Tipo - TEXTO.
            * **__Tipo do Componente Curricular__**: Tipo - TEXTO.
            * **__Tipo de Atividade__**: Tipo - TEXTO.
          *  **__Carga Horária__** 
            * **__Carga Horária Teórica__**: Formato - 99h, Tipo - NUMÉRICO.
            * **__Carga Horária Prática__**: Formato - 99h, Tipo - NUMÉRICO.
          *  **__Pré-requisitos, Co-Requisitos e Equivalências__**
            * **__Pré-Requisitos__**: Tipo - TEXTO.
            * **__Co-Requisitos__**: Tipo - TEXTO.
            * **__Equivalências__**: Tipo -TEXTO.
          *  **__Ementa/Descrição__:** Tipo - TEXTO.
          *  **__Outras informações__**
            * **__Matriculável "On-Line"__**: Tipo - TEXTO.
            * **__Pode criar turma sem solicitação__**: Tipo - TEXTO.
            * **__Quantidade de Avaliações__**: Tipo - NUMÉRICO.
            * **__Possui subturmas__**: Tipo - TEXTO.
            * **__Permite Turma com Flexibilidade de Horário__**: Tipo - TEXTO.        

== Em Outros Programas ==
Esta opção exibe uma lista com os programas que estão com turmas abertas, especificação descrita em [[desenvolvimento:especificacoes:sigaa:graduacao:casos_de_uso:matriculas_e_programas:matriculas:matricular_aluno#Ver equivalentes a Estrutura Curricular|Buscar Turmas Abertas]] do Módulo Graduação.

== Exames de Proficiência ==
Esta opção exibe uma lista com as atividades de proficiência do currículo do aluno, especificação descrita em [[#Atividades Complementares|Atividades Complementares]].

== Qualificação ==
Esta opção exibe uma lista com as atividades de qualificação do currículo do aluno, especificação descrita em [[#Atividades Complementares|Atividades Complementares]]. ([[#principais_regras_de_negócio|RN02]], [[#principais_regras_de_negócio|RN03]])

== Defesa ==
Esta opção exibe uma lista com as atividades de defesa do currículo do aluno, especificação descrita em [[#Atividades Complementares|Atividades Complementares]]. ([[#principais_regras_de_negócio|RN02]], [[#principais_regras_de_negócio|RN03]])

=== Outras opções ===

== Visualizar Histórico ==
Esta opção permite o discente realizar o download de seu histórico escolar.

== Comprovante de Matrícula ==
Esta opção permite gerar  o comprovante de matrícula com as seguintes informações abaixo:

  * **__Matrícula__**: Tipo - NUMÉRICO.
  * **__Discente__**: Tipo - TEXTO.
  * **__Programa__**: Tipo - TEXTO.
  * **__Curso__**: Tipo - TEXTO.
  * **__Status__**: Tipo - TEXTO.
  * **__Tipo__**: Tipo - TEXTO.
  * Turmas selecionadas
    * **__Componente Curricular__**: Formato - COD. DISCIPLINA - DISCIPLINA - CH, TIPO - TEXTO e NUMÉRICO.
    * **__Turma__**: Tipo - TEXTO.
    * **__Local__**: Tipo - TEXTO.
    * **__Situação__**: Tipo - TEXTO.

O sistema ainda exibe um quadro com os horários das disciplinas, conforme exemplo abaixo:

|      ^  Seg  ^  Ter  ^  Qua  ^  Qui  ^  Sex  ^  Sab |
|  M1  |  ---  |  ---  |  ---  |  ---  |  ---  |  ---  |
|  M2  |  ---  |  ---  |  ---  |  ---  |  ---  |  ---  |
|  M3  |  ---  |  FIS0313  |  ---  |  FIS0313  |  ---  |  ---  |
|  M4  |  ---  |  FIS0313  |  ---  |  FIS0313  |  ---  |  ---  |
|  M5  |  ---  |  ---  |  ---  |  ---  |  ---  |  ---  |
|  M6  |  ---  |  ---  |  ---  |  ---  |  ---  |  ---  |
| |||||||
|  T1  |  DIM0109.1  |  ---  |  ---  |  ---  |  ---  |  ---  |
|  T2  |  DIM0109.1  |  ---  |  ---  |  ---  |  ---  |  ---  |
|  T3  |  ---  |  DIM0109.0  |  ---  |  DIM0109.0  |  ---  |  ---  |
|  T4  |  ---  |  DIM0109.0  |  ---  |  DIM0109.0  |  ---  |  ---  |
|  T5  |  ---  |  DIM0422  |  ---  |  DIM0422  |  ---  |  ---  |
|  T6  |  ---  |  DIM0422  |  ---  |  DIM0422  |  ---  |  ---  |
| |||||||
|  N1  |  MAT0312  |  ---  |  MAT0312  |  ---  |  MAT0312  |  ---  |
|  N2  |  MAT0312  |  ---  |  MAT0312  |  ---  |  MAT0312  |  ---  |
|  N3  |  FIS0701  |  ---  |  FIS0701  |  ---  |  FIS0701  |  ---  |
|  N4  |  FIS0701  |  ---  |  FIS0701  |  ---  |  FIS0701  |  ---  |


Então o caso de uso é finalizado. 

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

  * **RN01** - A matrícula deve ser realizada pelo aluno dentro do período definido no calendário do seu programa de pós-graduação.
  * **RN02** - Para realizar a matrícula em atividades de qualificação e/ou defesa é necessário ter um orientador definido.
  * **RN03** - Só é possível selecionar uma atividade de qualificação e uma de defesa.
  * **RN04** - Não é possível matricular disciplinas que tenham choque de horário. Esta regra também é valida para o caso de o discente ter dois vínculos ativos.
  * **RN05** - Os co-requisitos do componente das turmas deverão ser respeitados.
  * **RN06** - Os pré-requisitos do componente das turmas deverão estar integralizados (cumpridos previamente).
  * **RN07** - Algumas opções são parametrizadas no sistema pelo usuário, ou seja, cada programa podem ter diferenças quanto a:
                  * Matrículas online para discentes especiais.
                  * Máximo de matrículas para alunos especiais.
  * **RN08** - Não é possível realizar matricula em turmas de disciplinas de outros programas que não estão no período de matricula.

  * **RN09** - A solicitação de matrícula em atividades de qualificação ou defesa não pode exceder o limite de renovações definido pelo programa de pós-graduação.
  * **RN10** - Para discentes especiais realizarem a matrícula on-line o parâmetro (permitematriculaonlineespeciais) deve está ativo, este é localizado em "stricto_sensu.parametros_programa_pos".
  * **RN11** - Os discentes com atraso superior a **30** (trinta) dias na biblioteca ficam impossibilitados de efetivar matrícula em disciplina. O prazo de 30 dias é configurado por um [[desenvolvimento:especificacoes:sigaa:biblioteca:casos_de_uso:cadastros:parametros_gerais_do_sistema | Parâmetro do Módulo de Biblioteca]], caso assuma um valor < = 0 (menor ou igual a zero) essa regra é desativada.  //(regra de negócio adicionada em 15/08/2011) //.
  * **RN12** - O sistema deve enviar um e-mail de aviso para o e-mail do professor-orientador da solicitação toda vida que o discente solicitar uma matrícula ou cancelar uma matrícula.
  * **RN13** - O sistema deve enviar um e-mail de aviso para o usuário que realizou a solicitação toda vida que a solicitação for analisada.

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

===SEÇÃO IV===

==Da matrícula==

  * Art. 32 - A matrícula em cursos de pós-graduação, aberta a diplomados de nível superior, exige aprovação em exames de seleção, cujos critérios são estabelecidos no regimento de cada programa.
  * Parágrafo Único - A aceitação de diplomados por instituição de nível superior estrangeira dependerá do parecer do colegiado do programa, observados o histórico escolar do candidato e a legislação em vigor.
  * Art. 33 - A secretaria do programa comunicará à Pró-Reitoria de Pós-Graduação a relação dos alunos inscritos em disciplinas, no prazo máximo de 30 dias após o início de cada período letivo.
  * Art. 34 - Com a concordância do seu professor-orientador, e desde que ainda não tenha sido ministrada metade da carga horária correspondente, o aluno poderá solicitar ao colegiado cancelamento de sua inscrição em uma ou mais disciplinas.
  * Art. 35 - É permitido ao aluno requerer ao colegiado trancamento de matrícula no curso, quando houver motivo justo, devidamente comprovado, ouvido o professor-orientador.
    * § 1º - Em caso do trancamento de matrícula ser efetuado antes da obtenção de crédito, o exame de seleção pode, a critério do colegiado, ser válido para a rematrícula no período letivo seguinte.
    * § 2º - É permitido ao aluno requerer mais de uma vez o trancamento da matrícula no curso, desde que a soma dos períodos sob trancamento não exceda o limite de 06 (seis) meses para o mestrado e 12 (doze) meses para o doutorado.
    * § 3º - Durante o período sob trancamento, estará suspensa a contagem do prazo máximo de duração do curso.

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

^ Classe ^ Tabela |
| br.ufrn.sigaa.ensino.dominio.MatriculaComponente | sigaa.ensino.matricula_componente |
| br.ufrn.sigaa.ensino.dominio.Turma | sigaa.ensino.turma |
| br.ufrn.sigaa.ensino.dominio.ComponenteCurricular | sigaa.ensino.componente_curricular |


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

Sistema: SIGAA

Módulo: Portal do Discente

Link(s): Ensino -> Matrícula On-Line -> Realizar Matrícula

Usuário: dani25, linefreire, elensramos, fatimazevedo 

Papel que usuário deve ter: Discente de pós-graduação stricto sensu.

===== Cenários de Teste =====
Realizar a matrícula on-line de um discente com orientador externo, no qual não possua registro de usuário para este docente externo. Verificar se ainda ocorre o erro de Execução.


===== Dados para o Teste =====
Consulta para retonar usuário de discente cujo orientador não possui registro de usuário:
<code>
select p.nome, d.matricula, u.login as login_discente, oc.id_servidor, pServidor.nome, oc.id_docente_externo, pExterno.nome, oc.id_orientacao_academica, oc.id_orientacao_academica, d.id_gestora_academica, uExterno.id_usuario
from discente d
inner join comum.pessoa p using(id_pessoa)
inner join graduacao.orientacao_academica oc using(id_discente)
left join comum.usuario u on u.id_pessoa = p.id_pessoa
left join rh.servidor s ON s.id_servidor = oc.id_servidor
left join comum.pessoa pServidor ON pServidor.id_pessoa = s.id_pessoa
left join ensino.docente_externo de ON de.id_docente_externo = oc.id_docente_externo
left join comum.pessoa pExterno ON pExterno.id_pessoa = de.id_pessoa
left join comum.usuario uExterno ON uExterno.id_pessoa = pExterno.id_pessoa 
where d.status = 1
and d.nivel = 'D'
and oc.id_docente_externo is not null
and oc.tipoorientacao = 'O' 
and oc.cancelado = falseValue() 
and oc.data_finalizacao is NULL
and uExterno.id_usuario is NULL
</code>




<code sql>

---
--- recupera alunos com empréstimos em atraso superior a 30 dias
---
SELECT  p.nome AS nome_usuario,  u.email AS email_usuario, emp.id_emprestimo AS id_emprestimo, emp.prazo AS prazo, d.nivel, d.tipo
FROM biblioteca.emprestimo emp 
INNER JOIN biblioteca.usuario_biblioteca ub ON emp.id_usuario_biblioteca = ub.id_usuario_biblioteca
INNER JOIN comum.pessoa p ON (p.id_pessoa = ub.id_pessoa)
INNER JOIN comum.usuario u ON (p.id_pessoa = u.id_pessoa)
INNER JOIN discente d ON (d.id_pessoa = p.id_pessoa) 
WHERE emp.data_devolucao IS NULL AND emp.data_estorno IS NULL 
AND  emp.prazo < '15-07-2011 00:00:00.000'  --- ATENÇÃO: colocar aqui a data (hoje - 30 dias)
AND d.nivel in ('S', 'E', 'D') -- Mudar aqui para trazer no nível desejado (S = stricto ,  E = mestrado , D = doutorado)
LIMIT 10


---
--- muda o prazo dos empréstimos para testar
--- OBS.: recuperar o id do empréstimo da consulta acima.
---
update biblioteca.emprestimo set prazo = '15-07-2011 00:00:00.000' where id_emprestimo = xxxx;

</code>