~~ODT~~

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

====== Gastos de contrato por Categoria de Despesa ======

Este caso de uso é utilizado pelos gestores de contrato  com a finalidade de verificar os gastos associados as categorias de despesas em um determinado período.

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

O caso de uso é acionado quando o usuário acessa a opção: SIPAC -> Módulo Contratos -> Consultas/Relatórios -> Pagamento -> Gastos de contrato por Categoria de Despesa.

O sistema solicita que informe os dados do contrato:

  * **Contrato(Número/Ano)** *: Tipo NUMÉRICO, formato: 9.../AAAA.
  * **Período**: Tipo DATA, formato: <Mês Inicial>/<Ano Inicial> a <Mês Final>/<Ano Final>.( [[#PRINCIPAIS REGRAS DE NEGÓCIO|RN01]] )

O usuário confirma e o sistema exibe lista com os contratos encontrados, exibindo os atributos:( [[#PRINCIPAIS REGRAS DE NEGÓCIO|RN02]] )

  * **__Número/Ano__**: Tipo NUMÉRICO, formato: 9.../AAAA.
  * **__Tipo__**: Tipo TEXTO.
  * **__Vigência__**: Tipo DATA, formato: <Data Inicial> - <Data Final>.
  * **__Duração__**: Tipo TEXTO, formato: N mês(es).
  * **__Valor Atual(R$)__**: Tipo MOEDA.
  * **__Licitação (Modalidade Número/Ano - Gestora)__**: Formato - Modalidade - 9.../AAAA - UNIDADE.
  * **__Fornecedor__**: Tipo TEXTO.
  * **__Objeto__**: Tipo TEXTO.

O Sistema exibe relatório no formato: ( [#PRINCIPAIS REGRAS DE NEGÓCIO|RN03]] )

GASTOS DE CONTRATO POR CATEGORIA DE DESPESA

**__Número/Ano do Contrato__**: Tipo NUMÉRICO, formato: 9.../AAAA.

**__Período__**: Tipo DATA, formato: <Data Inicial> - <Data Final>. ( [[#PRINCIPAIS REGRAS DE NEGÓCIO|RN04]] )
  

^ Mês/Ano            ^           ^
^ Categoria          ^ Valor     ^
| JAN/2012                      ||
| Categoria 01       | R$ 99,99  |
| **Total Mensal:**  | R$ 99,99  |
| FEV/2012                      ||
| Categoria 02       | R$ 99,99  |
| **Total Mensal:**  | R$ 99,99  |
| **Total:**         |  R$ 99,99 |



Então o caso de uso é finalizado. 

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

  * **RN01** - Só considera os dados do período informado caso seja selecionado o checkbox.
  * **RN02** - A listagem somente é exibida se houver ocorrência de mais de um contrato com o mesmo número e ano fornecidos pelo gestor.
  * **RN03** - Só é gerado relatórios de contratos que possui gastos detalhados no momento da inserção das notas fiscais.
  * **RN04** - Exibido somente se a opção //Período// for selecionada.
==== Resoluções/Legislações Associadas ====

Não se Aplica.  

===== Classes Persistentes e Tabelas Envolvidas =====
^ Classe ^ Tabela |
| br.ufrn.sipac.contratos.dominio.Contrato           | administrativo.contratos.contrato           |
| br.ufrn.sipac.contratos.dominio.ReferenciaCategoriaGasto    | administrativo.contratos.referencia_categoria_gasto   |

====== Plano de Testes ======


Sistema: SIPAC

Módulo: Contratos

Link(s): SIPAC -> Módulo Contratos -> Consultas/Relatórios -> Pagamento -> Gastos de contrato por Categoria de Despesa.

Usuário: 

  * afnd (GESTOR_CONTRATOS);
  * rcsl (GESTOR_CONTRATOS_GLOBAL);

Papel que usuário deve ter: 
  * SipacPapeis.GESTOR_CONTRATO, 
  * SipacPapeis.GESTOR_CONTRATOS_GLOBAL

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

  * Verificar se os valores da soma dos gastos estão corretas com os valores distribuidos no momento das associações com as notas ficais.
  * Verificar totalizadores.

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

  * Cadastrar um contrato com unidade beneficiada que permita associação de notas pela gestora e que possuia categorias de gastos;
  * Associar Notas fiscais ao contrato e distribuir os valores em suas categorias de despesas;
  * Gerar o relatório do contrato trabalhado;