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
parent 21b41121db
commit fd445e8246
43 changed files with 6097 additions and 515 deletions
--- a/CRIAR_USUARIO_TESTE_FERIAS.md
+++ b/CRIAR_USUARIO_TESTE_FERIAS.md
@@ -0,0 +1,147 @@
+# 🧪 Guia: Criar Usuário de Teste para Férias
+
+## 📋 Credenciais de Teste
+
+```
+Login:    teste.ferias
+Senha:    Teste@2025
+Email:    teste.ferias@sgse.pe.gov.br
+Nome:     João Silva (Teste)
+```
+
+---
+
+## 🔧 Passo a Passo
+
+### **1. Criar um Símbolo (se não existir)**
+
+1. Acesse: `http://localhost:5173/recursos-humanos/simbolos`
+2. Clique em **"Novo Símbolo"**
+3. Preencha:
+   - **Cargo:** Analista Administrativo
+   - **Tipo:** Cargo Comissionado
+   - **Nível:** CC-3
+   - **Valor:** R$ 3.500,00
+4. Clique em **"Salvar"**
+
+---
+
+### **2. Criar Funcionário**
+
+1. Acesse: `http://localhost:5173/recursos-humanos/funcionarios/cadastro`
+2. Preencha os dados:
+
+#### **Dados Pessoais:**
+- **Nome Completo:** João Silva (Teste)
+- **CPF:** 111.222.333-44
+- **RG:** 1234567
+- **Data de Nascimento:** 15/05/1990
+
+#### **Contato:**
+- **Email:** teste.ferias@sgse.pe.gov.br
+- **Telefone:** (81) 98765-4321
+- **Endereço:** Rua de Teste, 123
+- **Bairro:** Centro
+- **Cidade:** Recife
+- **UF:** PE
+- **CEP:** 50000-000
+
+#### **Dados Funcionais:**
+- **Matrícula:** teste.ferias
+- **Data de Admissão:** 15/01/2023 ⚠️ **IMPORTANTE: Quase 2 anos atrás!**
+- **Símbolo:** Selecione o símbolo criado acima
+- **Regime de Trabalho:** CLT
+- **Cargo/Função:** Analista Administrativo
+- **Status de Férias:** Ativo
+
+#### **Filiação:**
+- **Nome do Pai:** José Silva
+- **Nome da Mãe:** Maria Silva
+
+#### **Outros:**
+- **Naturalidade:** Recife/PE
+- **Sexo:** Masculino
+- **Estado Civil:** Solteiro
+- **Nacionalidade:** Brasileira
+- **Grau de Instrução:** Superior
+
+3. Clique em **"Salvar"**
+
+---
+
+### **3. Criar Usuário e Associar**
+
+1. Acesse: `http://localhost:5173/ti/usuarios`
+2. Clique em **"Novo Usuário"**
+3. Preencha:
+   - **Matrícula:** teste.ferias
+   - **Nome:** João Silva (Teste)
+   - **Email:** teste.ferias@sgse.pe.gov.br
+   - **Perfil/Role:** Usuario (perfil básico)
+   - **Senha Inicial:** Teste@2025
+4. Clique em **"Criar"**
+
+5. **Associar Funcionário:**
+   - Na lista de usuários, localize "João Silva (Teste)"
+   - Clique no botão **"Associar/Alterar"** (ao lado de "Não associado")
+   - Selecione o funcionário "João Silva (Teste)" criado anteriormente
+   - Clique em **"Associar"**
+
+---
+
+## ✅ Testar o Sistema de Férias
+
+1. **Faça Logout** do usuário TI Master
+2. **Faça Login** com:
+   ```
+   Login: teste.ferias
+   Senha: Teste@2025
+   ```
+3. Acesse: `http://localhost:5173/perfil`
+4. Clique na aba **"Minhas Férias"**
+5. Clique em **"Solicitar Novas Férias"**
+
+---
+
+## 🎯 O Que Testar
+
+### **Saldo Esperado:**
+- **Ano 2024:** ~30 dias (ano completo)
+- **Ano 2025:** ~30 dias (proporcionais até dez/2025)
+
+### **Validações CLT:**
+- ✅ Máximo 3 períodos por ano
+- ✅ Mínimo 5 dias por período
+- ✅ Um período deve ter pelo menos 14 dias
+- ✅ Não pode usar mais dias que o saldo disponível
+
+### **Teste:**
+1. Selecione o ano (2024 ou 2025)
+2. Adicione períodos no calendário
+3. Verifique se as validações aparecem
+4. Envie a solicitação
+5. Como TI Master, aprove/reprove a solicitação
+
+---
+
+## 🔧 Dicas de Teste
+
+### **Testar Servidor Público PE:**
+Se quiser testar as regras de Servidor Público PE:
+1. Edite o funcionário
+2. Altere **"Regime de Trabalho"** para **"Servidor Público Estadual PE"**
+3. As regras mudam para:
+   - ✅ Máximo 2 períodos
+   - ✅ Mínimo 10 dias por período
+   - ✅ Não permite abono
+
+### **Testar Diferentes Anos de Admissão:**
+- Data mais antiga = mais períodos aquisitivos
+- Data recente = menos dias disponíveis
+
+---
+
+## 🎉 Pronto!
+
+Agora você pode testar todo o sistema de férias com um usuário real! 🚀
+