~~ODT~~

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


====== Consulta Geral de Discentes ======

Este caso de uso permite ao pessoal do DAE e do CDP realizarem uma consulta de discentes com um nível maior de refinamento com relação a outras consultas no sistema. Além de listar os discentes de acordo com os filtros, o usuário também pode visualizar o histórico do discente em formato PDF.

Esta operação pode ser realizada a qualquer momento, uma vez que o pessoal do DAP ou CDP precise encontrar alunos com determinadas características.


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

Este caso de uso inicia-se quando a opção //SIGAA -> Graduação -> Consultas -> Consultas Gerais -> Consulta Geral de Discentes// é acessada.

Ao acessar a tela de busca, os seguintes parâmetros abaixo serão exibidos. Para cada parâmetro, é possível filtrar o resultado da pesquisa.

  * **Matrícula**: Formato - 9999999999. Tipo - NUMÉRICO.
  * **Nome**: Formato - NOME DO DISCENTE. Tipo - TEXTO.
  * **Idade**: Formato - DE 99 até 99. Tipo - NUMÉRICO.
  * **Sexo**: Tipo - TEXTO. Com as opções: ''FEMININO, MASCULINO ou AMBOS''.
  * **Tipo**: Tipo - TEXTO.Com as opções: ''REGULAR ou ESPECIAL''.
  * **Nível de Ensino**:  Tipo - TEXTO. Com as opções: ''INFANTIL, MÉDIO, TÉCNICO, GRADUAÇÃO, ESPECIALIZAÇÃO, RESIDÊNCIA MÉDICA/MULTI-PROFISSIONAL, STRICTO SENSU, MESTRADO ou DOUTORADO''.
  * **Status**: Tipo - TEXTO. Com as opções: ''ATIVO, CADASTRADO, CANCELADO, CONCLUÍDO, DEFENDIDO, EM HOMOLOGAÇÃO, EXCLUÍDO, FORMANDO, GRADUANDO ou TRANCADO''.
  * **Forma de Ingresso**: Tipo - TEXTO. 
  * **Forma de Ingresso Ativa**: Tipo - TEXTO. Substitui 'Forma de Ingresso', caso o Nível de Ensino selecionado seja GRADUAÇÃO.
  * **Forma de Ingresso Inativa**: Tipo - TEXTO. Carrega juntamente com 'Forma de Ingresso Ativa', obedecendo as mesmas condições.
  * **Ano Ingresso**: Formato - AAAA. Tipo - NUMÉRICO.
  * **Período Ingresso**: Formato - 9. Tipo - NUMÉRICO.
  * **Índices Acadêmicos**: Tipo - TEXTO.
  * **Tipo de Saída**: Tipo - TEXTO.
  * **Ano Saída**: Formato - AAAA. Tipo - NUMÉRICO.
  * **Período Saída**: Formato - 9. Tipo - NUMÉRICO.
  * **Matriculados em**: Formato - AAAA-9. Tipo - NUMÉRICO. Ano e período de matrícula, sendo apenas o ano obrigatório caso esta opção seja escolhida.
  * **Não Matriculados em**: Formato - AAAA-9. Tipo - NUMÉRICO.
  * **Trancados em**: Formato - AAAA-9. Tipo - NUMÉRICO.
  * **Estado**. Tipo - TEXTO.
  * **Cidade**: Tipo - TEXTO. 
  * **Nacionalidade**: Tipo - TEXTO.
  * **Necessidade Especial**: Tipo - TEXTO. Com as opções: ''TODAS, ALTAS HABILIDADES, AUDITIVAS, CONDUTAS TÍPICAS, FÍSICA, MENTAL, MÚLTIPLA, OUTRAS NECESSIDADES ou VISUAL''.
  * **Trazer informações em formato de relatório**. Tipo - LÓGICO. Retorna um relatório pronto para impressão.
  * **Gerar CSV**. Tipo - LÓGICO. Retorna um arquivo no formato CSV.

Alguns campos a mais podem surgir dependendo do "Nível de Ensino" escolhido:
  * **Técnico**
    * **Escola**: Tipo - TEXTO.
    * **Curso**: Tipo - TEXTO.
    * **Turma de Entrada**: Tipo - TEXTO.
    * **Especialidade**: Tipo - TEXTO.

  * **Graduação**
    * **Centro**: Tipo - TEXTO.
    * **Curso**: Tipo - TEXTO.
    * **Matriz Curricular**: Tipo - TEXTO.
    * **Currículo**: Formato - 9... Tipo - NUMÉRICO.
    * **No Período**: Formato - 99. Tipo - NUMÉRICO. "Número" que identifica o período.
    * **Turno**: Tipo - TEXTO.
    * **Modalidade**: Tipo - TEXTO.
    * **Prazo Máximo de Conclusão**: Formato - AAAA/9. Tipo - NUMÉRICO. 
    * **Convênio**: Tipo - TEXTO.
    * **Pólo**: Tipo - TEXTO.
    * **Participação ENADE**: Tipo - TEXTO.
    * **Aprovado na Opção (Vestibular)**: Tipo - NUMÉRICO. Em qual opção o aluno foi aprovado no vestibular (1º opção, 2º opção). 
    * **Desconsiderar Apostilamentos**: Tipo - LÓGICO.

  * **Especialização**
    * **Curso**: Tipo - TEXTO.

  * **Strictu Sensu/Mestrado/Doutorado**
    * **Programa**: Tipo - TEXTO.
    * **Currículo**: Tipo - TEXTO.
    * **Com previsão de qualificação (alunos que concluíram as disciplinas e devem fazer a qualificação)**: Tipo - LÓGICO.
    * **Com previsão de defesa (alunos concluintes, que cumpriram todas as obrigações e devem defender a dissertação/tese)**: Tipo - LÓGICO.
    * **Com prazo esgotado**: Tipo - LÓGICO.
    * **Com prazo a ser esgotado em**: Formato - DD/MM/AAAA. Tipo - DATA.
    * **Com prazo prorrogado**: Tipo - LÓGICO.
    * **Discentes com diplomas homologados pela PPg e ainda não formados**: Tipo - LÓGICO.
    * **Discentes que defenderam mas não foram homologados**: Tipo - LÓGICO.

O resultado deve seguir o seguinte modelo:

^ Matrícula ^ Nome ^  Status |
| 9999999999 | NOME DO DISCENTE | STATUS |
| ------ | ------ | ------ | 

Para cada discente listado, é possível efetuar o download do [[desenvolvimento:especificacoes:sigaa:graduacao:casos_de_uso:alunos:documentos:emitir_historico|Histórico]] do aluno.

O caso de uso é finalizado.

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

 Não se aplica.

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

Não há.

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

^ Classe ^ Tabela |
| br.ufrn.sigaa.pessoa.dominio.Discente | sigaa.public.discente |
| br.ufrn.sigaa.ensino.graduacao.dominio.DiscenteGraduacao | sigaa.graduacao.discente_graduacao |
| br.ufrn.sigaa.dominio.Curso | sigaa.public.curso |

OBS: não há persistência envolvida. Apenas consultas.

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

Sistema: SIGAA

Módulo: Graduação

Link(s): Consultas -> Consultas Gerais -> Consulta Geral de Discentes

Usuário: lins, mirza, mittelbach

Papel que usuário deve ter: SigaaPapeis.DAE, SigaaPapeis.CDP
===== Cenários de Teste =====
Não se aplica.

===== Dados Para o Teste =====
Os dados pessoais e acadêmicos dos alunos podem ser conferidos em: 
  * Módulo Graduação -> Alunos -> Dados do Discente -> Atualizar Dados Pessoais
  * Módulo Graduação -> Alunos -> Dados do Discente -> Consultar Dados do Aluno
  * Módulo Graduação -> Alunos -> Documentos -> Emitir Histórico