~~ODT~~

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

======  Relatório de Consumo por Modalidade de ligação ======

Este caso de uso tem como finalidade de mostrar as despesas com as modalidades de ligações, inclusive o valor da tarifa cobrada por cada uma e os tempos das ligações. Se o usuário preferir, ele pode ver detalhes sobre o consumo por modalidade e por unidades.

Os envolvidos são os usuários responsáveis por fazer a manutenção do catálogo telefônico da instituição.


Pré-condições: O usuário deve possuir os perfis de Gestor de Faturas e Gestor de Telefones, ou Gestor de Acompanhamento de Faturas para executar esta funcionalidade.

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

Este caso de uso inicia quando o usuário acessa a opção: //SIPAC → Módulo Faturas → Aba Telefonia → Relatórios → Relatório de Consumo por Modalidade de ligação//.

O sistema solicita que o usuário informe um dos campos abaixo para efetuar a busca [[desenvolvimento:especificacoes:sipac:faturas:casos_de_uso:telefonia:relatorios:consumo_por_modalidade_de_ligacao#principais_regras_de_negócio|(RN01)]]:

  * **Ano***: Formato - AAAA, Tipo - NUMÉRICO.
  * **Mês**: Tipo - TEXTO.
  * **Tipo de Telefone**: Tipo - TEXTO. Opções: ''FIXO'', ''VOIP'', ''CELULAR'', ''VOIP'', ''FAX''.
  * **Unidade**: Tipo - TEXTO.
  * **Incluir Gastos das Unidades/Centros de Custo Vinculados**: Tipo - LÓGICO.


O usuário confirma a pesquisa e o sistema gera o relatório das modalidades conforme modelo abaixo:

{{:desenvolvimento:especificacoes:sipac:faturas:casos_de_uso:telefonia:relatorios:relatorio.png|}}

Se o usuário optar pela impressão, ele será direcionado para a página de impressão cujo o Modelo do Relatório será:


**Relatório de Consumo por Modalidade de ligação**

**__Período__**: FEVEREIRO/2009 a ABRIL/2009. 

**__Ano__.**

**__Mês__.** 

**__Tipo__.**

**__Unidade__:** NOME DA UNIDADE (CÓDIGO DA UNIDADE)

**__Incluído Gastos das Unidades/Centros de Custo Vinculados__**


**Exemplo de Relatório:**

{{:desenvolvimento:especificacoes:sipac:faturas:casos_de_uso:telefonia:relatorios:relatorio_impressao.png|}}



**Totalização dos valores:**
  * **Consumo:** Soma do consumo para cada tipo de ligação.
  * **Valor Gasto:** Soma do valor cada tipo de ligação.
  * A coluna Tarifa(R$/Min) é calculado como sendo Valor(R$)/Consumo.
  * Os valores de //consumo// e //valor gasto// são totalizados por Unidade e por Modalidade também (caso estas opções tenham sido expandidas).



**Gastos por Ligação**
^  ^  Consumo    ^   Fev. 2009 ^  Mar. 2009  ^ Abr. 2009 ^
| Custo Mensal(R$)  | 02:13:36  |  99,99  |  99,99  |  9,99  |
| Custo Médio (R$/Min)  | 02:13:36  |  99,99  |  99,99  |  9,99  |
| Custo Médio por Terminal(R$)  | 02:13:36  |  99,99  |  99,99  |  9,99  |

O Gráfico por ligação é gerado de acordo com perído selecionado.

Caso a opção de gráfico tenha sido selecionada, o sistema exibe o gráfico conforme modelo:

{{:desenvolvimento:especificacoes:sipac:faturas:casos_de_uso:telefonia:contas_telefonicas:relatorios:gastos_por_ligacao.png|}}

O caso de uso é finalizado

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

  * **RN01** - O limite de meses para uma consulta é 12. Se o usuário desejar verificar o relatório para um período maior que esse, ele deve gerar outra consulta.



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

Não se aplica.

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

^ Classe ^ Tabela |
| br.ufrn.sipac.faturas.telefones.dominio.LinhaTelefonica | administrativo_update_geral.contratos.linha_telefonica |
| br.ufrn.sipac.faturas.telefones.dominio.LigacaoTelefonica | administrativo_update_geral.contratos.ligacao_telefonica |

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

Sistema: SIPAC

Módulo: Faturas

Link(s): Faturas -> Telefonia -> Relatórios -> Consumo por Modalidade de ligação.

Usuário: lof

Papel que usuário deve ter: SipacPapeis.GESTOR_TELEFONES, SipacPapeis.GESTOR_ACOMPANHAMENTO_FATURAS, SipacPapeis_AUDITOR

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

Não se aplica


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

Para validar se os dados exibidos estão corretos verificar o relatório de [[desenvolvimento:especificacoes:sipac:faturas:casos_de_uso:telefonia:contas_telefonicas:relatorios:gastos_mensais_por_unidade_gestora|Relatório de Gastos Mensais por Unidade Gestora ]] informando o ano equivalente ao selecionado para a visualização do Relatório de Gastos Mensais por Unidade Gestora.
            * No relatório você terá a informação dos gastos de todas da unidades por mês e geral