~~ODT~~

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


====== Cadastrar/Alterar/Remover Cotas de Bolsa ======

Este caso de uso é utilizado pelos usuários responsáveis pelo setor de bolsas da instituição coma finalidade de permitir o cadastro, alteração e exclusão das cotas de bolsa. As cotas de bolsa definem a quantidade de [[https://docs.info.ufrn.br/doku.php?id=desenvolvimento:especificacoes:sipac:bolsas:negocio|bolsas]], por tipo, que uma determinada unidade pode ter. 

Este cadastro é importante no sentido de ser necessário para o anuncio de vagas de bolsas, realizados apenas se houver cotas de bolsa disponíveis para o tipo de bolsa anunciado. 

As bolsas podem ser de vários tipos, como por exemplo: Auxílio Tese Doutorado, Mestrado - ANP, Bolsa Transporte. Cada tipo de bolsa define o valor a ser pago, a unidade que vai efetuar tal pagamento e o tempo máximo de duração da mesma.


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

Este caso de uso se inicia ao acessar o link SIPAC -> Bolsas -> Aba de cadastros -> Cadastros -> Cotas de Bolsas - > Cadastrar/Alterar/Remover.

Inicialmente, o sistema requer que o usuário informe o ano para o qual deseja listar ou cadastrar as cotas de bolsas das unidades:

  * **Ano***: Tipo NUMÉRICO, formato: AAAA. //Representa o ano de vigência da cota informada//.

=== Cadastrar Cota === 

Ao prosseguir, um formulário para o cadastro das bolsas é exibido, com os seguintes dados: 

  * **Ano***: Tipo NUMÉRICO, formato: AAAA. 
  * **Tipo de Bolsa***: Tipo TEXTO. Correpondendo ao tipo de bolsa que sofrerá aquela cota ([[#Principais Regras de Negócio|RN01]]).
  * **Unidade***: Tipo AUTOCOMPLETE, formato: DENOMINAÇÃO UNIDADE (CÓDIGO UNIDADE), entrada de dados: DENOMINAÇÃO ou CÓDIGO. Sendo esta a unidade que poderá ofertar as bolsas.
  * **Cota***: Tipo NUMÉRICO. Representa a quantidade máxima de bolsas que poderá ser oferecido pela unidade, para o tipo de bolsa selecionado.
  * **Cota extra***: Tipo NUMÉRICO. Sendo uma cota disponibilizada caso haja, por algum motivo, a necessidade de cadastro de uma nova bolsa para aquele tipo se a cota máxima já tiver sido atingida.

Também são exibidas as cotas cadastradas em forma de listagem ([[#Principais Regras de Negócio|RN01]]), com os seguintes dados: 

  ***__Tipo de Bolsa__**: Tipo TEXTO. 
  ***__Ano__**: Tipo NUMÉRICO, formato: AAAA. 
  ***__Cota__**: Tipo NUMÉRICO.
  ***__Cota Extra__**: Tipo NUMÉRICO.
  ***__Unidade__**:  Tipo TEXTO, formato: DENOMINAÇÃO UNIDADE (CÓDIGO).

Para cada item relacionado, existem as opções de **Alterá-los** e **Removê-los**.

=== Alterar Cota === 

Segue o fluxo de [[#Cadastrar Cota|Cadastrar Cota]], porém alguns campos são bloqueados para a alteração. ([[#Principais Regras de Negócio|RN02]])

=== Remover Cota ===

Uma confirmação é requerida, e então o registro da cota é removido do sistema. 

O caso de uso então é finalizado.

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

== Gestor de Tipos de Bolsa ==

  ***RN01** - Apenas são exibidos os tipos de bolsa permitidos ao usuário.
  ***RN02** - Ao realizar a operação **Alterar** os dados //Ano//, //Tipo de Bolsa// e //Unidade// não podem ser alterados.  

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

Não se Aplica.  

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

^ Classe ^ Tabela |
| br.ufrn.sipac.bolsas.dominio.CotaBolsa | administrativo.bolsas.cota_bolsa |
| br.ufrn.sipac.bolsas.dominio.TipoBolsa | administrativo.bolsas.tipo_bolsa |
| br.ufrn.sipac.bolsas.dominio.TipoBolsa | administrativo.bolsas.restricao_tipo_bolsa |

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

Sistema: SIPAC

Módulo: BOLSAS

Link(s): Aba Cadastros -> Cadastros -> Cotas de Bolsas - > Cadastrar/Alterar/Remover.

Usuário: rcn (SipacPapeis.GESTOR_BOLSAS_LOCAL), aurelia, iris, lad (SipacPapeis.GESTOR_TIPOS_BOLSA), halcima(SipacPapeis.AUDITOR).


Papel que usuário deve ter: 
  * SipacPapeis.GESTOR_BOLSAS_GLOBAL ou
  * SipacPapeis.GESTOR_BOLSAS_CONVENIO ou
  * SipacPapeis.GESTOR_BOLSAS_CONVENIO_GLOBAL ou
  * SipacPapeis.GESTOR_TIPOS_BOLSA ou 
  * SipacPapeis.GESTOR_BOLSAS_LOCAL ou
  * SipacPapeis.GESTOR_BOLSAS_CENTRO ou
  * SipacPapeis.AUDITOR.

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

  * Acessar o caso de uso e cadastrar uma cota de bolsa.
  * Acessar o caso de uso e alterar uma cota de bolsa.
  * Acessar o caso de uso e remover uma cota de bolsa.
  * Logar com usuário com papel GESTOR_TIPOS_BOLSA, acessar o caso de uso e verificar se:
    * A listagem //Cotas Cadastradas// possui apenas os tipos de bolsa restritos para o usuário.
    * O combobox //Tipos de Bolsa// apresenta apenas os tipos de bolsa restritos para o usuário.


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

  - Para obter os papeis do usuário realize o caso de uso [[desenvolvimento:especificacoes:sigadmin:casos_de_uso:gestao:permissoes:relatorio_de_usuarios_por_papel|Relatório de Usuários por Papel]] do SIGAdmin.
  - Código SQL retorna os tipos restritos para usuário (colocar o login):
<code sql>
SELECT DISTINCT TIPO.DENOMINACAO
  FROM BOLSAS.RESTRICAO_TIPO_BOLSA AS RESTRI 
    LEFT JOIN COMUM.USUARIO AS USR ON (RESTRI.ID_USUARIO = USR.ID_USUARIO) ,
     BOLSAS.TIPO_BOLSA AS TIPO
 WHERE USR.LOGIN = '[LOGIN]' AND TIPO.ID = RESTRI.ID_TIPO_BOLSA
ORDER BY TIPO.DENOMINACAO
</code>