SESP/sgse-app
2
0
Fork 0
Code Issues 3 Pull Requests 1 Actions Packages Projects Releases Wiki Activity

feat: enhance Banco de Horas management with new reporting features, including adjustments and inconsistencies tracking, advanced filters, and Excel export functionality

Browse Source
This commit is contained in:
deyvisonwanderley
2025-12-06 09:32:55 -03:00
parent 72450d1f28
commit aec3201410
14 changed files with 4730 additions and 22 deletions
Download Patch File Download Diff File Expand all files Collapse all files

319
TESTES_BANCO_HORAS.md Normal file
View File

@@ -0,0 +1,319 @@
# Plano de Testes - Sistema de Banco de Horas
## Objetivo
Validar todas as funcionalidades do sistema de banco de horas, incluindo:
- Registros de ponto
- Atestados médicos
- Licenças (maternidade, paternidade)
- Ausências aprovadas
- Ajustes manuais (abonar, descontar, compensar)
- Detecção de inconsistências
- Alertas configuráveis
- Relatórios (PDF e Excel)
## Usuário de Teste
- Email: dfw@poli.br
- Senha: Admin@2025
- Perfil: Funcionário e Gestor (pode aprovar suas próprias solicitações)
## Cenários de Teste
### 1. Teste de Registros de Ponto Básicos
**Objetivo:** Verificar se o sistema calcula corretamente o banco de horas com registros normais
**Passos:**
1. Fazer login com dfw@poli.br
2. Navegar para "Meu Perfil" > "Meu Ponto"
3. Registrar ponto para 5 dias consecutivos com horários normais:
- Dia 1: Entrada 08:00, Saída Almoço 12:00, Retorno 13:00, Saída 17:00 (8h trabalhadas)
- Dia 2: Entrada 08:00, Saída Almoço 12:00, Retorno 13:00, Saída 17:00 (8h trabalhadas)
- Dia 3: Entrada 08:00, Saída Almoço 12:00, Retorno 13:00, Saída 17:00 (8h trabalhadas)
- Dia 4: Entrada 08:00, Saída Almoço 12:00, Retorno 13:00, Saída 17:00 (8h trabalhadas)
- Dia 5: Entrada 08:00, Saída Almoço 12:00, Retorno 13:00, Saída 17:00 (8h trabalhadas)
4. Verificar em "Meu Banco de Horas" se o saldo está correto (deve ser 0 ou próximo de 0)
**Resultado Esperado:** Saldo diário e mensal calculado corretamente
---
### 2. Teste de Horas Extras
**Objetivo:** Verificar cálculo de horas extras
**Passos:**
1. Registrar ponto com horas extras:
- Entrada 08:00, Saída Almoço 12:00, Retorno 13:00, Saída 19:00 (9h trabalhadas = +1h extra)
2. Verificar em "Meu Banco de Horas" se o saldo positivo foi registrado
**Resultado Esperado:** Saldo positivo de 1 hora registrado
---
### 3. Teste de Horas Negativas (Atraso/Saída Antecipada)
**Objetivo:** Verificar cálculo de horas negativas
**Passos:**
1. Registrar ponto com atraso:
- Entrada 09:00, Saída Almoço 12:00, Retorno 13:00, Saída 17:00 (7h trabalhadas = -1h)
2. Verificar em "Meu Banco de Horas" se o saldo negativo foi registrado
**Resultado Esperado:** Saldo negativo de 1 hora registrado
---
### 4. Teste de Atestado Médico
**Objetivo:** Verificar se atestado médico é considerado no banco de horas
**Passos:**
1. Navegar para "Meu Perfil" > "Minha Ausência" ou área de atestados
2. Criar um atestado médico para 2 dias consecutivos
3. Verificar se o banco de horas foi recalculado automaticamente
4. Verificar em "Meu Banco de Horas" se os dias de atestado aparecem com tipo "atestado"
5. Verificar se o saldo não foi descontado para esses dias
**Resultado Esperado:**
- Dias de atestado marcados como tipo "atestado"
- Saldo não descontado
- Motivo do abono registrado
---
### 5. Teste de Declaração de Comparecimento
**Objetivo:** Verificar se declaração de comparecimento é considerada
**Passos:**
1. Criar uma declaração de comparecimento para 1 dia
2. Verificar se o banco de horas foi recalculado
3. Verificar se o dia aparece com tipo apropriado
**Resultado Esperado:** Dia marcado corretamente e saldo não descontado
---
### 6. Teste de Licença de Maternidade
**Objetivo:** Verificar se licença de maternidade é considerada
**Passos:**
1. Criar uma licença de maternidade para 5 dias
2. Verificar se o banco de horas foi recalculado
3. Verificar se os dias aparecem com tipo "licenca"
**Resultado Esperado:** Dias marcados como tipo "licenca" e saldo não descontado
---
### 7. Teste de Licença de Paternidade
**Objetivo:** Verificar se licença de paternidade é considerada
**Passos:**
1. Criar uma licença de paternidade para 3 dias
2. Verificar se o banco de horas foi recalculado
3. Verificar se os dias aparecem com tipo "licenca"
**Resultado Esperado:** Dias marcados como tipo "licenca" e saldo não descontado
---
### 8. Teste de Ausência Aprovada
**Objetivo:** Verificar se ausência aprovada é considerada
**Passos:**
1. Navegar para "Meu Perfil" > "Minha Ausência"
2. Solicitar uma ausência para 2 dias
3. Navegar para "Aprovar Ausência" (como gestor)
4. Aprovar a ausência
5. Verificar se o banco de horas foi recalculado
6. Verificar se os dias aparecem com tipo "ausencia"
**Resultado Esperado:** Dias marcados como tipo "ausencia" e saldo não descontado
---
### 9. Teste de Ajuste Manual - Abonar
**Objetivo:** Verificar se ajuste manual de abono funciona
**Passos:**
1. Navegar para área de ajustes de banco de horas (RH ou gestor)
2. Criar um ajuste para abonar 4 horas de um dia específico
3. Verificar se o banco de horas foi recalculado
4. Verificar se o dia aparece com tipo "abonado"
5. Verificar se o saldo foi ajustado corretamente
**Resultado Esperado:** Dia marcado como "abonado" e saldo ajustado com +4 horas
---
### 10. Teste de Ajuste Manual - Descontar
**Objetivo:** Verificar se ajuste manual de desconto funciona
**Passos:**
1. Criar um ajuste para descontar 2 horas de um dia específico
2. Verificar se o banco de horas foi recalculado
3. Verificar se o dia aparece com tipo "descontado"
4. Verificar se o saldo foi ajustado corretamente
**Resultado Esperado:** Dia marcado como "descontado" e saldo ajustado com -2 horas
---
### 11. Teste de Ajuste Manual - Compensar
**Objetivo:** Verificar se ajuste manual de compensação funciona
**Passos:**
1. Criar um ajuste para compensar horas (transferir horas extras para compensar déficit)
2. Verificar se o banco de horas foi recalculado
3. Verificar se o saldo foi ajustado corretamente
**Resultado Esperado:** Saldo ajustado conforme a compensação
---
### 12. Teste de Detecção de Inconsistências - Ponto com Atestado
**Objetivo:** Verificar se o sistema detecta inconsistências
**Passos:**
1. Criar um atestado médico para um dia
2. Registrar ponto para esse mesmo dia (inconsistência)
3. Verificar se uma inconsistência foi detectada e registrada
4. Verificar se aparece na lista de inconsistências
**Resultado Esperado:** Inconsistência detectada e registrada
---
### 13. Teste de Detecção de Inconsistências - Ponto com Licença
**Objetivo:** Verificar detecção de ponto durante licença
**Passos:**
1. Criar uma licença para um dia
2. Registrar ponto para esse mesmo dia
3. Verificar se inconsistência foi detectada
**Resultado Esperado:** Inconsistência detectada
---
### 14. Teste de Detecção de Inconsistências - Ponto com Ausência
**Objetivo:** Verificar detecção de ponto durante ausência aprovada
**Passos:**
1. Aprovar uma ausência para um dia
2. Registrar ponto para esse mesmo dia
3. Verificar se inconsistência foi detectada
**Resultado Esperado:** Inconsistência detectada
---
### 15. Teste de Saldo Negativo Excedido
**Objetivo:** Verificar se alerta é disparado quando saldo negativo excede limite
**Passos:**
1. Configurar limite de saldo negativo em "Painel de TI" > "Configurações do Banco de Horas"
2. Criar vários registros que resultem em saldo negativo acima do limite
3. Verificar se alerta foi disparado
**Resultado Esperado:** Alerta disparado quando limite é excedido
---
### 16. Teste de Configuração de Alertas
**Objetivo:** Verificar se configurações de alertas funcionam
**Passos:**
1. Navegar para "Painel de TI" > "Configurações do Banco de Horas"
2. Configurar alertas:
- Ativar alertas
- Configurar periodicidade (diário, semanal, mensal)
- Configurar canais (email, chat)
- Configurar thresholds
3. Salvar configurações
4. Verificar se configurações foram salvas
**Resultado Esperado:** Configurações salvas e aplicadas
---
### 17. Teste de Relatório PDF
**Objetivo:** Verificar geração de relatório PDF
**Passos:**
1. Navegar para "Meu Banco de Horas"
2. Clicar em "Exportar PDF"
3. Verificar se PDF foi gerado com:
- Resumo mensal
- Detalhamento diário
- Ajustes
- Inconsistências
- Gráficos
**Resultado Esperado:** PDF gerado com todas as informações
---
### 18. Teste de Relatório Excel
**Objetivo:** Verificar geração de relatório Excel
**Passos:**
1. Navegar para "Meu Banco de Horas"
2. Clicar em "Exportar Excel"
3. Verificar se Excel foi gerado com:
- Planilhas detalhadas
- Resumos
- Formatação condicional
**Resultado Esperado:** Excel gerado com todas as informações
---
### 19. Teste de Visualização Gerencial (RH)
**Objetivo:** Verificar wizard de banco de horas no RH
**Passos:**
1. Navegar para "Recursos Humanos" > "Controle de Ponto" > "Banco de Horas"
2. Verificar se é possível:
- Filtrar por funcionário
- Filtrar por período
- Ver todos os funcionários
- Ver ajustes e inconsistências
- Fazer ajustes manuais
**Resultado Esperado:** Wizard funcional com todos os filtros e ações
---
### 20. Teste de Histórico e Acumulação Mensal
**Objetivo:** Verificar se histórico mensal é mantido corretamente
**Passos:**
1. Verificar em "Meu Banco de Horas" se:
- Saldo inicial do mês está correto
- Saldo final do mês está correto
- Saldo acumulado está correto
- Histórico de meses anteriores está disponível
**Resultado Esperado:** Histórico completo e correto
---
## Checklist de Validação
Após cada teste, verificar:
- [ ] Cálculo de saldo está correto
- [ ] Tipo de dia está correto (normal, atestado, licenca, ausencia, abonado, descontado)
- [ ] Motivo do abono está registrado
- [ ] Ajustes estão vinculados corretamente
- [ ] Inconsistências estão sendo detectadas
- [ ] Alertas estão sendo disparados quando configurados
- [ ] Relatórios estão sendo gerados corretamente
- [ ] Interface está mostrando todas as informações
- [ ] Não há erros no console do navegador
- [ ] Não há erros no backend (logs do Convex)
---
## Notas
- Todos os testes devem ser executados sequencialmente
- Se algum teste falhar, corrigir o erro e repetir o teste
- Documentar qualquer comportamento inesperado
- Verificar logs do Convex para erros no backend