~~ODT~~
echo "";
echo "Última atualização: ";
ver('', false);
echo "
";
====== Consultar Turma ======
Entende-se por turma algo que seja composto por componentes curriculares, horário, docente e discente.
As turmas são criadas nos módulos [[desenvolvimento:especificacoes:sigaa:infantil:casos_de_uso:alunos:turmas:cadastrar|Infantil]], [[desenvolvimento:especificacoes:sigaa:tecnico:casos_de_uso:turma:turma:cadastrar|Técnico]], [[desenvolvimento:especificacoes:sigaa:graduacao:casos_de_uso:matriculas_e_programas:turmas:criar_turma|Graduação]], [[desenvolvimento:especificacoes:sigaa:lato_sensu:casos_de_uso:turma:turma:criar_turma|Lato Sensu]], [[desenvolvimento:especificacoes:sigaa:stricto_sensu:casos_de_uso:vinculos_matriculas:turmas:criar_turma|Stricto Sensu]], e [[desenvolvimento:especificacoes:sigaa:ensino_a_distancia:casos_de_uso:coordenacao:turmas:cadastrar|Ensino à Distância]], ou solicitadas nos portais [[desenvolvimento:especificacoes:sigaa:portal_coordenador_graduacao:casos_de_uso:turmas:solicitar_abertura_de_turmas|Coordenador de Graduação]], [[desenvolvimento:especificacoes:sigaa:portal_coordenador_lato_sensu:casos_de_uso:turmas:cadastrar_turma|Coordenador Lato Sensu]] e [[desenvolvimento:especificacoes:sigaa:portal_coordenador_stricto_sensu:casos_de_uso:turmas:criar_turma|Coordenador de Stricto Sensu]], para que os alunos possam cumprir o [[desenvolvimento:especificacoes:sigaa:graduacao:casos_de_uso:ddp:estrutura_curricular:cadastrar|currículo do seu curso]].
De forma similar, este caso de uso é usado em vários portais e módulos do SIGAA, permitindo ao usuário buscar por turmas criadas. Essa funcionalidade é utilizada pelos funcionários da CAENE (Comissão Permanente de Apoio a Estudantes com Necessidades Educacionais Especiais).
===== Descrição do Caso de Uso =====
Este caso de uso inicia-se quando a opção //SIGAA -> NEE -> Relatórios/Consultas -> Consultas Gerais -> Turma// é acessada.
Para realizar a busca por uma turma, o usuário poderá informar os parâmetros para restringir a busca:
* **Nível:** Tipo - TEXTO. Restringe a busca pelo nível de ensino (infantil, médio, técnico, graduação, especialização, stricto sensu, mestrado, ou doutorado);
* **Ano - Período:** Formato - AAAA.9. Ano-período da turma;
* **Unidade:** Formato - TEXTO. Unidade que ofertou a turma;
* **Código do componente:** Formato - AAA9999. Código do componente curricular ofertado da turma;
* **Código da turma:** Formato - 99. Tipo - NUMÉRICO. O código serve para diferenciar as várias turmas criadas para a oferta de matrícula em um mesmo componente curricular;
* **Local:** Tipo - TEXTO e NUMÉRICO. Local das aulas da turma;
* **Nome do componente:** Tipo - TEXTO. Nome, ou parte do nome, do componente curricular ofertado na turma;
* **Nome do docente:** Tipo - TEXTO. Nome do docente que ministrará as aulas na turma;
* **Ofertadas ao curso:** Tipo - TEXTO. Esta opção surge apenas para turmas do nível de Graduação e restringe a busca à turmas que possuam reserva de vagas para o curso escolhido;
* **Pólo:** Tipo - TEXTO. Pólo de funcionamento do curso à distância;
* **Situação:** Tipo - TEXTO. Situação da turma (a definir docente, aberta, ou consolidada, podendo escolher todas);
* **Tipo:** Tipo - TEXTO. Tipo da turma (regular, férias, ou ensino individual, podendo escolher todas);
* **Somente turmas vinculadas ao Convênio Probásica:** Tipo - LÓGICO. Ao marcar esta opção, serão buscadas somente as turmas criadas no Convênio Probásica;
* **Exibir resultado da consulta em formato de relatório:** Tipo - LÓGICO. Exibe o resultado da busca no formato de relatório.
* **Ordenar por:** Tipo - TEXTO. Oferece alternativas de ordenação para o resultado da busca. São apresentadas as opções: ''ORDENAR POR COMPONENTE CURRICULAR, ORDENAR POR DIAS DA SEMANA E RESPECTIVOS HORÁRIOS, ORDENAR POR DOCENTE, DISCIPLINAS E RESPECTIVOS HORÁRIOS, ou ORDENAR POR LOCAL''.
O resultado da busca lista as turmas informando o Código, docente(s), tipo, situação, horário, local, a quantidade de discentes matriculados e a capacidade da turma.
^ Ano Período ^ Docente(s) ^ Tipo ^ Situação ^ Horário ^ Local ^ Mat./Cap. |
^ CÓDIGO - NOME DA DISCIPLINA (NÍVEL) ^^^^^^^^
| AAAA.2 | Tipo - TEXTO | Tipo - TEXTO | Tipo - TEXTO | Tipo - TEXTO e NUMÉRICO | Tipo - TEXTO e NUMÉRICO | Tipo - NUMÉRICO |
| ------ | ------ | ------ | ------ | ------ | ------ | ------ |
Dependendo das permissões do usuário, pode-se:
* **Adicionar Reserva:** adiciona uma reserva de vagas para um determinado curso;
* **Alterar:** altera os dados da turma;
* **Cadastrar Notícia:** cadastra uma [[desenvolvimento:especificacoes:sigaa:turma_virtual:casos_de_uso:portal_do_docente:menu_turma_virtual:turma:noticias|notícia]] para turma.
* **Diário de turma:** emite o diário de turma;
* **Lista de Frequência:** emite a lista de frequência de uma turma (lista a ser assinada pelos discentes);
* **Fechar Turma:** muda o status da turma para CONSOLIDADA;
* **Listar Alunos:** lista os alunos da turma, informando a matrícula, nome, matriz curricular, e situação da matrícula;
* **Notas dos alunos:** gera um relatório das notas dos alunos;
* **Notas dos tutores:** lista as notas dos tutores;
* **Processamento da Matrícula:** exibe o resultado do processamento da matrícula para a turma;
* **Processamento da Rematrícula:** exibe o resultado do processamento da rematrícula para a turma;
* **Reabrir turma:** muda o status da turma para ABERTA, mudando o status dos alunos da turma para MATRICULADO.
* **Remover:** remove a turma;
* **Visualizar Turma:** visualiza os dados da turma (dados do componente curricular, docentes, código da turma, local, horário, ano-período, capacidade e reservas)
* **Alterar Status de Matrícula:** direciona o usuário para [[desenvolvimento:especificacoes:sigaa:graduacao:casos_de_uso:matriculas_e_programas:matriculas:alterar_status_de_matricula_por_turmas|Alterar o Status de Matrícula da Turma]].
* **Visualizar Turma Virtual:** direciona o usuário para a [[desenvolvimento:especificacoes:sigaa:turma_virtual:principal|turma virtual]].
* **Enviar E-mail** direciona o usuário para o [[desenvolvimento:especificacoes:sigaa:portal_do_docente:casos_de_uso:ensino:consultas:turmas:enviar_mensagem_turma]].
O caso de uso é finalizado.
===== Principais Regras de Negócio =====
* **RN01** - O usuário deverá informar um parâmetro para realizar a busca.
* **RN02** - Adicionar Reserva
* **RN02.1** - permitido somente usuários da PROGRAD ou do DAE;
* **RN02.2** - o total de reservas não pode ser superior à capacidade da turma;
* **RN02.3** - não é permitido cadastrar duas reservas para a mesma matriz.
* **RN03** - Alterar: altera os dados da turma
* **RN03.1** - Não é possível alterar turmas que não estão abertas. Caso seja usuário da PROGRAD ou do DAE, permitir emitindo um aviso que a turma não está aberta;
* **RN03.2** - Não é permitido alterar uma turma de um nível de ensino ao qual o usuário não tem permissão. Por exemplo, o DAE só pode alterar turmas de graduação;
* **RN04** - Cadastrar Notícia
* **RN04.1** - Caso seja o usuário seja coordenador de curso, ele terá permissão de cadastrar notícias apenas para as turmas criadas para o curso o qual coordena;
* **RN05** - Diário de turma: disponível apenas para coordenadores de curso (graduação ou stricto sensu), secretaria de pós-graduação, Pro Reitoria de Pós-Graduação, DAE, chefe de departamento ou gestor de curso à distância;
* **RN06** - Lista de Frequência: disponível para coordenador de curso stricto sensu, secretários de pós-graduação, Pro Reitoria de Pós-Graduação, ou usuários do DAE;
* **RN07** - Fechar Turma: somente usuários da PROGRAD ou do DAE poderão realizar esta operação;
* **RN07.1** - A turma não deve possuir nenhum aluno matriculado.
* **RN07.2** - A turma não deve possuir nenhum aluno com solicitação de matrícula.
* **RN08** - Listar Alunos: disponível para usuários da PROGRAD ou DAE; chefes e secretários de departamento, desde que a turma seja do departamento; coordenadores ou secretários de curso de stricto sensu, desde que a turma seja do programa; gestor técnico; docente; ou secretário de curso de graduação;
* **RN09** - Notas dos alunos: disponível para gestores do Ensino à Distância, tutores de Ensino à Distância ou coordenadores e secretários de curso de lato sensu;
* **RN10** - Notas dos tutores: disponível para usuários com permissão de gestão de ensino à distância;
* **RN11** - Processamento da Matrícula: disponível apenas para turmas de graduação e se a matrícula estiver processada;
* **RN12** - Processamento da Rematrícula: disponível apenas para turmas de graduação e se a matrícula estiver processada;
* **RN13** - Reabrir Turma: permitido apenas para PROGRAD; DAE; ou Gestor de Curso Lato Sensu
* **RN13.1** - A turma deve estar consolidada para ser reaberta.
* **RN14** - Remover: disponível ao chefe ou secretário do departamento, desde que a turma pertença ao departamento; coordenador ou secretário do curso stricto sensu, desde que a turma pertença ao programa; coordenador de curso, desde que a turma pertença ao curso; PROGRAD; DAE; ou a usuários de gestão de Cursos à distância;
* **RN14.1** - Não é possível excluir a turma se possuir alunos matriculados.
* **RN15** - Visualizar Turma Virtual: disponível para todos desde que esta esteja disponível para acesso público; disponível para chefes de departamento, desde que a turma seja do departamento; PROGRAD; DAE; ou usuário gestor de curso técnico, desde que as turmas sejam da unidade do gestor, disponível para discentes que participam da turma.
==== Resoluções/Legislações Associadas ====
Não se aplica.
===== Classes Persistentes e Tabelas Envolvidas =====
^ Classe ^ Tabela |
| br.ufrn.sigaa.dominio.Curso | sigaa.public.curso |
| br.ufrn.sigaa.dominio.ModalidadeEducacao | sigaa.comum.modalidade_educacao |
| br.ufrn.sigaa.ead.dominio.Polo | sigaa.ead.polo |
| br.ufrn.sigaa.dominio.Unidade | sigaa.comum.unidade |
| br.ufrn.sigaa.ensino.dominio.DocenteTurma | sigaa.ensino.docente_turma |
| br.ufrn.sigaa.ensino.dominio.Turma | sigaa.ensino.turma |
| br.ufrn.sigaa.pessoa.dominio.Pessoa | sigaa.comum.pessoa |
| br.ufrn.sigaa.ensino.dominio.MatriculaComponente | sigaa.ensino.matricula_componente |
====== Plano de Teste ======
Sistema: SIGAA
Módulo: NEE
Link(s): Relatórios/Consultas -> Consultas Gerais -> Turma
Usuário: ricardolins
Papel que usuário deve ter: SigaaPapeis.GESTOR_NEE
===== Cenários de Teste =====
Será Necessário cadastrar uma turma em um componente curricular vinculado a uma unidade de coordenação de curso, para aplicar os testes de exibição das turmas. Cadastre uma turma em ([[desenvolvimento:especificacoes:sigaa:graduacao:casos_de_uso:matriculas_e_programas:turmas:criar_turma| Criar Turma]]) para uma componente do tipo atividade, com a Forma de Participação: ATIVIDADE ESPECIAL COLETIVA, e o parâmetro: "Aceita Criar Turma: Sim". Após realizar a criação da turma verificar se a turma é listada quando utiliza-se o filtro **Unidade** e selecionando a Coordenação de Curso da turma criada.
===== Dados para o Teste =====
A seguir uma consulta para listar os componentes curriculares vinculados a coordenações de curso.
select u.nome, ccd.nome, cc.codigo, t.descricao as "Tipo de Componente", ta.descricao as "Tipo de Atividade", forma.descricao as "Forma de Participação" from ensino.componente_curricular cc
inner join comum.unidade u using(id_unidade)
inner join ensino.componente_curricular_detalhes ccd ON ccd.id_componente_detalhes = cc.id_detalhe and ccd.id_componente = cc.id_disciplina
inner join ensino.tipo_componente_curricular t ON t.id_tipo_disciplina = cc.id_tipo_componente
inner join ensino.tipo_atividade ta ON cc.id_tipo_atividade = ta.id_tipo_atividade
inner join ensino.forma_participacao_atividade forma ON forma.id_forma_participacao = cc.id_forma_participacao
where u.tipo_academica = 6