====== Saldo de Horas por Período ======

Este relatório permite gerar uma listagem de registro de ponto efetuadas pelo servidor. O relatório exibe a totalização dos períodos e os respectivos saldos de horas.[[#principais_regras_de_negócio|(RN02)]]

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

Este caso de uso inicia-se seguindo o seguinte caminho: ''SIGRH → Portal do Servidor → Consultas → Frequência → Saldo de Horas por Período''.

Este caso de uso é descrito em: [[desenvolvimento:especificacoes:sigrh:frequencia:casos_de_uso:ponto_eletronico:relatorios:saldo_de_horas_por_periodo|Saldo de Horas por período]] presente no módulo Frequência.


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

  * **RN01**: Não é permitido informar o campo de ''Servidor'' nesse fluxo.
  * **RN02:** O caso de uso estará disponível somente aos usuários que não estiverem no parâmetro SERVIDORES_DISPENSADOS_FREQUENCIA;
==== Resoluções/Legislações Associadas ====


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

^ Classe                                                    ^ Tabela                                    ^
| br.ufrn.sigrh.frequencia.ponto.dominio.FrequenciaPontoMensal | administrativo.frequencia.frequencia_ponto_mensal |
| br.ufrn.sigrh.frequencia.ponto.dominio.PontoDiario      | administrativo.frequencia.ponto_diario      |
| br.ufrn.sigrh.frequencia.ponto.dominio.HorarioPonto | administrativo.frequencia.horario_ponto |


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


Sistema: SIGRH

Módulo: Frequência

Link(s): SIGRH → Portal do Servidor → Consultas → Frequência → Saldo de Horas por Período

Usuário: mirian

Papel que usuário deve ter: O usuário deve ser um servidor.

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


  * Primeiramente devem existir registros de HorarioPonto cadastrados para o servidor consultado.
  * Para consultar registros homologados, o usuário deverá realizar a homologação da frequência de um servidor em um determinado mês, através do caso de uso de [[desenvolvimento:especificacoes:sigrh:portal_do_servidor:casos_de_uso:chefia_de_unidade:homologacoes:frequencia|Homologar Frequências]]
  * Realizar a geração do relatório e comparar os resultados e as totalizações com as consultas SQL presentes no campo de Dados para o Teste.
===== Dados para o Testes =====

<codesql>
/* Consulta os registro */
SELECT * FROM frequencia.horario_ponto 
WHERE id_servidor = ?
</code>

<codesql>
/*Consulta que retorna os registros de ponto diário que não tenham sido estornados para um determinado servidor.
Utilizado para verificar o agrupamento diário.*/
SELECT * FROM frequencia.ponto_diario pd WHERE pd.data_estorno IS NULL 
AND pd.id_servidor = ? AND pd.id_frequencia_ponto_mensal IS NOT NULL 
AND pd.data BETWEEN ? AND ? ORDER BY pd.data
</code>


<codesql>
/* Consulta que retorna os registros de frequencia_ponto_mensal */
SELECT * FROM frequencia.frequencia_ponto_mensal fpm WHERE fpm.data_estorno IS NULL AND id_servidor = ?
</code>