feat: enhance vacation management system with new employee association functionality, improved email notification handling, and comprehensive documentation; update dependencies and UI components for better user experience
This commit is contained in:
304
TESTAR_FERIAS_PASSO_A_PASSO.md
Normal file
304
TESTAR_FERIAS_PASSO_A_PASSO.md
Normal file
@@ -0,0 +1,304 @@
|
||||
# 🧪 TESTAR SISTEMA DE FÉRIAS - PASSO A PASSO
|
||||
|
||||
**Data:** 30 de outubro de 2025
|
||||
**Objetivo:** Criar funcionário de teste e validar todo o fluxo de férias
|
||||
|
||||
---
|
||||
|
||||
## 🚀 PASSO 1: Criar Funcionário de Teste para TI Master
|
||||
|
||||
### Opção A: Via Convex Dashboard (Recomendado)
|
||||
|
||||
1. **Acesse o Convex Dashboard:**
|
||||
```
|
||||
https://dashboard.convex.dev
|
||||
```
|
||||
|
||||
2. **Vá para a seção "Functions"**
|
||||
|
||||
3. **Encontre a função:** `criarFuncionarioTeste:criarFuncionarioParaTIMaster`
|
||||
|
||||
4. **Execute com estes argumentos:**
|
||||
```json
|
||||
{
|
||||
"usuarioEmail": "ti.master@sgse.pe.gov.br"
|
||||
}
|
||||
```
|
||||
|
||||
5. **Você verá o resultado:**
|
||||
```json
|
||||
{
|
||||
"sucesso": true,
|
||||
"funcionarioId": "abc123..."
|
||||
}
|
||||
```
|
||||
|
||||
### Opção B: Via Console do Browser
|
||||
|
||||
1. **Abra o console do navegador (F12)**
|
||||
|
||||
2. **Cole e execute este código:**
|
||||
```javascript
|
||||
// No console do navegador, dentro do sistema SGSE
|
||||
const convex = window.convex; // ou acesse o client Convex do app
|
||||
|
||||
await convex.mutation(api.criarFuncionarioTeste.criarFuncionarioParaTIMaster, {
|
||||
usuarioEmail: "ti.master@sgse.pe.gov.br"
|
||||
});
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## ✅ PASSO 2: Verificar Criação do Funcionário
|
||||
|
||||
1. **Recarregue a página do perfil**
|
||||
- Pressione `F5` ou `Ctrl+R`
|
||||
|
||||
2. **Verifique se o erro sumiu**
|
||||
- Acesse: Perfil > Minhas Férias
|
||||
- Agora deve aparecer o **Dashboard de Férias** ✨
|
||||
|
||||
---
|
||||
|
||||
## 🧪 PASSO 3: Testar Fluxo Completo de Solicitação
|
||||
|
||||
### 3.1. Visualizar Dashboard
|
||||
```
|
||||
✅ Deve mostrar:
|
||||
- 4 Cards estatísticos (Disponível, Usado, Pendente, Total)
|
||||
- 2 Gráficos de pizza
|
||||
- Tabela de histórico de saldos
|
||||
- Botão "Solicitar Novas Férias"
|
||||
```
|
||||
|
||||
### 3.2. Iniciar Wizard de Solicitação
|
||||
|
||||
1. **Click em "Solicitar Novas Férias"**
|
||||
|
||||
2. **PASSO 1 - Ano & Saldo:**
|
||||
```
|
||||
✅ Escolha o ano: 2024 ou 2025
|
||||
✅ Verifique o saldo disponível: 30 dias
|
||||
✅ Veja o regime: "CLT - Consolidação das Leis do Trabalho"
|
||||
✅ Click em "Próximo"
|
||||
```
|
||||
|
||||
3. **PASSO 2 - Selecionar Períodos:**
|
||||
```
|
||||
✅ Arraste no calendário para selecionar o primeiro período
|
||||
✅ Adicione mais períodos (até 3 para CLT)
|
||||
✅ Observe as validações em tempo real:
|
||||
- Verde: tudo certo ✅
|
||||
- Vermelho: erro (ex: período muito curto) ❌
|
||||
- Amarelo: aviso (ex: saldo baixo) ⚠️
|
||||
✅ Click em "Próximo"
|
||||
```
|
||||
|
||||
4. **PASSO 3 - Confirmação:**
|
||||
```
|
||||
✅ Revise todos os períodos
|
||||
✅ Adicione observação (opcional)
|
||||
✅ Click em "Enviar Solicitação"
|
||||
```
|
||||
|
||||
5. **Sucesso!**
|
||||
```
|
||||
✅ Toast verde: "Solicitação enviada com sucesso! 🎉"
|
||||
✅ Retorna ao dashboard
|
||||
✅ Atualiza estatísticas
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🧪 PASSO 4: Testar Validações CLT
|
||||
|
||||
### Teste 1: Período muito curto ❌
|
||||
```
|
||||
Tente criar: 3 dias
|
||||
Resultado esperado: "Período de 3 dias é inválido. Mínimo: 5 dias corridos (CLT)"
|
||||
```
|
||||
|
||||
### Teste 2: Muitos períodos ❌
|
||||
```
|
||||
Tente criar: 4 períodos
|
||||
Resultado esperado: "Máximo de 3 períodos permitidos para CLT"
|
||||
```
|
||||
|
||||
### Teste 3: Sem período principal ❌
|
||||
```
|
||||
Crie 3 períodos:
|
||||
- 10 dias
|
||||
- 10 dias
|
||||
- 10 dias
|
||||
Resultado esperado: "Ao dividir férias em CLT, um período deve ter no mínimo 14 dias corridos"
|
||||
```
|
||||
|
||||
### Teste 4: Solicitação válida ✅
|
||||
```
|
||||
Crie 3 períodos:
|
||||
- 15 dias (Principal)
|
||||
- 10 dias
|
||||
- 5 dias
|
||||
Resultado esperado: "✅ Períodos válidos! Total: 30 dias"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🧪 PASSO 5: Testar Regime Servidor Público PE
|
||||
|
||||
### 5.1. Alterar Regime do Funcionário
|
||||
|
||||
**Via Convex Dashboard:**
|
||||
```json
|
||||
// Função: criarFuncionarioTeste:alterarRegimeTrabalho
|
||||
{
|
||||
"funcionarioId": "SEU_FUNCIONARIO_ID",
|
||||
"novoRegime": "estatutario_pe"
|
||||
}
|
||||
```
|
||||
|
||||
### 5.2. Testar Validações Servidor PE
|
||||
|
||||
**Teste 1: 3 períodos ❌**
|
||||
```
|
||||
Tente criar: 3 períodos
|
||||
Resultado esperado: "Máximo de 2 períodos permitidos para Servidor Público Estadual de Pernambuco"
|
||||
```
|
||||
|
||||
**Teste 2: Período curto ❌**
|
||||
```
|
||||
Tente criar: 8 dias
|
||||
Resultado esperado: "Período de 8 dias é inválido. Mínimo: 10 dias corridos (Servidor Público...)"
|
||||
```
|
||||
|
||||
**Teste 3: Solicitação válida ✅**
|
||||
```
|
||||
Crie 2 períodos:
|
||||
- 20 dias
|
||||
- 10 dias
|
||||
Resultado esperado: "✅ Períodos válidos! Total: 30 dias"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎯 PASSO 6: Testar Aprovação de Férias (Gestor)
|
||||
|
||||
### 6.1. Configurar Time e Gestor
|
||||
|
||||
**Via TI > Times e Membros:**
|
||||
```
|
||||
1. Criar um time de teste
|
||||
2. Adicionar funcionário como membro
|
||||
3. Configurar você (TI Master) como gestor
|
||||
```
|
||||
|
||||
### 6.2. Aprovar Solicitação
|
||||
|
||||
**Via Perfil > Aprovar Férias:**
|
||||
```
|
||||
1. Ver lista de solicitações pendentes
|
||||
2. Click em "Ver Detalhes"
|
||||
3. Aprovar / Reprovar / Ajustar
|
||||
4. Verificar notificação no sino
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📊 PASSO 7: Verificar Analytics
|
||||
|
||||
### Dashboard deve mostrar:
|
||||
```
|
||||
✅ Gráfico de Saldo atualizado
|
||||
✅ Estatísticas corretas
|
||||
✅ Histórico de solicitações
|
||||
✅ Status visual (badges coloridos)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🐛 TROUBLESHOOTING
|
||||
|
||||
### Problema: "Perfil de funcionário não encontrado"
|
||||
**Solução:** Execute o PASSO 1 novamente
|
||||
|
||||
### Problema: "Você ainda não tem direito a férias"
|
||||
**Solução:** Altere a data de admissão:
|
||||
```json
|
||||
// Via criarFuncionarioTeste:alterarDataAdmissao
|
||||
{
|
||||
"funcionarioId": "SEU_ID",
|
||||
"novaData": "2023-01-01"
|
||||
}
|
||||
```
|
||||
|
||||
### Problema: Toast não aparece
|
||||
**Solução:** Verifique se Sonner está configurado em `+layout.svelte`
|
||||
|
||||
### Problema: Calendário não carrega
|
||||
**Solução:**
|
||||
1. Verifique se FullCalendar foi instalado
|
||||
2. Execute: `cd apps/web && bun add @fullcalendar/core @fullcalendar/daygrid`
|
||||
|
||||
### Problema: Validação não funciona
|
||||
**Solução:**
|
||||
1. Verifique o regime de trabalho do funcionário
|
||||
2. Confirme que o backend `saldoFerias.ts` está deployado
|
||||
|
||||
---
|
||||
|
||||
## ✅ CHECKLIST DE TESTES
|
||||
|
||||
- [ ] Funcionário criado e associado
|
||||
- [ ] Dashboard carrega corretamente
|
||||
- [ ] Wizard abre ao clicar em "Solicitar Férias"
|
||||
- [ ] Seleção de ano funciona
|
||||
- [ ] Saldo é exibido corretamente
|
||||
- [ ] Calendário permite drag & drop
|
||||
- [ ] Validações CLT funcionam
|
||||
- [ ] Validações Servidor PE funcionam
|
||||
- [ ] Toast notifications aparecem
|
||||
- [ ] Solicitação é criada com sucesso
|
||||
- [ ] Dashboard atualiza após solicitação
|
||||
- [ ] Gráficos são renderizados
|
||||
- [ ] Aprovação de férias funciona (se gestor)
|
||||
|
||||
---
|
||||
|
||||
## 🎉 RESULTADO ESPERADO
|
||||
|
||||
Após completar todos os passos, você terá testado:
|
||||
|
||||
✅ **Backend:**
|
||||
- Criação de períodos aquisitivos
|
||||
- Validações CLT e Servidor PE
|
||||
- Reserva e liberação de dias
|
||||
- Cálculo de saldo
|
||||
|
||||
✅ **Frontend:**
|
||||
- Wizard de 3 passos
|
||||
- Calendário interativo
|
||||
- Dashboard com analytics
|
||||
- Toast notifications
|
||||
- Validações em tempo real
|
||||
|
||||
---
|
||||
|
||||
## 📞 PRECISA DE AJUDA?
|
||||
|
||||
Se encontrar algum erro:
|
||||
|
||||
1. **Verifique o console do navegador (F12)**
|
||||
- Logs de erro aparecem aqui
|
||||
|
||||
2. **Verifique o Convex Dashboard**
|
||||
- Logs do backend aparecem aqui
|
||||
|
||||
3. **Documentação completa:**
|
||||
- Veja `SISTEMA_FERIAS_MODERNO_COMPLETO.md`
|
||||
- Veja `REGRAS_FERIAS_CLT_E_SERVIDOR_PE.md`
|
||||
|
||||
---
|
||||
|
||||
**Boa sorte com os testes! 🚀**
|
||||
|
||||
|
||||
Reference in New Issue
Block a user