[[sigaa:lato_sensu:documentacao_tecnica:busca_geral_de_turmas| << Voltar]] 

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


====== 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 do DAE (Departamento de Administração Escolar).

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

Este caso de uso inicia-se quando a opção //SIGAA -> Graduação -> 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;
    * **Duplicar Turma**: os dados da turma serão copiados e o usuário será redirecionado para o caso de uso de [[desenvolvimento:especificacoes:sigaa:portal_do_docente:casos_de_uso:chefia:turmas:criar_turma_sem_solicitacao|cadastro de 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, os quais são:
      * **__Componente Curricular__**: Tipo - TEXTO.
      * **__Tipo do Componente__**: Tipo - TEXTO.
      * **__CH __**<del> / Créditos</del>: Tipo - TEXTO.
      * **__Tipo da Turma__**: Tipo - TEXTO.
      * **__Docente(s)__**: Tipo - TEXTO.
      * **__Código da Turma__**: Tipo - TEXTO.
      * **__Local__**: Tipo - TEXTO.
      * **__Horário__**: Tipo - TEXTO.
      * **__Ano-Período__**: Tipo - NUMÉRICO.
      * **__Período de Aulas__**: Tipo - TEXTO.
      * **__Modalidade__**: Tipo - TEXTO.
      * **__Capacidade de Alunos__**: Tipo - NUMÉRICO.
    * **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 (exceto se for DAE).
  * **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.
  * **RN16** - O chefe do departamento poderá duplicar uma turma existente no período de ajuste de turmas.

==== 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: Graduação

Link(s): Consultas -> Consultas Gerais -> Turmas

Usuário: adelardo, vanessa

Papel que usuário deve ter: SigaaPapeis.DAE

===== 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.

<code>
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
</code>