~~ODT~~
echo "";
echo "Última atualização: ";
ver('', false);
echo "
";
====== Inclusão Bolsista ======
Este caso de uso tem como finalidade atender ou negar solicitações de cadastro de [[desenvolvimento:especificacoes:sipac:bolsas:negocio|bolsas]], possibilitando a analise do bolsista afim de incluí-lo ou não na bolsa. Nesse caso de uso são listadas todas as solicitações de cadastro de bolsas enviadas ou homologadas pelo(a) assistente social pendentes de atendimento, além de mostrar as solicitações ainda pendentes de homologação.
A inclusão dos bolsistas pode ser realizado pelos usuários responsáveis da Pró-Reitoria de Administração - PROAD, mais especificamente da Seção de Bolsas.
===== Descrição do Caso de Uso =====
=== Passo 1 ===
Este caso de uso inicia-se quando o usuário acessa o sistema e lista todas as solicitações de cadastro de bolsas pendentes de atendimento. Estas solicitações são divididas em duas listas:
* **Solicitações Enviadas**:
* __**N°./Ano**__: Formato - 9999/AAAA, Tipo - NUMÉRICO.
* __**Bolsista**__: Formato - NOME DO BOLSISTA, Tipo - TEXTO.
* __**Unidade**__: Formato - CÓDIGO UNIDADE - SIGLA, Tipo - TEXTO.
* __**Tipo de Bolsa**__: Formato - TIPO DA BOLSA (SIGLA UNIDADE PAGADORA), Tipo - TEXTO.
* __**Data de Cadastro**__: Formato - DD/MM/AAAA, Tipo - DATA.
* **__Solicitações Autorizadas pela(o) Assistente Social__**:
* __**N°./Ano**__: Formato - 9999/AAAA, Tipo - NUMÉRICO.
* __**Bolsista**__: Formato - NOME DO BOLSISTA, Tipo - TEXTO.
* __**Unidade**__: Formato - CÓDIGO UNIDADE - SIGLA, Tipo - TEXTO.
* __**Tipo de Bolsa**__: Formato - TIPO DA BOLSA (SIGLA UNIDADE PAGADORA), Tipo - TEXTO.
* __**Data de Envio**__: Formato - DD/MM/AAAA, Tipo - DATA.
Na página das listagens de solicitações pendentes de atendimento, também são listadas:
* Solicitações Pendentes de Homologação:
* __**N°./Ano**__: Formato - 9999/AAAA, Tipo - NUMÉRICO
* __**Bolsista**__: Formato - NOME DO BOLSISTA, Tipo - TEXTO
* __**Unidade**__: Formato - CÓDIGO UNIDADE - SIGLA. Tipo - TEXTO
* __**Tipo de Bolsa**__: Formato - TIPO DA BOLSA (SIGLA UNIDADE PAGADORA), Tipo - TEXTO
* __**Data de Envio**__: Formato - DD/MM/AAAA, Tipo - DATA
=== Passo 2 ===
Para cada solicitações pendente de atendimento são mostradas as opções de **//Analisar Solicitação//** e **//Negar Solicitação//** ([[desenvolvimento:especificacoes:sipac:bolsas:casos_de_uso:operacoes:operacoes:atendimento_de_solicitacoes:inclusao_bolsista#Principais regras de negócio|RN01]]).
Ao ser escolhida a opção **//Analisar Solicitação//** ([[desenvolvimento:especificacoes:sipac:bolsas:casos_de_uso:operacoes:operacoes:atendimento_de_solicitacoes:inclusao_bolsista#Principais regras de negócio|RN02]], [[desenvolvimento:especificacoes:sipac:bolsas:casos_de_uso:operacoes:operacoes:atendimento_de_solicitacoes:inclusao_bolsista#Principais regras de negócio|RN03]], [[desenvolvimento:especificacoes:sipac:bolsas:casos_de_uso:operacoes:operacoes:atendimento_de_solicitacoes:inclusao_bolsista#Principais regras de negócio|RN04]], [[desenvolvimento:especificacoes:sipac:bolsas:casos_de_uso:operacoes:operacoes:atendimento_de_solicitacoes:inclusao_bolsista#Principais regras de negócio|RN05]]), são apresentados os dados do solicitante da bolsa:
* **__Usuário__**: Formato - NOME DO USUÁRIO, Tipo - TEXTO.
* **__Ramal__**: Formato - 9999, Tipo - NUMÉRICO
* **__Unidade__**: Formato - NOME UNIDADE (CÓDIGO UNIDADE), Tipo - TEXTO.
E após as informações do bolsista para analise e cadastro, onde também poderão ser atualizadas:
* **__Matrícula__**: Formato - 999999999, Tipo - NUMÉRICO
* **__Nome__**: Formato - NOME DO ALUNO, Tipo - TEXTO
* **__CPF__**: Formato - 999.999.999-99, Tipo - NUMÉRICO
* **Nascimento***: Formato - DD/MM/AAAA, Tipo - DATA
* **Sexo***: Formato - MASCULINO ou FEMININO, Tipo - TEXTO
* **Curso***: Formato - NOME, Tipo - TEXTO
* **__Informações Bancárias__**:
* **Banco**: Formato - CÓDIGO | LISTA DE BANCOS, Tipo - TEXTO
* **Agência***: Tipo - TEXTO
* **Conta Corrente***: Tipo - TEXTO
* **__Informações para Contato__**:
* **Endereço***: Tipo - TEXTO
* **Bairro***: Tipo - TEXTO
* **Cidade***: Formato - CIDADE | UF, Tipo - TEXTO
* **CEP***: Formato - 99999-999, Tipo - NUMÉRICO
* **Telefone**: Formato - 99999999, Tipo - NUMÉRICO
* **Celular**: Formato - 99999999, Tipo - NUMÉRICO
* **E-mail**: Formato - E-MAIL, Tipo - TEXTO
* **__Informações da Bolsa__**:
* **Unidade Responsável***: Formato: CÓDIGO DA UNIDADE | UNIDADE (CÓDIGO DA UNIDADE) , Tipo - TEXTO.
* **Local de Trabalho***: Formato: CÓDIGO DA UNIDADE | UNIDADE (CÓDIGO DA UNIDADE) , Tipo - TEXTO.
* **Tipo de Bolsa***: Formato - TIPO (SIGLA UNIDADE PAGADORA)
* **Início da bolsa***: Formato - Mês | Ano, Tipo - NUMÉRICO
* **Fim da bolsa***: Formato - Mês | Ano, Tipo - NUMÉRICO
* **__Informações da Indicação__**:
* **__Situação Social__**: Formato - TIPO SITUAÇÃO SOCIAL , Tipo - TEXTO.
* **__Justificativa__**: Tipo - TEXTO.
* **__Observações__**: Tipo - TEXTO.
* Ao selecionar a opção **//cadastrar//** ([[desenvolvimento:especificacoes:sipac:bolsas:casos_de_uso:operacoes:operacoes:atendimento_de_solicitacoes:inclusao_bolsista#Principais regras de negócio|RN06]], [[desenvolvimento:especificacoes:sipac:bolsas:casos_de_uso:operacoes:operacoes:atendimento_de_solicitacoes:inclusao_bolsista#Principais regras de negócio|RN07]]) são mostrados os dados do bolsista para a confirmação da inclusão deste, esses dados são:
* **__Nome__**: Formato - NOME DO ALUNO, Tipo - TEXTO
* **__CPF__**: Formato - 999.999.999-99, Tipo - NUMÉRICO
* **__Nascimento__**: Formato - DD/MM/AAAA, Tipo - DATA
* **__Sexo__**: Formato - MASCULINO ou FEMININO, Tipo - TEXTO
* **__Matrícula__**: Formato - 999999999, Tipo - NUMÉRICO
* **__Curso__**: Formato - NOME, Tipo - TEXTO
* **__Informações Bancárias__**:
* **__Banco__**: Formato - NOME DO BANCO, Tipo - TEXTO
* **__Agência__**: Formato - AGENCIA, Tipo - TEXTO e NUMÉRICO
* **__Conta Corrente__**: Formato - CONTA, Tipo - TEXTO e NUMÉRICO
* **__Informações para Contato__**:
* **__Endereço__**: Tipo - TEXTO
* **__Bairro__**: Tipo - TEXTO
* **__Cidade__**: Formato - CIDADE | UF, Tipo - TEXTO
* **__CEP__**: Formato - 99999-999, Tipo - NUMÉRICO
* **__Telefone__**: Formato - 99999999, Tipo - NUMÉRICO
* **__Celular__**: Formato - 99999999, Tipo - NUMÉRICO
* **__E-mail__**: Formato - E-MAIL, Tipo - TEXTO
* **__Informações da Bolsa__**:
* **__Unidade__**: Formato: CÓDIGO DA UNIDADE | UNIDADE (CÓDIGO DA UNIDADE) , Tipo - TEXTO.
* **__Local de Trabalho__**: Formato: CÓDIGO DA UNIDADE | UNIDADE (CÓDIGO DA UNIDADE) , Tipo - TEXTO.
* **__Tipo de Bolsa__**: Formato - TIPO (SIGLA UNIDADE PAGADORA)
* **__Início__**: Formato - 01/MM/AA, Tipo - DATA
* **__Fim__**: Formato - 30/MM/AA, Tipo - DATA
* Ao confirmar o cadastro, segue para a página de solicitações de cadastro e informa uma mensagem de sucesso da inclusão do bolsista.
* Selecionando a opção **//negar//** são mostrados os dados do solicitante da bolsa:
* **__Usuário__**: Formato - NOME DO USUÁRIO, Tipo - TEXTO.
* **__Ramal__**: Formato - 9999, Tipo - NUMÉRICO
* **__Unidade__**: Formato - NOME UNIDADE (CÓDIGO UNIDADE), Tipo - TEXTO.
* E os dados do bolsista para a confirmação da negação da solicitação, esses dados são:
* **__Nome__**: Formato - NOME DO ALUNO, Tipo - TEXTO
* **__CPF__**: Formato - 999.999.999-99, Tipo - NUMÉRICO
* **__Nascimento__**: Formato - DD/MM/AAAA, Tipo - DATA
* **__Sexo__**: Formato - MASCULINO ou FEMININO, Tipo - TEXTO
* **__Matrícula__**: Formato - 999999999, Tipo - NUMÉRICO
* **__Curso__**: Formato - NOME, Tipo - TEXTO
* **__Informações Bancárias__**:
* **__Banco__**: Formato - NOME DO BANCO, Tipo - TEXTO
* **__Agência__**: Formato - AGENCIA, Tipo - TEXTO e NUMÉRICO
* **__Conta Corrente__**: Formato - CONTA, Tipo - TEXTO e NUMÉRICO
* **__Informações para Contato__**:
* **__Endereço__**: Tipo - TEXTO
* **__Bairro__**: Tipo - TEXTO
* **__Cidade__**: Formato - CIDADE | UF, Tipo - TEXTO
* **__CEP__**: Formato - 99999-999, Tipo - NUMÉRICO
* **__Telefone__**: Formato - 99999999, Tipo - NUMÉRICO
* **__Celular__**: Formato - 99999999, Tipo - NUMÉRICO
* **__E-mail__**: Formato - E-MAIL, Tipo - TEXTO
* **__Informações da Bolsa__**:
* **__Unidade__**: Formato: CÓDIGO DA UNIDADE | UNIDADE (CÓDIGO DA UNIDADE) , Tipo - TEXTO.
* **__Local de Trabalho__**: Formato: CÓDIGO DA UNIDADE | UNIDADE (CÓDIGO DA UNIDADE) , Tipo - TEXTO.
* **__Tipo de Bolsa__**: Formato - TIPO (SIGLA UNIDADE PAGADORA)
* **__Início__**: Formato - 01/MM/AA, Tipo - DATA
* **__Fim__**: Formato - 30/MM/AA, Tipo - DATA
* **__Justificativa__**:
* **Justificativa***: Tipo - TEXTO.
* Ao negar ([[desenvolvimento:especificacoes:sipac:bolsas:casos_de_uso:operacoes:operacoes:atendimento_de_solicitacoes:inclusao_bolsista#Principais regras de negócio|RN08]]), segue para a página de solicitações de cadastro e informa uma mensagem de sucesso da negação.
Ao ser escolhida a opção **//Negar Solicitação//**, na página das listas de solicitações, são apresentados os dados do solicitante da bolsa:
* **__Usuário__**: Formato - NOME DO USUÁRIO, Tipo - TEXTO.
* **__Ramal__**: Formato - 9999, Tipo - NUMÉRICO
* **__Unidade__**: Formato - NOME UNIDADE (CÓDIGO UNIDADE), Tipo - TEXTO.
E os dados do bolsista para a confirmação da negação da solicitação, esses dados são:
* **__Nome__**: Formato - NOME DO ALUNO, Tipo - TEXTO
* **__CPF__**: Formato - 999.999.999-99, Tipo - NUMÉRICO
* **__Nascimento__**: Formato - DD/MM/AAAA, Tipo - DATA
* **__Sexo__**: Formato - MASCULINO ou FEMININO, Tipo - TEXTO
* **__Matrícula__**: Formato - 999999999, Tipo - NUMÉRICO
* **__Curso__**: Formato - NOME, Tipo - TEXTO
* **__Informações Bancárias__**:
* **__Banco__**: Formato - NOME DO BANCO, Tipo - TEXTO
* **__Agência__**: Formato - AGENCIA, Tipo - TEXTO e NUMÉRICO
* **__Conta Corrente__**: Formato - CONTA, Tipo - TEXTO e NUMÉRICO
* **__Informações para Contato__**:
* **__Endereço__**: Tipo - TEXTO
* **__Bairro__**: Tipo - TEXTO
* **__Cidade__**: Formato - CIDADE | UF, Tipo - TEXTO
* **__CEP__**: Formato - 99999-999, Tipo - NUMÉRICO
* **__Telefone__**: Formato - 99999999, Tipo - NUMÉRICO
* **__Celular__**: Formato - 99999999, Tipo - NUMÉRICO
* **__E-mail__**: Formato - E-MAIL, Tipo - TEXTO
* **__Informações da Bolsa__**:
* **__Unidade__**: Formato: CÓDIGO DA UNIDADE | UNIDADE (CÓDIGO DA UNIDADE) , Tipo - TEXTO.
* **__Local de Trabalho__**: Formato: CÓDIGO DA UNIDADE | UNIDADE (CÓDIGO DA UNIDADE) , Tipo - TEXTO.
* **__Tipo de Bolsa__**: Formato - TIPO (SIGLA UNIDADE PAGADORA)
* **__Início__**: Formato - 01/MM/AA, Tipo - DATA
* **__Fim__**: Formato - 30/MM/AA, Tipo - DATA
* **__Justificativa__**:
* **Justificativa***: Tipo - TEXTO.
Ao negar ([[desenvolvimento:especificacoes:sipac:bolsas:casos_de_uso:operacoes:operacoes:atendimento_de_solicitacoes:inclusao_bolsista#Principais regras de negócio|RN08]]), segue para a página de solicitações de cadastro e informa uma mensagem de sucesso da negação.
===== Principais Regras de Negócio =====
***RN01** - A confirmação ou negação da inclusão de bolsista só pode ser realizada caso o usuário tenha permissão de alteração do tipo da bolsa da solicitação. É verificado se o usuário apresenta alguma restrição de tipos de bolsas, caso tenha, é verificado se ele tem permissão para o tipo de bolsa da solicitação, caso não apresente restrições, terá permissão para todos os tipos de bolsas.
***RN02** - A inclusão de bolsista só pode ser realizada caso a unidade do solicitante tenha, para o tipo da bolsa da solicitação, uma cota de bolsas definida.
***RN03** - A inclusão de bolsista só pode ser realizada caso a unidade do solicitante tenha, para o tipo da bolsa da solicitação, uma cota de bolsas disponível, que não exceda o limite com o cadastro dessa bolsa.
***RN04** - A inclusão de bolsista só pode ser realizada caso a duração da bolsa seja menor ou igual ao tempo máximo definido para o tipo de bolsa da solicitação.
***RN05** - A inclusão de bolsista só pode ser realizada caso o bolsista não esteja associado a alguma outra bolsa cujo o período entre em conflito com o período da nova bolsa. Apenas nos casos onde o tipo da nova bolsa possua permissão de acumulamento de bolsas, esta inclusão é permitida.
***RN06** - Na inclusão do bolsista, tanto o período inicial quanto o final da bolsa deve ser posterior a data atual.
***RN07** - Na inclusão do bolsista, o período final da bolsa deve ser posterior ao período inicial.
***RN08** - Na negação da solicitação de bolsa, é necessário informar uma justificativa. Esse justificativa será enviada ao usuário solicitante.
===== Classes Persistentes e Tabelas Envolvidas =====
^ Classe ^ Tabela |
| br.ufrn.sipac.bolsas.dominio.SolicitacaoBolsa | administrativo.bolsas.solicitacao_bolsa |
| br.ufrn.sipac.bolsas.dominio.OportunidadeEstagio | administrativo.bolsas.oportunidade_estagio |
| br.ufrn.sipac.bolsas.dominio.Bolsa | administrativo.bolsas.bolsa |
| br.ufrn.sipac.bolsas.dominio.TipoBolsa | administrativo.bolsas.tipo_bolsa |
====== Plano de Teste ======
Sistema: SIPAC
Módulo: Bolsas
Link(s):
* Módulos -> Bolsas -> Operações -> Operações -> Atendimento de Solicitações -> Inclusão Bolsista
* Módulos -> Bolsas -> SOLICITAÇÕES: INCLUSÃO
Usuário: rcn(GESTOR_BOLSAS_GLOBAL), raiula(GESTOR_TIPOS_BOLSA)
Papel que usuário deve ter:
* SipacPapeis.GESTOR_BOLSAS_GLOBAL;
* SipacPapeis.GESTOR_TIPOS_BOLSA.
===== Cenários de Teste =====
Para registrar uma solicitação de cadastro de bolsa, veja [[desenvolvimento:especificacoes:sipac:portal_administrativo:casos_de_uso:bolsas:oportunidades_de_bolsas:listar_oportunidades_ativas_de_bolsas| Lista de Oportunidades de Bolsas]].
===== Dados para o Teste =====
Para saber os usuários que apresentam restrições de tipos de bolsas e quais são estes tipos ([[desenvolvimento:especificacoes:sipac:bolsas:casos_de_uso:operacoes:operacoes:atendimento_de_solicitacoes:inclusao_bolsista#Principais regras de negócio|RN01]]), podemos usar a consulta:
SELECT p.nome, u.login, t.denominacao, un.sigla
FROM bolsas.restricao_tipo_bolsa r
INNER JOIN comum.usuario u ON u.id_usuario = r.id_usuario
INNER JOIN comum.pessoa p ON p.id_pessoa = u.id_pessoa
INNER JOIN bolsas.tipo_bolsa t ON t.id = r.id_tipo_bolsa
INNER JOIN comum.unidade un ON un.id_unidade = t.id_unidade_pagadora
As cotas dos tipos de bolsas para as unidades ([[desenvolvimento:especificacoes:sipac:bolsas:casos_de_uso:operacoes:operacoes:atendimento_de_solicitacoes:inclusao_bolsista#Principais regras de negócio|RN02]], [[desenvolvimento:especificacoes:sipac:bolsas:casos_de_uso:operacoes:operacoes:atendimento_de_solicitacoes:inclusao_bolsista#Principais regras de negócio|RN03]]) podem ser verificadas pelo caminho:
* Módulos -> Bolsas -> Cadastros -> Cadastros -> Cotas de Bolsas -> Cadastrar/Alterar/Remover
A duração máxima de cada tipo de bolsa ([[desenvolvimento:especificacoes:sipac:bolsas:casos_de_uso:operacoes:operacoes:atendimento_de_solicitacoes:inclusao_bolsista#Principais regras de negócio|RN04]]) pode ser verificada através da seguinte consulta:
SELECT t.tempo_maximo
FROM bolsas.tipo_bolsa t INNER JOIN comum.unidade un ON un.id_unidade = t.id_unidade_pagadora
WHERE t.denominacao = ''
AND un.sigla = ''
O //**NOME DO TIPO DA BOLSA**// e //**SIGLA DA UNIDADE PAGADORA**// podem ser verificados nas informações das solicitações pendentes de atendimento no dado **//Tipo de Bolsa: Formato - TIPO DA BOLSA (SIGLA UNIDADE PAGADORA)//**
Para saber quais tipos de bolsa permite acumular ([[desenvolvimento:especificacoes:sipac:bolsas:casos_de_uso:operacoes:operacoes:atendimento_de_solicitacoes:inclusao_bolsista#Principais regras de negócio|RN05]]) podemos usar a consulta:
SELECT tipo.*
FROM bolsas.tipo_bolsa tipo INNER JOIN comum.unidade u ON u.id_unidade = tipo.id_unidade_pagadora
WHERE tipo.permite_acumular = true