~~ODT~~

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

====== Cadastramento de Períodos ======

Este caso de uso permite aos usuários da PRÓ-REITORIA DE ASSUNTOS ESTUDANTIS definir um calendário para os discentes solicitarem bolsa auxílio na instituição.
===== Descrição do Caso de Uso =====

Este caso de uso inicia-se quando a opção //SIGAA → Assistência ao Estudante → Cadastramento de Períodos → Cadastrar// é acessada.

Ao selecionar o presente caso de uso, será necessário que o usuário informe os seguintes dados para //Cadastrar// um novo calendário ([[#Principais Regras de Negócio|RN01]]):

  * **Ano-período:*** Formato: 9999-9. Tipo: NUMÉRICO. 
  * **Tornar esse calendário vigente:** Tipo: LÓGICO.
  * **<del>Ano - Período Alimentação</del>:** Formato-  9999-9. Tipo: NUMÉRICO.
  * **Recesso RU:*** Formato - DD/MM/AAAA a DD/MM/AAAA. Tipo - DATA.
  * **Desbloqueio RU:** Formato - DD/MM/AAAA a DD/MM/AAAA. Tipo - DATA.
  * **Renovação das Bolsas***: Formato- DD/MM/AAAA a DD/MM/AAAA. Tipo - DATA ([[#Principais Regras de Negócio|RN06]]), ([[#Principais Regras de Negócio|RN07]]). 
  * **Tipo da Bolsa:*** Formato: ATLETA/ALIMENTAÇÃO/CRECHE/ÓCULOS/PROMISAES/RESIDÊNCIA GRADUAÇÃO/RESIDÊNCIA PÓS/TRANSPORTE. Tipo: TEXTO ([[#Principais Regras de Negócio|RN02]]).
  * **Município:*** Tipo: TEXTO.
  * **Inscrição de:*** Formato: De DD/MM/AAAA a DD/MM/AAAA. Tipo: DATA. 
  * **Resultados a partir de:*** Formato: DD/MM/AAAA. Tipo: DATA.
  * **Execução de:*** Formato: De DD/MM/AAAA a DD/MM/AAAA. Tipo: DATA. 
  * **Hora de Término:** Formato: hh:mm. Tipo: HORA. 
  * **Alunos veteranos podem solicitar essa bolsa:** Tipo: LÓGICO.
  * **Alunos novatos podem solicitar essa bolsa:** Tipo: LÓGICO.
  * **Restringir inscrição por nível de ensino?:** Tipo: LÓGICO.
  * **Nível de Ensino:** Formato: INFANTIL/FUNDAMENTAL/MÉDIO/TÉCNICO/INTEGRADO/FORMAÇÃO COMPLEMENTAR/GRADUAÇÃO/LATO SENSU - ESPECIALIZAÇÃO/LATO SENSU - RESIDÊNCIA/STRICTO SENSU/MESTRADO/DOUTORADO. Tipo: TEXTO ([[#Principais Regras de Negócio|RN08]]). 

Ao clicar no botão Adicionar, é exibida uma listagem com as colunas:

  * **__Tipo da Bolsa:__** Tipo: TEXTO.
  * **__Município:__** Tipo: TEXTO.
  * **__Inscrições:__** Formato: De DD/MM/AAAA a DD/MM/AAAA. Tipo: DATA.
  * **__Resultados:__** Formato: DD/MM/AAAA. Tipo: DATA ([[#Principais Regras de Negócio|RN05]]).
  * **__Período de Execução:__** Formato: De DD/MM/AAAA a DD/MM/AAAA. Tipo: DATA ([[#Principais Regras de Negócio|RN04]]).
  * **__Veteranos:__** Tipo: LÓGICO.
  * **__Novatos:__** Tipo: LÓGICO.

O Usuário poderá ainda inserir um //Texto Referência// com informações adicionais do calendário.

===Texto Referência===

Ao selecionar esta opção  o usuário devera preencher os seguintes campos:

  * **__Texto Referência:__** Tipo: TEXTO.
  * **__Arquivo:__** Tipo: TEXTO. Campo para upload de arquivo.


Ao clicar no botão Concluir o caso de uso é finalizado.


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

  * **RN01** - Não é permitido cadastrar mais de um Calendário para o mesmo Ano-Período.
  * **RN02** - Um Calendário só pode ser cadastrado se possuir pelo menos uma Bolsa-Auxílio vinculada.
  * **RN03** - É necessário que um (e somente um) calendário esteja vigente.
  * <del>**RN04** - O fim do período de execução da bolsa de ser superior ou igual ao término do período de inscrição da mesma.</del>
  * <del>**RN05** - A data de divulgação do resultado deve ser superior a data inicial de inscrição da bolsa e inferior a data Final da execução da bolsa.</del>
  * **RN06** - Habilita para o aluno quando acessar o portal do discente, uma mensagem de notificação sobre a renovação da bolsa. 
  * **RN07** - Os alunos que possuem bolsas passíveis de Renovação receberão email automatico de aviso sobre o período de renovação. O parâmetro responsável por esta verificação e envio de email é o br.ufrn.sigaa.assistencia.timer.NotificaPassiveisRenovacaoTimer. Alunos passíveis de renovação são todos os discentes com bolsas com status DEFERIDO E CONTEMPLADO, ou Bolsa Residencia Graduação com status AUXILIO E MORADIA de um semestre X, onde o semestre posterior possui período de renovação cadastrado. Atualmente o parâmetro está configurado para notificar os discentes com 30 e 15 antes do início de iniciar a renovação, e um dia antes de finalizar o período de renovação das bolsas.
  * **RN08** - Permite restringir os níveis de ensino onde os alunos poderão realizar a solicitação da bolsa/auxílio.

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

Não se aplica.

<ifauth @admin>
===== Classes Persistentes e Tabelas Envolvidas =====

^ Classe                                                     ^ Tabela                              ^
| br.ufrn.sigaa.assistencia.dominio.CalendarioBolsaAuxilio   | sigaa.sae.calendario_bolsa_auxilio  |
| br.ufrn.sigaa.assistencia.dominio.AnoPeriodoReferenciaSAE  | sigaa.sae.ano_periodo_referencia    |
| br.ufrn.academico.dominio.NivelEnsino                      |                                     |




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

Sistema: SIGAA

Módulo: Assistência ao Estudante

Link(s): Assistência ao Estudante -> Cadastramento de Períodos -> Cadastrar

Usuário: gracacosta

Papel que usuário deve ter:  SigaaPapeis.SAE_COORDENADOR 
===== Cenários de Teste =====

Utilizando o login "gracacosta", cadastrar um novo calendário (Assistência ao Estudante → Cadastramento de Períodos → Cadastrar).

Utilizando login de discente, SIGAA → Bolsas → Solicitação de Bolsas → Solicitação de Bolsa Auxílio e visualizar o calendário vigente cadastrado.
===== Dados para o Teste =====

Não se aplica

</ifauth>