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

====== Convocação de Candidatos para Vagas Remanescentes ======

Este caso de uso permite que o usuário convoque candidatos aprovados no vestibular para o preenchimento de vagas remanescentes.

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

Este caso de uso inicia quando o usuário acessa a opção: //SIGAA -> Graduação -> Administração -> Cadastramento e Reconvocações do Vestibular -> Convocação de Candidatos para Vagas Remanescentes//.

==== Passo 1 ====

Ser solicitado do usuário os seguintes parâmetros:

  * **Processo Seletivo Vestibular***: Tipo - TEXTO.
  * **__Estratégia de convocação__**: Tipo - TEXTO. Informa qual é a estratégia de convocação associada ao processo seletivo.
  * **Descrição***: Tipo - TEXTO.
  * **Semestre a Convocar***: Tipo - Texto. Quando o processo seletivo possui entrada nos dois períodos letivos, define se a convocação para vagas remanescentes será para as vagas do 1º e 2º semestre ou apenas para vagas remanescentes no 2º semestre.
  * **Data da Convocação***: Tipo - DATA.
  * **Percentual Adicional de Vagas**: Tipo - NUMÉRICO.
  * **Aplicar o Percentual Adicional de Vagas à vagas reservadas para Cotistas**: Tipo - LÓGICO.
  * **Considerar discentes com status PENDENTE DE CADASTRO como ocupando vaga remanescente**: Tipo - LÓGICO.
  * **Considerar discentes com status PRÉ-CADASTRADO como ocupando vaga remanescente**: Tipo - LÓGICO.

==== Passo 2 ====

Serão calculadas as vagas remanescentes por matriz curricular e exibida para que o usuário possa alterar os valores:

  * **__Processo Seletivo Vestibular__**: Tipo - TEXTO.
  * **__Estratégia de convocação__**: Tipo - TEXTO. Informa qual é a estratégia de convocação associada ao processo seletivo.
  * **__Descrição__**: Tipo - TEXTO.
  * **__Semestre a Convocar__**: Tipo - Texto. Quando o processo seletivo possui entrada nos dois períodos letivos, define se a convocação para vagas remanescentes será para as vagas do 1º e 2º semestre ou apenas para vagas remanescentes no 2º semestre.
  * **__Data da Convocação__**: Tipo - DATA.
  * **__Percentual Adicional de Vagas__**: Tipo - NUMÉRICO.


^ Curso / Matriz Curricular ^ Vagas Ofertadas ^ Quant. a Convocar ^  Quantidade por Grupo de Cotas  ^^^^
^ ^ ^ ^ L1 ^ L2 ^ L3 ^ L4 |
| Tipo -TEXTO. | Tipo - NUMÉRICO | Tipo - NUMÉRICO | Tipo - NUMÉRICO | Tipo - NUMÉRICO | Tipo - NUMÉRICO | Tipo - NUMÉRICO |



==== Passo 3 ====

Dados os cursos com vagas não preenchidas o SIGAA gera convocações para os candidatos. Feito isso, será apresentado ao usuário um resumo da convocação:

  * **__Processo Seletivo Vestibular__**: Tipo - TEXTO.
  * **__Descrição__**: Tipo - TEXTO.
  * **__Data da Convocação__**: Tipo - TEXTO.

^ CURSO (Tipo - TEXTO) ^^^^^^|
^ Ordem (Tipo - NUMÉRICO) ^ Nº Inscrição (Tipo - NUMÉRICO) ^ CPF (Tipo - NUMÉRICO) ^ Nome (Tipo - TEXTO) ^ Classificação (Tipo - NUMÉRICO) ^ Ingresso (Tipo - TEXTO) ^ Tipo de Convocação (Tipo - TEXTO) |
|
|  -  |  -  |  -  |  -  |  -  |  -  |  -  |

O usuário, verificado o resumo da convocação, poderá confirmar e convocar os candidatos listados.

O caso de uso se encerra.

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

  * **RN01** : Candidato que foi convocado para a segunda opção de curso poderá ser reconvocado para o curso de primeira opção, caso haja vaga.

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

Não se Aplica.  

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

^ Classe ^ Tabela |
| br.ufrn.sigaa.vestibular.dominio.ConvocacaoProcessoSeletivoDiscente | sigaa.vestibular.convocacao_processo_seletivo_discente |
| br.ufrn.sigaa.vestibular.dominio.InscricaoVestibular | sigaa.vestibular.inscricao_vestibular |
| br.ufrn.sigaa.vestibular.dominio.PessoaVestibular | sigaa.vestibular.pessoa_vestibular |
| br.ufrn.sigaa.vestibular.dominio.ConvocacaoProcessoSeletivo | sigaa.vestibular.convocacao_processo_seletivo |
| br.ufrn.sigaa.vestibular.dominio.ResultadoClassificacaoCandidato | sigaa.vestibular.resultado_classificacao_candidato |
| br.ufrn.sigaa.vestibular.dominio.ProcessoSeletivoVestibular | sigaa.vestibular.processo_seletivo |
| br.ufrn.sigaa.ensino.graduacao.dominio.MatrizCurricular | sigaa.graduacao.matriz_curricular |
| br.ufrn.sigaa.dominio.Curso | sigaa.curso |
| br.ufrn.sigaa.vestibular.dominio.ResultadoOpcaoCurso | sigaa.vestibular.resultado_opcao_curso |
| br.ufrn.sigaa.ensino.graduacao.dominio.Curriculo | sigaa.graduacao.curriculo |

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

Sistema: SIGAA

Módulos: Graduação

Link(s): Administração -> Cadastramento e Reconvocações do Vestibular -> Convocação de Candidatos para Vagas Remanescentes

Usuário: adelardo

Papel que usuário deve ter: SigaaPapeis.GESTOR_CONVOCACOES_VESTIBULAR

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

Não se aplica.

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

Verificar o número de discentes com vínculo para um curso e ano-período de entrada igual ao definido no Vestibular na [[desenvolvimento:especificacoes:sigaa:graduacao:casos_de_uso:consultas:consultas_gerais:consulta_geral_de_discentes|Consulta Geral de Discentes]].
Verificar o número de [[desenvolvimento:especificacoes:sigaa:graduacao:casos_de_uso:administracao:operacoes_administrativas:cadastrar_oferta_de_cursos_para_processos_seletivos|vagas ofertadas para o curso]].
Ver se a quantidade de candidatos convocados no resumo da convocação.

<code sql>
-- Exemplo de consulta para saber o número de vagas ociosas
-- Alterar o id_processo_seletivo, ano_ingresso e periodo_ingresso para obter outros resultados
select o.id_matriz_curricular, 
 c.nome,
 cast((vagas_periodo_2 - preenchidas.total) as integer) as ociosas
 from ensino.oferta_vagas_curso o 
 join vestibular.processo_seletivo ps on (o.id_forma_ingresso = ps.id_forma_ingresso and o.ano = ps.ano_entrada) 
 inner join curso c using (id_curso)
 join (  select dg.id_matriz_curricular, d.id_forma_ingresso, count(*) as total
 	from graduacao.discente_graduacao dg 
 	join discente d on dg.id_discente_graduacao = d.id_discente 
 	where d.ano_ingresso = 2011
 	and d.status in  ( 1,8,9,5,2 )
 and d.periodo_ingresso = 2
 	group by id_matriz_curricular, d.id_forma_ingresso
 	) as preenchidas on (preenchidas.id_matriz_curricular = o.id_matriz_curricular and preenchidas.id_forma_ingresso = ps.id_forma_ingresso)
 where ps.id_processo_seletivo = 2860174
 and vagas_periodo_2 > 0 and o.vagas_periodo_2 - preenchidas.total > 0
 order by 2
</code>

Para saber o valor do id_processo_seletivo referente a um processo seletivo basta executar o seguinte script:

<code sql>
select id_processo_seletivo, nome from vestibular.processo_seletivo  
</code> 

<code sql>
-- Lista de candidatos de uma matriz curricular
-- Substituir id_matriz_curricular para obter outros resultados
select inscricao_vestibular.numero_inscricao, classificacao, 
situacao_candidato.descricao, 
convocacao_processo_seletivo.data_convocacao,
convocacao_processo_seletivo.descricao,
convocacao_processo_seletivo_discente.tipo,
cancelamento_convocacao.data_cancelamento,
matricula, curso2.nome as curso_atualmente_matriculado, periodo_ingresso
from vestibular.inscricao_vestibular
inner join vestibular.processo_seletivo using (id_processo_seletivo)
inner join vestibular.resultado_classificacao_candidato using (id_inscricao_vestibular)
inner join vestibular.situacao_candidato using (id_situacao_candidato)
inner join vestibular.resultado_opcao_curso using (id_resultado_classificacao_candidato)
inner join graduacao.matriz_curricular using (id_matriz_curricular)
inner join curso using (id_curso)
inner join vestibular.pessoa_vestibular using (id_pessoa)
left join vestibular.convocacao_processo_seletivo_discente using (id_inscricao_vestibular)
left join vestibular.convocacao_processo_seletivo using (id_convocacao_processo_seletivo)
left join graduacao.cancelamento_convocacao using (id_convocacao_processo_seletivo_discente)
left join discente using (id_discente)
left join graduacao.discente_graduacao on (id_discente = id_discente_graduacao)
left join curso curso2 on (discente.id_curso = curso2.id_curso)
where ordem_opcao = 2
and situacao_candidato.codigo in ('S', 'M', 'E')
and matriz_curricular.id_matriz_curricular = 25767230 
and classificacao > 0
order by classificacao
</code>

Para obter o valor da id_matriz_curricular de certo curso pode-se usar o seguinte script:

<code sql>
select mc.id_matriz_curricular, c.nome as curso from curso c
inner join graduacao.matriz_curricular mc using (id_curso)
</code>