~~ODT~~

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

======  Auxílios Concedidos ao Estudante   ======
Este relatório exibe o quanto foi gasto com cada aluno devido a auxílios financeiros.
Usado por todos os gestores de auxílios para acompanhamento de gastos.

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

Este caso de uso inicia quando o usuário acessa a opção: //SIPAC -> Atendimento de Requisições -> Auxílio Financeiro ao Estudante -> Relatórios -> Auxílios Concedidos ao Estudante//.

Para a geração do relatório um dos seguintes filtros deve ser preenchido:

  * **Aluno**: Formato - NOME DO DISCENTE (MATRÍCULA). Tipo - AUTOCOMPLETE.
  * **Período da Solicitação**: Tipo - TEXTO.
  * **Período do Empenho**: Tipo - TEXTO.
  * **Unidade requisitante**: Formato - SIGLA - NOME DA UNIDADE - CÓDIGO. Tipo - AUTOCOMPLETE.
  * **Unidade de custo**: Tipo - AUTOCOMPLETE. 

O relatório gerado segue o formato abaixo:

**Filtros Selecionados**
^ Requisição ^ Aluno ^ Curso ^ Centro ^ Programa de Trabalho ^ Unidade de Custo ^ Fonte de Recurso ^ Valor |
| 9.../AAAA | NOME (MATRÍCULA) | NOME DO CURSO | NOME DO CENTRO | PTRes (CÓDIGO) | UNIDADE (CÓDIGO) | FONTE DE RECURSO | 99,99 | 
| ------ | ------ | ------ | ------ | ------ | ------ | ------ | ------ |

O caso de uso é finalizado.

===== Principais regras de negócio =====

  * **RN01** - A quantidade de auxílios corresponde ao as requisições com status ''EMPENHADA'' o ano da requisição compreenda o período informado. 
  * **RN02** - O valor dos auxílios correspondem aos valores unitários dos ItemAuxilio presentes nas requisições da consulta anterior e do aluno consultado.

<ifauth @admin>

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

^ Classe ^ Tabela |
| br.ufrn.sipac.convenios.orcamento.dominio.AuxilioFinanceiroEstudante | convenios_orcamento.auxilio_financeiro_estudante |

===== Plano de Testes =====
Sistema: SIPAC

Módulo: Atendimento de Requisições

Link(s):Auxílio Financeiro ao Estudante -> Relatórios -> Auxílios Concedidos ao Estudante 

Usuário: babi.87

Papel que usuário deve ter: SipacPapeis.GESTOR_AUXILIO_FINANCEIRO


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

Não se aplica.

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

Abaixo é mostrada uma query que permite trazer todos os alunos, com todos os gastos agrupados por ano com os mesmos. Query feita para facilitar a verificação de consistência do relatório.

     select a.nome, r.ano, count(r.id), sum(i.valor) from requisicoes.requisicao_aux_fin as r left join 
          requisicoes.item_req_aux_fin as i on i.ID_REQ_AUX_FIN = r.id
          left join academico.aluno as a on i.id_aluno = a.id_aluno
     where r.id_status in (109, 105) group by a.nome, r.ano
     order by a.nome, r.ano DESC
     
</ifauth>