====== Consultar Turmas ======

Esse caso de uso realiza a consulta de [[desenvolvimento:especificacoes:sigaa:graduacao:casos_de_uso:matriculas_e_programas:turmas:criar_turma|Turmas]]. Essa operação pode ser realizada por qualquer discente em qual quer época do ano.

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

Essa operação consiste na consulta de uma turma de graduação, que poder ser filtrada por um dos campos abaixo:

  * Nível: Nível esse para a consulta da turma, já vem selecionado o nível graduação;
  * Ano-período: Ano e período, para a realização da busca, já vem o ano e período atual;
  * Unidade: Tem como finalidade filtrar pelo departamento, coordenação, dentre outros.
  * Código do componente: Tem como finalidade filtrar pelo código do componente desejado;
  * Código da turma: Tem como finalidade filtrar pelo código da turma desejada;
  * Local: Tem como finalidade filtrar pelo local da turma desejada;
  * Horário: Tem como finalidade filtrar pelo horário da turma desejada;
  * Nome do componente: Tem como finalidade filtrar pelo nome do componente;
  * Nome do docente: Tem como finalidade filtrar pelo nome do docente;
  * Ofertadas ao curso: Tem como finalidade filtrar pelas turma ofertadas para o curso selecionado;
  * Pólo: Tem como finalidade filtrar pelo pólo desejado (para turmas de Ensino a Distância);
  * Situação: Tem como finalidade filtrar pela situação da turma;
  * Tipo: Tem como finalidade filtrar pelo tipo da turma;
  * Somente turmas vinculadas ao Convênio Probásica: Tem como finalidade filtrar pelas turmas vinculadas ao Convênio Probásica;
  * Exibir resultado da consulta em formato de relatório: Tem como finalidade exibir as informações no formato de relatório;
  * Emitir Diário de Classe: Tem como finalidade emitir o diário da turma consolidada.

A listagem da(s) turma(s) que atende(m) ao(s) filtro(s) selecionado(s) é exibido da seguinte forma:

  * Código: Código da turma;
  * Docente(s): Docente(s) ministrante da turma; 
  * Tipo: Tipo de turma;
  * Situação: Situação da turma(Ex.: ABERTA, A DEFINIR DOCENTE).
  * Horário: Horário em que a disciplina será ministrada;
  * Local: Local onde a disciplina será ministrada;
  * Mat./Cap.: Número de discentes matriculados pela capacidade total;
  * E uma opção para visualizar um Menu, onde o discente pode visualizar, desde que a opção não esteja selecionada:
    * O Processamento de Matrícula
    * O processamento da Rematrícula
    * Visualizar dados da Turma
  * Com a opção Emitir Diário de Classe selecionada é exibido uma seta para a geração do diário da turma.

Se o usuário selecionar a opção "Exibir resultado da consulta em formato de relatório" a listagem exibida é igual a listagem acima descrita, modificando apenas o cabeçalho.

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

Não se aplica.

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

^ Classe ^ Tabela |
| br.ufrn.sigaa.ensino.dominio.Turma | sigaa.ensino.turma |
| br.ufrn.sigaa.ensino.dominio.SituacaoTurma | sigaa.ensino.situacao_turma |
| br.ufrn.sigaa.ensino.dominio.ComponenteCurricular | sigaa.ensino.componente_curricular |
| br.ufrn.sigaa.ead.dominio.Polo | sigaa.ead.polo |
| br.ufrn.sigaa.ensino.dominio.DocenteTurma | sigaa.ensino.docente_turma |
| br.ufrn.sigaa.ensino.dominio.HorarioTurma | sigaa.ensino.horario_turma | 
| br.ufrn.sigaa.ensino.graduacao.dominio.ReservaCurso | sigaa.graduacao.reserva_curso |
| br.ufrn.sigaa.ensino.tecnico.dominio.EspecializacaoTurmaEntrada | sigaa.tecnico.especializacao_turma_entrada |
| br.ufrn.sigaa.dominio.Curso | sigaa.curso |
| br.ufrn.sigaa.ensino.graduacao.dominio.TurmaSolicitacaoTurma | sigaa.graduacaoturma_solicitacao_turma |
| br.ufrn.sigaa.dominio.CampusIes | sigaa.comum.campus_ies |
| br.ufrn.sigaa.dominio.Usuario | sigaa.comum.usuario |

Obs.: Não há classe persistente, pois é gerado apenas uma consulta ou um relatório.

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

Sistema: SIGAA

Módulo: Graduação

Link(s): Consultas -> Turmas

Usuário: Qual quer secretário de Departamento

Papel que usuário deve ter: SigaaPapeis.SECRETARIA_DEPARTAMENTO

===== Cenários de Teste =====

Entrar como um Secretário de Departamento busca turmas do departamento do usuário logado e com a situação Consolidada e tentar realizar a emissão de seus diários de turma.

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

 Não se aplica.