====== Homologação/Nomeação e Posse de Candidatos ======

Através deste caso de uso é possível controlar as operações de nomeação de candidatos aprovados em consursos. É possível Nomear, definir a data de posse, ou alterar o status do candidato para Desistente.

Os responsáveis por estas operações são os funcionários do departamento de administração de pessoal, com o perfil de Gestor de Concursos.

Antes de realizar este caso de uso é necessário:

  *Ter um concurso cadastrado ([[desenvolvimento:especificacoes:sigrh:concursos:casos_de_uso:registros:concurso:cadastrar_concurso_processo_seletivo| Cadastrar Concurso ]])
  *Ter vagas cadastradas para o concurso ([[desenvolvimento:especificacoes:sigrh:concursos:casos_de_uso:registros:concurso:cadastrar_alterar_vagas| Cadastrar Vagas ]])
  *Ter candidatos cadastrados para o concurso ([[desenvolvimento:especificacoes:sigrh:concursos:casos_de_uso:registros:candidatos:cadastrar_alterar_candidatos| Cadastrar Candidatos ]] )
  *Ter uma portaria de nomeação cadastrada para o concurso ([[desenvolvimento:especificacoes:sigrh:concursos:casos_de_uso:registros:concurso:cadastrar_alterar_portaria| Cadastrar Portaria]] )
  

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

Este caso de uso inicia-se quando o usuário acessa a opção: //SIGRH → Módulo Concursos → Aba Registros → Candidatos → Homologação/Nomeação e Posse dos Candidatos//.

Para realizar este caso de uso, 

=== Passo 1===
Deveremos selecionar um concurso, realizando o seguinte filtro:

      * **Categoria do Concurso: *** Tipo TEXTO - Possíveis valores: PROFESSOR EFETIVO, PROFESSOR EFETIVO EQUIVALENTE, PROFESSOR SUBSTITUTO, TÉCNICO ADMINISTRATIVO([[#Principais regras de negócio|RN01]])

Depois serão listados os concursos para esta categoria. Para cada concurso são exibidos:

      * **__Data do Cadastro__**: Tipo DATA
      * **__Categoria__**: Tipo TEXTO
      * **__Publicado__**: Formato Sim/Não, Tipo TEXTO
      * **__Vagas Previstas__**: Tipo NUMERICO
      * **__Editais__**: Formato 9999/AAAA, Tipo NUMERICO

e o concurso pode ser selecionado.

=== Passo 2===
Ao selecionar o concurso serão listados todos os cargos para o concurso. ([[#Principais regras de negócio|RN02]])

      * ** Portaria de nomeação: ** Formato 9999/AAAA, Tipo NUMERICO
      * ** Resolução de homologação: *** Formato 9999/AAAA, Tipo NUMERICO ([[#Principais regras de negócio|RN05]])

      * **__Tipo de Provimento__**: Tipo TEXTO, São apresentadas opções: EDITAL, REDISTRIBUIÇÃO DE CESSÃO, REDISTRIBUIÇÃO DE PERMUTA, REDISTRIBUIÇÃO DE RECEBIMENTO, APROVEITAMENTO, APROVEITAMENTO EXTERNO
      * **__Área__**: Tipo TEXTO
      * **__Cargo__**: Tipo TEXTO
      * **__Unidade__**: Formato UNIDADE ,Tipo TEXTO
      * **__Quantidade de Vagas__**: Tipo NUMERICO
      * **Quantidade de Vagas Homologadas**: Tipo NUMERICO

Então o cargo pode ser selecionado.

=== Passo 3===
Ao selecionar o referido cargo, serão apresentados os dados do concurso e em seguido listados todos os candidatos aprovados para este cargo ordenados por classificação.([[#Principais regras de negócio|RN03]] , [[#Principais regras de negócio|RN04]])

      * **__CONCURSO__**: Tipo - TEXTO;
      * **__CARGO SELECIONADO__**: Tipo - TEXTO;
      * **__ÁREA__**: Tipo TEXTO;
      * **__QUANT. VAGAS__**: Tipo - NUMERICO;
      * **__QUANT. HOMOLOGADAS__**: Tipo NUMERICO.
      
      * **__PORTARIA DE NOMEAÇÃO SELECIONADA__**: Tipo - NUMERICO.
      * **__RESOLUÇÃO DE HOMOLOGAÇÃO SELECIONADA__**: Tipo - NUMERICO.
Listagem      
      * **__Classificação__**: Tipo NUMERICO
      * **__Candidato__**: Formato NOME(CPF), Tipo TEXTO
      * **__Portaria de Nomeação__**: Formato 9999/AAAA, Tipo NUMERICO
      * **__Resolução de Homologação__**: Formato 9999/AAAA, Tipo NUMERICO
      * **Situação**: Tipo TEXTO. São apresentadas as opções: ''Aguardando, Desistente, Nomeado, Desistência Temporária, Posse Indeferida, Não Houve Aprovação, Nomeação Tornada Sem Efeito e Aproveitamento''([[#Principais regras de negócio|RN06]] , [[#Principais regras de negócio|RN08]] , [[#Principais regras de negócio|RN09]])
        * **Portaria de Tornar Sem Efeito**:Tipo - TEXTO. ([[#Principais regras de negócio|RN10]])
        * **Órgão**: Tipo - TEXTO. ([[#Principais regras de negócio|RN10]])
        * **Nº do Processo**: Tipo - TEXTO.
      * **Código da Vaga**: Tipo NUMERICO
      * **Data da Posse**: Tipo DATA - ([[#Principais regras de negócio|RN07]])


então será possível alterar o status do candidato, por padrão, o status de um candidato quando cadastrado é AGUARDANDO. porém o status poderá ser alterado para NOMEADO, ou DESISTENTE. Quando for confirmada a operação, serão gravadas as alterações.


O Caso de Uso é Finalizado.


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

  * **RN01** - É necessário ter concursos cadastrados, caso não existam será exibida mensagem que não existem concursos cadastrados.
  * **RN02** - É necessário que os concurso tenha vagas cadastradas para ele, caso não existam será exibida mensagem indicando que não existem vagas cadastradas para o concurso.
  * **RN03** - É necessário que hajam códigos de vagas cadastradas para as vagas do concurso
  * **RN04** - É necessário que hajam candidatos cadastrados para o concurso, com inscrições homologadas e resultados cadastrados. caso não existam será exibida mensagem indicando que não existem candidatos cadastrados para o concurso
  * **RN05** - É necessário ter uma portaria de nomeação cadastrada para o concurso, caso não haja, não será possível prosseguir com o caso de uso. No momento nenhuma mensagem foi especificada.
  * **RN06** - Quando um candidato for alterado para DESISTENTE e seu status anterior era NOMEADO, seu código de vaga será desativado, o candidato será desativado, e gerado um novo candidato sem vínculo com nenhuma vaga, nem código de vaga. Ficará vinculado apenas ao concurso.
  * **RN07** - Só é armazenado no banco de dados as datas de posse para candidatos com o status NOMEADO.
__  * **RN08** - Caso o status de um candidato seja EXONERADO, não será permitido mais a alteração do seu status.__
  * **RN08** - Neste caso de uso, serão listados a quantidade de candidatos que possam preencher a quantidade total de vagas. Candidatos Exonerados ou Desistentes, são exibidos mas não são considerados na contagem, pois uma vez nestes status, liberam sua vaga para o próximo candidato disponível.
  <del>* **RN09** - O status do candidato pode mudar conforme os seguintes critérios:
    * AGUARDANDO pode mudar para DESISTENTE, DESISTENTE TEMPORÁRIO, NOMEADO.
    * Depois de DESISTENTE e NOMEADO, não pode mudar mais.
    * DESISTENTE TEMPORÁRIO só pode mudar para NOMEADO.</del>
  * **RN10** - Caso a opção "Nomeação Tornada Sem Efeito" seja selecionada, trazer as portarias de tornar sem efeito para escolher. Caso seja selecionada "Aproveitamento" as colunas ÓRGÃO e o número do processo ficam visíveis e disponível pra edição.
===== Resoluções/Legislações Associadas =====
Não se Aplica

<ifauth @admin>

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


^ Classe ^ Tabela |
| br.ufrn.sigrh.concurso.dominio.Concurso | administrativo.concurso.concurso |
| br.ufrn.sigrh.concurso.dominio.AreaContratacao | administrativo.concurso.area_contratacao |
| br.ufrn.sigrh.concurso.dominio.CandidatoAprovado | administrativo.concurso.candidato_aprovado |
| br.ufrn.sigrh.concurso.dominio.VagaCodigo | administrativo.concurso.vaga_codigo |


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

Sistema: SIGRH

Módulo: Concursos

Link(s): SIGRH -> Módulo Concursos -> Aba Registros -> Candidatos -> Homologação/Nomeação e Posse dos Candidatos

Usuário: andrearamalho (Gestora de Candidatos), sas (Gestor Concursos)

Papel que usuário deve ter: 
  *SigrhPapeis.GESTOR_CANDIDATOS_CONCURSOS
  *SigrhPapeis.GESTOR_CONCURSOS

Obs.: O Usuário especificado contém os dois papeis.

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

Realizar a alteração de um determinado candidato aprovado para o status DESISTENTE com a finalidade de verificar se o código de vaga atribuído a este candidato foi desativada. Caso todos os candidatos estejam com o status AGUARDANDO, primeiramente deveremos alterar o status para NOMEADO, e confirmar alteração, para depois mudar para DESISTENTE, pois, um código de vaga só é vinculado a um candidato quando o mesmo é nomeado.

Depois de realizar a alteração do candidato, acessar a busca por códigos de vagas deste cargo, para este concurso, e verificar que o cógido de vaga que estava vinculado ao candidato referido, não aparecerá na listagem de códigos de vagas deste cargo.

Caso queira verificar no banco de dados se realmente foi desativado realizar busca no banco:
    SELECT * FROM concurso.vaga_codigo WHERE ativo = false


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


  *Para cadastrar um novo concurso, acesse o caso de uso ([[desenvolvimento:especificacoes:sigrh:concursos:casos_de_uso:registros:concurso:cadastrar_concurso_processo_seletivo| Cadastrar Concurso ]])
  *Para cadastrar vagas associando-as a um dado concurso, acesse o caso de uso ([[desenvolvimento:especificacoes:sigrh:concursos:casos_de_uso:registros:concurso:cadastrar_alterar_vagas| Cadastrar Vagas ]])
  *Para cadastrar candidatos para um dado concurso, acesse o caso de uso ([[desenvolvimento:especificacoes:sigrh:concursos:casos_de_uso:registros:candidatos:cadastrar_alterar_candidatos| Cadastrar Candidatos ]] ). Esse caso de uso é acessador através do caminho Módulo Concursos -> Cadastrar/Alterar Vagas -> Buscar -> Selecionar Concurso -> Cadastrar Vagas -> Cadastrar Códigos.
  *Para cadastrar portaria para um dado concurso, ([[desenvolvimento:especificacoes:sigrh:concursos:casos_de_uso:registros:concurso:cadastrar_alterar_portaria| Cadastrar Portaria]] )

</ifauth>