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



====== Cadastrar Prestação de Contas de Auxílio Financeiro ao Estudante ======

Através deste caso de uso é possível cadastrar uma prestação de contas de uma Requisição de Auxílio Financeiro ao Estudante. Para isso a requisição de auxílio deverá já ter sido liquidada.

O caso de uso é acessado por gestores de auxílio financeiro e gestores de prestação de contas e alunos que possuem requisições destinadas a eles.


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

Este caso de uso inicia quando o usuário acessa a opção: //SIPAC -> Portal Administrativo -> Requisições -> Auxílio Financeiro ao Estudante -> Prestação de Contas de Auxílio Financeiro -> Cadastrar Prestação de Contas//.

Ao acessar o caso de uso são listadas as requisições que o usuário tem acesso ([[#principais_regras_de_negócio|RN02]]), ou mesmo realizar uma busca por requisições de auxílio financeiro utilizando os seguintes filtros:

  * **Número/Ano**: Tipo - NUMÉRICO. 
  * **Aluno Beneficiado**: Tipo - AUTOCOMPLETE, formato: NOME DO ALUNO- MATRICULA, entrada de dados: NOME DO ALUNO.
  * **Período de Cadastro**: Tipo - DATA. 
  * **Mostrar requisições com pendência de prestação de conta**: Tipo - BOOLEAN.
 

A listagem exibida contém as seguintes informações:

  * **__Requisição__**: Tipo NUMÉRICO, formato: 9.../AAAA.
  * **__Data de Cadastro__**: Tipo DATA, formato: DD/MM/AAAA.
  * **__Aluno Beneficiado__**: Pessoa a ser beneficiada pela reserva. Tipo TEXTO, formato: RAZÃO SOCIAL OU NOME (MATRICULA).
  * **__Unidade Requisitante__**: Unidade que está requisitando o auxílio financeiro. Formato: CÓDIGO / DENOMINAÇÃO DA UNIDADE. ([[#principais_regras_de_negócio|RN01]]).
  * **__Status__**: Status atual da requisição. Formato: [ENVIADA | CANCELADA | AUTORIZADA].

Ao selecionar uma requisição é direcionada para a página com as informações da requisição de auxílio selecionada e os dados a serem preenchidos da prestação de contas. Segue abaixos dados:


  ***__Requisição__**: Tipo - NUMÉRICO. Formato - 9.../AAAA.
  ***__Status__**: Tipo - TEXTO.
  ***__Unidade Requisitante__**: Tipo - TEXTO, formato: CÓDIGO - DENOMINAÇÃO UNIDADE.
  ***__Unidade de Custo__**: Tipo - TEXTO, formato: CÓDIGO - DENOMINAÇÃO UNIDADE.
  ***__Usuário__**: Tipo - TEXTO, formato: LOGIN - NOME USUÁRIO (RAMAL: NÚMERO RAMAL). 
  ***__Data__**: Tipo - DATA.
  ***__Data Inicial__**: Formato - DD/MM/AAAA. Tipo - DATA.
  ***__Data Final__**: Formato - DD/MM/AAAA. Tipo - DATA.
  ***__Valor da Requisição__**: Formato - DD/MM/AAAA. Tipo - NUMÉRICO.
  ***__Valor Solicitado à SAE__**: Tipo - NUMÉRICO.
  ***__Valor Autorizado pela SAE__**: Tipo - NUMÉRICO.
  ***__Opção Orçamentária__**: Tipo - TEXTO.
  ***__Descrição da Requisição__**: Tipo - TEXTO.
  ***__Justificativa da Requisição__**: Tipo - TEXTO.

Uma listagem dos alunos beneficiados é exibida, com os seguintes campos:

  * **__Alunos__**: Tipo - TEXTO e NUMÉRICO. Formato - MATRÍCULA - NOME ALUNO.
  * **__Quantidade__**: Tipo - NUMÉRICO.
  * **__Valor Unitário__**: Tipo - NUMÉRICO.
  * **__Total__**: Tipo - NUMÉRICO.
  * **__Banco__**: Tipo - TEXTO.
  * **__Conta__**: Tipo - NUMÉRICO.
  * **__Agência__**: Tipo - NUMÉRICO.

Uma listagem dos alunos que receberão o auxílio em conta bancária também é exibida:

  * **__Alunos__**: Tipo - TEXTO e NUMÉRICO. Formato - MATRÍCULA - NOME ALUNO.
  * **__Banco__**: Tipo - TEXTO.
  * **__Conta__**: Tipo - NUMÉRICO.
  * **__Agência__**: Tipo - NUMÉRICO.
  * **__Var.__**: Tipo NUMÉRICO.
  * **__Valor__**: Tipo NUMÉRICO.

E as movimentações da prestação de contas também são exibidas em forma de listagem:

  ***__Data/Hora__**: Formato - DD/MM/AAAA HH:MM. Tipo - DATA.
  ***__Observação__**: Tipo - TEXTO.
  ***__Usuário de Cadastro__**: Tipo - TEXTO.
  ***__Status__**: Tipo - TEXTO.
 
É requerido que o usuário informe os dados da prestação de contas, informando os seguintes dados obrigatórios:

  * **Aluno Prestador de Contas**: Tipo - TEXTO, formato: NOME DO ALUNO - CPF.
  * **Texto**: Tipo - TEXTO. 
  * **Anexar Arquivo**: Tipo - TEXTO. 

Os arquivos anexados são exibidas em forma de listagem:

O caso de uso é finalizado.

  ***__Nº__**: Tipo - NUMÉRICO.
  ***__Arquivo__**: Tipo - TEXTO.
  ***__Tamanho__**: Tipo - NUMÉRICO.

É oferecida opção para remover o arquivo anexado.


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

   * **RN01** - O preenchimento de todos os campos é obrigatório.
   * **RN02** - Caso o usuário seja um aluno, serão apresentadas apenas requisições o qual ele seja um dos beneficiados.
   * **RN03** - Não será possível selecionar requisições com status NEGADAS ou ESTORNADAS.
   * **RN04** - O aluno não poderá efetuar a prestação de contas após passado o período setado no parâmetro PRAZO_MAXIMO_PRESTACAO_CONTAS_AUXILIO_FINANCEIRO_ESTUDANTE em dias da data fim da requisição, a partir daí só poderá ser efetuada prestação de contas pelo gestor.
   * **RN05** - A partir da data especificada no parâmetro DATA_BLOQUEIO_PRESTACAO_CONTAS_AUXILIO_FINANCEIRO_ESTUDANTE será exigido que todas as requisições de auxílio financeiro a estudantes possuam prestação de contas de todos os estudantes que receberão verba em conta bancária. Caso isso não ocorra, não será mais possível o estudante ser um dos beneficiado em novas requisições de auxílio financeiro, conforme a [[#principais_regras_de_negócio|RN06]].
   * **RN06** - Caso o aluno não preste contas, ele não poderá ser referenciado em novas requisições de auxílio financeiro com data fim apos o parâmetro DATA_BLOQUEIO_PRESTACAO_CONTAS_AUXILIO_FINANCEIRO_ESTUDANTE.
  

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

Não se aplica.


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

^ Classe ^ Tabela |
| br.ufrn.sipac.requisicoes.auxilio.dominio.ReqAuxilioFinanceiro | administrativo.requisicoes.requisicao_aux_fin |
| br.ufrn.sipac.requisicoes.auxilio.dominio.PrestacaoContaAuxilioFinanceiroEstudante | administrativo.requisicoes.prestacao_contas_auxilio_estudante |
| br.ufrn.sipac.requisicoes.auxilio.dominio.MovimentoPrestacaoContaAuxilioEstudante | administrativo.requisicoes.movimento_prestacao_contas_auxilio_estudante |


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

Sistema: SIPAC

Módulo: Portal Administrativo

Link(s): Requisições -> Auxílio Financeiro ao Estudante -> Prestação de Contas de Auxílio Financeiro -> Cadastrar Prestação de Contas

Usuário: 

  * breno2k7 (PRESTADOR_CONTAS_AUXILIO_FINANCEIRO)
  * asca (GESTOR_AUXILIO_FINANCEIRO / GESTOR_PRESTADOR_CONTAS_AUXILIO_FINANCEIRO)

Papel que usuário deve ter: SipacPapeis.PRESTADOR_CONTAS_AUXILIO_FINANCEIRO, SipacPapeis.GESTOR_PRESTADOR_CONTAS_AUXILIO_FINANCEIRO, SipacPapeis.REQUISITOR_AUXILIO_FINANCEIRO, SipacPapeis.REQUISITOR, SipacPapeis.GESTOR_AUXILIO_FINANCEIRO e SipacPapeis.RESPONSAVEL_UNIDADE.


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

Siga os passos para **Cadastrar Requisição**, para ser utilizada na prestação de contas:
  - Portal Administrativo -> Requisições -> Auxílio Financeiro ao Estudante -> Cadastrar requisição.
  - Caso tenha bens ou processos a receber, receba-os para estar apto a Cadastrar requisição.
  - Buscar um estudante ''ativo'' inserir os dados obrigatórios e os Dados Bancários.
  - Preencher os campos obrigatórios.
  - Clicar em ''Cadastrar''.

Entrar como usuário gestor de auxilio financeiro e:
  - Atender a requisição pelo caminho SIPAC -> Atendimento de Requisição -> Atender

Entrar como usuário com acesso ao orçamento e proceder o [[desenvolvimento:especificacoes:sipac:orcamentario:casos_de_uso:movimentacoes:empenho:registrar_nota_de_empenho|registro de nota de empenho]] (vinculada a requisição). Valores sugeridos para alguns dos campos solicitados:
  - **Credor:** Banco do Brasil
  - **PTRes:** 2353
  - **Fonte de recurso:** Tesouro
  - **Esfera:** 1
  - **P.Interno:** 1010

Depois deve-se **Cadastrar Prestação de Contas**, seguindo os seguintes passos:
  - Portal Administrativo -> Requisições -> Auxílio Financeiro ao Estudante -> Prestação de contas de auxílio financeiro -> Cadastrar Prestação de Contas.
  - Selecione a requisição cadastrada anteriormente.
  - Preencher os campos obrigatórios.
  - Clicar em ''Cadastrar''.
===== Dados para o Teste =====

Para consulta de prestações de contas disponíveis, segue select:

<code sql>
SELECT DISTINCT p.* FROM requisicoes.requisicao_aux_fin r
JOIN comum.usuario u on u.id_usuario = r.id_usuario
JOIN requisicoes.prestacao_contas_auxilio_estudante p on p.id_req_auxilio_financeiro = r.id

-- Para testar com ano diferente do atual use: '< ano atual' e igual ao atual: '= ano atual'
WHERE r.id_status = 100 AND r.ano < 2011
</code>