| {{:projetos:ufopa:requisitos:sigaa:graduacao:administracao:processamento_de_matricula:logosig.png?50 }}SIG Software & Consultoria em Tecnologia da Informação LTDA |
| Documento de Especificação de Requisitos |
| **Projeto:** Implantação Sistemas SIG |
| **Instituição:** Universidade Federal do Piauí |
| **Contrato:** 72/2011 |
====== Matricular Aluno Ativo ======
Matrícula é o ato que vincula o aluno, regular ou especial, a turmas de componentes curriculares em um determinado período letivo.
Este caso de uso permite que o coordenador da graduação matricule discentes em turmas.
===== Descrição do Caso de Uso =====
Este caso de uso inicia-se quando a opção //SIGAA -> Portal do Coord. Graduação -> Matrículas -> Matricular Aluno Ativo// é acessada.
===Passo 1===
Ao ter acesso a funcionalidade são solicitados alguns dados para ser feita a busca por discentes:
* **Matrícula**: Formato - 9999999999. Tipo - NUMÉRICO.
* **CPF**: Formato - 99999999999. Tipo - NUMÉRICO.
* **Nome do Discente**: Tipo - TEXTO.
* **__Curso__**: Curso do coordenador. Tipo - Texto.
Os parâmetros de busca podem ser combinados para refinar o resultado. Os resultados são mostrados em formato de tabela seguindo o modelo abaixo:
^ Matrícula ^ Aluno ^ Status |
^ NOME DO CURSO ^^^
| 9999999999 | NOME DO DISCENTE | STATUS |
| ------ | ------ | ------ |
Os discente são agrupados por curso. Para cada discente encontrado é possível //Visualizar Detalhes// ou //Selecionar// o discente para matrícula.
===Passo 2===
Após selecionar o discente desejado, são exibidas algumas informações:
* **__Discente__**: Formato - MATRÍCULA NOME DO DISCENTE. Tipo - TEXTO e NUMÉRICO. Possui opção de visualizar o Histórico do aluno.
* **__Matriz Curricular__**: Formato - CURSO - MATRIZ - TURNO. Tipo - TEXTO.
* **__Currículo__**: Tipo - NUMÉRICO.
Será apresentado ao usuário um formulário para busca de turma, e opções conforme explicadas abaixo:
* Selecionar outro discente: permite buscar um novo discente para realização da matrícula.
* Ver as turmas da Estrutura Curricular: visualiza as turmas criadas da estrutura curricular do discente.
* Ver equivalentes a Est. Curricular: exibe todas as turmas abertas dos componentes curriculares da sua estrutura curricular
=== Ver as turmas da Estrutura Curricular ===
**Quando o regime curricular do discente for o de bloco**
Exibe as turmas criadas para os componentes curriculares da estrutura curricular do curso até o período atual do discente. As turmas são agrupadas pelo período correspondente ao nível ao qual o componente curricular foi cadastrado na [[projetos:ufpi:requisitos:sigaa:graduacao:cdp:estrutura_curricular:cadastrar|Estrutura Curricular]], com a opção de poder selecionar todos os componentes ofertados. Caso haja mais de uma turma criada para o componente curricular, ao utilizar esta opção, o sistema deverá selecionar a primeira turma ofertada. Quando para um determinado componente curricular só existir uma turma, está virá selecionada e não será permitido desmarcá-la.
**Quando o regime curricular do discente for o de crédito**
Exibe as turmas criadas para os componentes curriculares de toda a estrutura curricular do curso do discente. As turmas são agrupadas pelo período correspondente ao nível ao qual o componente curricular foi cadastrado na estrutura curricular, com a opção de poder selecionar todos os componentes ofertados. Caso haja mais de uma turma criada para o componente curricular, ao utilizar esta opção, o sistema deverá selecionar a primeira turma ofertada.
Em cada grupo por nível, é exibido uma lista de componentes curriculares, com as respectivas turmas criadas, detalhando código da turma, os docente(s) o horário, o local onde será ministrado a aula e a quantidade de solicitações de matrícula até então. É dada a opção de listar turmas criadas para componentes curriculares equivalentes ou, no caso do discente não poder se matricular, os pré-requisitos necessários.
Para cada componente listado, é mostrado se é //permitida a matrícula do discente// ou se //não é permitida a matrícula do discente//, para as turmas, é exibido se a //turma possui vagas para seu curso// (no caso, o curso do discente). Também é possível //visualizar os detalhes// de cada turma listada, acessando essa opção, são exibidos:
* **Dados da Turma**
* **Ano/Período**: Formato - AAAA.9. Tipo - NUMÉRICO.
* **Componente e Turma**: Formato - CÓDIGO - NOME DO COMPONENTE - TURMA 99. Tipo - TEXTO e NUMÉRICO.
* **Tipo do Componente**: Tipo - TEXTO.
* **Créditos / Carga Horária**: Formato - 99 CR/99 Horas. Tipo - TEXTO e NUMÉRICO.
* **Tipo da Turma**: Tipo - TEXTO.
* **Local e Horário**: Formato - LOCAL/HORÁRIO (9X9/99X99). Tipo - TEXTO e NUMÉRICO.
* **Capacidade**: Formato - 99 alunos. Tipo - TEXTO e NUMÉRICO.
* **Totais**: Formato - 99 solicitações de matrícula. Tipo - TEXTO e NUMÉRICO.
* **Professores**: professores que irão ministrar a disciplina.
* **Vagas Reservadas**: número de vagas reservadas para determinado curso.
Da lista, quando permitido, o usuário poderá marcar as turmas que deseja matricular o discente e ao escolher a opção em "Adicionar Turmas", uma vez validada a seleção ([[#principais_regras_de_negócio|RN04]],[[#principais_regras_de_negócio|RN05]],[[#principais_regras_de_negócio|RN06]] e [[#principais_regras_de_negócio|RN07]]), será exibido formulário de turmas selecionadas, detalhado mais a frente.
=== Ver equivalentes a Estrutura Curricular ===
É similar à [[#Ver as turmas da Estrutura Curricular|Ver as turmas da Estrutura Curricular]], porém serão listadas as turmas criadas para os componentes curriculares equivalentes aos componentes da estrutura curricular que o discente está cursando.
=== Buscar Turmas Abertas ===
Similar à [[#Ver as turmas da Estrutura Curricular|Ver as turmas da Estrutura Curricular]], mas com a diferença que as turmas não são listadas automaticamente. O discente, neste caso, utilizará um formulário para buscar por turmas ofertadas informando pelo menos um dos seguintes parâmetros:
* **Código do Componente**: Formato - AAA9999. Tipo - TEXTO. Código do componente curricular.
* **Nome do Componente**: Tipo - TEXTO. Nome, ou parte do nome, do componente curricular.
* **Horário**: Tipo - TEXTO e NUMÉRICO. Horário da turma, utilizando o formato abreviado (M - Manhã; T - Tarde; N - Noite; de 1 à 6 - horário da aula. Ex.: 5M12).
* **Nome do Docente**: Tipo - TEXTO. Nome do docente da turma.
* **Unidade Responsável**: Tipo - TEXTO. Unidade responsável pela criação da turma.
A lista com o resultado da busca apresentará as turmas encontradas, com a opção de selecioná-la. A verificação de pré-requisitos, co-requisitos, ou choques de horários serão realizadas quando a opção "Adicionar Turmas" for selecionada ([[#principais_regras_de_negócio|RN04]], [[#principais_regras_de_negócio|RN05]], [[#principais_regras_de_negócio|RN06]] e [[#principais_regras_de_negócio|RN07]]).
=== Ver as Turmas Selecionadas ===
Ao adicionar uma turma para a matrícula, será dado ao usuário a possibilidade de ver as turmas selecionadas
No formulário será exibida as opções:
* **Selecionar outro discente**: seleciona outro discente para efetuar a matrícula.
* **Ver as turmas da Estrutura Curricular**: lista as turmas criadas para os componentes curriculares da estrutura curricular do curso do discente.
* **Ver equivalentes a Estrutura Curricular**: lista as turmas criadas para os componentes curriculares equivalentes aos da estrutura curricular do curso do discente.
* **Buscar Turmas Abertas**: busca por turmas abertas para componentes de outros currículos.
* **Matricular Discente**: confirma a solicitação de matrícula.
* **Sair sem salvar**: cancela a operação de solicitação de matrícula.
Em seguida, será exibido os detalhes do discente, com uma opção para gerar o histórico.
De forma resumida serão exibidos:
* **Turmas selecionadas**: exibe uma lista com as turmas selecionadas pelo usuário para matrícula. São detalhadas o código da turma, o componente curricular ([[#principais_regras_de_negócio|RN07]]), a carga horária/créditos, o docente e o local onde será ministrada a aula ([[#principais_regras_de_negócio|RN06]]). Ao final da listagem, será exibido o total de horas aula e créditos correspondentes.
* **Horários das turmas selecionadas**: na forma tabular de calendário semanal, com os dias de segunda à sábado na parte superior e horários na parte lateral, a célula correspondente ao dia/hora de aula da turma é preenchida com o código do componente curricular correspondente, conforme o 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 | --- |
Neste passo será permitido ao Coord. de Graduação a alteração da matrícula do discente caso já tenha sido realizada alguma. As alterações realizadas pelo coordenador são registradas.
===Passo 3===
=== Matricular Discente ===
Ao confirmar seleções das turmas a serem matriculadas, será apresentado ao usuário um resumo da solicitação, com um número de solicitação de matrícula, informações ao usuário, e a lista de turmas selecionadas. A lista de turmas detalha o código da turma, o código e nome do componente curricular, números de créditos, local de aulas e horário.
Em conformidade com as informações, o usuário confirma a operação em "Matricular Discente", onde será dado ao usuário a confirmação da operação com a opção de imprimir o comprovante de solicitação de matrícula. Neste comprovante exibirá as informações do discente, a lista de turmas e horário conforme descrito em [[#Ver as turmas da Estrutura Curricular|Ver as turmas da Estrutura Curricular]].
Durante esse procedimento serão realizadas as devidas validações para o regime curricular do discente ([[#principais_regras_de_negócio|RN12]], [[#principais_regras_de_negócio|RN13]] [[#principais_regras_de_negócio|RN14]]).
O caso de uso é finalizado.
===== Principais Regras de Negócio =====
* **RN01** - A matrícula só poderá ser realizada se os dados pessoais do discente estiverem atualizados. Os dados pessoais serão considerados desatualizados se até o início do período de matrículas não tenham sido atualizados.
* **RN02** - Não é permitido extrapolar o limite de créditos mínimos e máximos por semestre definido no currículo do discente. A exceção é quando o discente foi especialmente autorizado pela coordenação de seu curso para tal.
* **RN03** - Validações referentes às matrículas duplicadas em um mesmo componente
- Caso um aluno tenha sido aprovado em uma componente pertencente a um bloco mas não no bloco todo, ele poderá se matricular novamente, mesmo que tenha sido aprovado
- Caso o aluno tenha cumprido um componente através de uma equivalência ele não poderá se matricular nele.
* **RN04** - Os co-requisitos do componente das turmas deverão ser respeitados
* **RN05** - Os pré-requisitos do componente das turmas deverão estar integralizados (cumpridos previamente)
* **OBS.**: O aluno pode ter cumprido um pré-requisito através de um ou mais componentes equivalentes.
* **RN06** - Não é permitida a matrícula em turmas que tenha choque de horários
* **RN07** - Não é permitida a matrícula em turmas oferecidas por unidades localizadas em municípios diferentes daquele do curso do aluno.
* **RN08** - Caso um aluno se matricule em uma subunidade de um agrupamento, deverá se matricular em todas as outras
* **RN09** - Não é permitido ao aluno matricular-se em mais de 16 créditos (parâmetro atual) de disciplinas que não pertençam ao seu currículo atual.
* **RN10** - Somente componentes curriculares que possuem a propriedade ''MATRÍCULA ONLINE'' ativada poderão aparecer para o discente.
* **RN11** - O discente não poderá realizar a matrícula on-line se antes não tiver finalizado a Avaliação Institucional.
* **RN12** - O discente não poderá realizar a matrícula on-line se antes não tiver finalizado a Avaliação Institucional da Docência Assistida, se for o caso.
* **RN11** - Caso a turma selecionada pelo discente já tenha tido a sua capacidade de alunos superada, a matrícula do discente está condicionada a desistência de outros, seja na seleção inicial da turma ou durante o processamento da matrícula.
* **RN14** - Alunos de cursos a distância só realizam matrícula on-line caso o parametro ALUNO_EAD_FAZ_MATRICULA_ONLINE (2_10500_53) esteja configurado como TRUE.
* **RN15** - Alunos de cursos a distância devem definir o horário da tutoria presencial antes de realizar a matrícula on-line através do menu SIGAA -> Portal Discente -> Ensino -> Definir horário de tutoria presencial.
* **RN12** Quando o regime do curriculo do discente for o de bloco
- É mandatório realizar matricula em todas as disciplinas obrigatórias do nível atual.
- Poderá optar por se matricular ou não nas optativas do seu currículo, respeitando os pré-requisitos e devendo cumpri-las de acordo com a carga horária mínima exigida desse tipo de componente.
- Não poderá se matricular em disciplinas de níveis mais a frente ao que ele se encontra.
- Não poderá optar pelas disciplinas obrigatório a serem cursadas, salvo os casos em que houver disciplinas em dependência de períodos passados.
- Poderá optar pelo turno da turma, caso haja disponível mais de uma turma com reserva de vaga para determinada disciplina do seu nível.
- Poderá se matricular nas disciplinas do período, mesmo tendo sido reprovado em todas do período anterior, respeitando a validação dos pré-requisitos para as disciplinas do semestre.
* **RN13** Quando o regime do curriculo do discente for o de créditos
- Poderá optar por se matricular ou não nas obrigatórias do seu período.
- Poderá se matricular em disciplinas de níveis mais a frente ao que ele se encontra.
* **RN14** - Em qualquer regime curricular o discente só poderá se matricular em componentes curriculares vinculadas ao currículo do seu curso. Caso seja uma disciplina equivalente a uma de seu currículo ele poderá pagar também.
* **RN15** - Para discentes ingressantes as seguintes regras se aplicam:
- O ingressante é obrigado a matricular-se nas disciplinas obrigatórias do primeiro período do seu currículo.
- É permitido ao ingressante matricular-se em disciplinas optativas do seu currículo.
- O ingressante poderá optar pelo turno da turma, caso haja disponível mais de uma turma com reserva de vaga para determinada disciplina do seu nível.
* **RN16** - O discente só poderá acessar a área de turmas abertas de componentes fora do seu currículo quando:
- seu currículo tiver CH eletiva ("CH Máxima de Componentes Eletivos" maior que zero, ou o total da carga horária de Atividades Complementares Eletivas do currículo for maior que zero)
- e se ainda não extrapolou o limite essa CH eletiva do seu currículo
* **RN17** - O discente só poderá se matricular em turmas de componentes do seu currículo que tiver reserva para sua matriz curricular ou nenhuma reserva para nenhuma matriz
==== Resoluções/Legislações Associadas ====
Não se aplica
===== 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 |
| br.ufrn.sigaa.ensino.dominio.DocenteTurma | sigaa.ensino.docente_turma |
| br.ufpi.sigaa.ensino.graduacao.dominio.AlteracaoMatriculaCoordenador | sigaa.graduacao.alteracao_matricula_coordenador |
====== Plano de Teste ======
Sistema: SIGAA
Módulo: Graduação
Link(s): Matrículas e Programas -> Matrículas -> Matricular Aluno
Usuário:
Papel que usuário deve ter: Possui a designação de coordenador de graduação. Isso pode ser realizado no Módulo Graduação > Administração > Coordenadores de Curso > Identificar Coordenador
===== Cenários de Teste =====
- Tentar matricular em diversas turmas do currículo
- Remover uma turma selecionada de um componente curricular obrigatório (quando o regime do currículo do discente for o de bloco) e tentar realizar a matrícula
- Remover uma turma previamente cadastrada (alteração das matrículas do discente) de um componente obrigatório e do período corrente do discente
- Selecionar turmas de outros currículos e que não sejam equivalentes a algum componente do currículo
- Tentar matricular um aluno numa turma cujo componente curricular possua um pré-requisito que o aluno considerado tenha cumprido através de um outro componente curricular equivalente.
- Buscar por componente curriculares através dos filtros pré-requisito, co-requisito e equivalência. E visualizar as informações dos mesmos, para verificar se os dados coincidem com o retorno para os filtros utilizados. Os dados dos componente curriculares podem ser alterado em Buscar/Alterar Componentes, para auxiliar a execução dos testes.
===== Dados para o Teste =====
* Ajustar o período de matrículas on-line no calendário acadêmico para que seja permitida a realização dos testes
* Cadastrar um curso e sua estrutura curricular
* Criar as turmas para os componentes curriculares do curso
* Cadastrar um discente regular vinculado ao curso cadastrado e criar o seu acesso através do cadastro na página inicial do SIGAA
* Acessar o sistema com o discente cadastrado
* Tentar realizar a matrícula verificando as regras de negócio
-- Encontrando uma pessoa para testar a verificação dos dados atualizados
select * from comum.pessoa where nome ilike 'nome do aluno que se deseja encontrar%'
-- Atualiza o campo 'ultima_atualizacao'
update comum.pessoa set
ultima_atualizacao = 'data anterior ao dia em que se está testando. No formato: 2012-03-08 10:07:33.728'
where id_pessoa = [id da pessoa encontrada na consulta acima]
-- Após a execução das cláusulas SQL, tentar acessar a matrícula com o discente que teve seus dados alterados acima.