Files

deyvisonwanderley fd445e8246 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

2025-10-30 09:27:10 -03:00

6.7 KiB

Raw Blame History

🧪 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)

Acesse o Convex Dashboard:
```
https://dashboard.convex.dev
```
Vá para a seção "Functions"
Encontre a função: criarFuncionarioTeste:criarFuncionarioParaTIMaster

Execute com estes argumentos:

{
  "usuarioEmail": "ti.master@sgse.pe.gov.br"
}

Você verá o resultado:

{
  "sucesso": true,
  "funcionarioId": "abc123..."
}

Opção B: Via Console do Browser

Abra o console do navegador (F12)

Cole e execute este código:

// 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

Recarregue a página do perfil
- Pressione F5 ou Ctrl+R
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

Click em "Solicitar Novas Férias"

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"

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"

PASSO 3 - Confirmação:

✅ Revise todos os períodos
✅ Adicione observação (opcional)
✅ Click em "Enviar Solicitação"

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:

// 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:

// 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:

Verifique se FullCalendar foi instalado
Execute: cd apps/web && bun add @fullcalendar/core @fullcalendar/daygrid

Problema: Validação não funciona