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:
2025-10-30 09:27:10 -03:00
parent 21b41121db
commit fd445e8246
43 changed files with 6097 additions and 515 deletions

110
GUIA_RAPIDO_EMAILS.md Normal file
View File

@@ -0,0 +1,110 @@
# 🚀 GUIA RÁPIDO: Enviar Emails e Notificações
## ⚡ 3 Passos para Começar
### 1⃣ **Configurar SMTP** (Fazer 1 vez)
1. Acesse: `http://localhost:5173/ti/configuracoes-email`
2. Preencha:
```
📧 Remetente: SGSE - Sistema de Gerenciamento
📧 Email: sgse@pe.gov.br (ou seu email)
🌐 Servidor: smtp.gmail.com
🔌 Porta: 587
🔐 Usuário: seu-email@gmail.com
🔑 Senha: sua-senha-de-app
🔒 TLS/SSL: Sim
```
3. Clique: **"Testar Conexão SMTP"**
4. Aguarde: ✅ "Conexão testada com sucesso!"
### 2⃣ **Enviar Notificação**
1. Acesse: `http://localhost:5173/ti/notificacoes`
2. Selecione:
- **Destinatário:** João Silva (ou qualquer usuário)
- **Canal:**
- 💬 Chat = Mensagem imediata
- 📧 Email = Envio em até 2 minutos
- 🔄 Ambos = Chat + Email
- **Mensagem:** Escolha template ou escreva
3. Clique: **"Enviar"**
### 3⃣ **Verificar Envio**
#### **Chat:**
- ✅ Imediato: Abra o chat e veja a mensagem
#### **Email:**
- ⏱️ Aguarde 2 minutos (processamento automático)
- 📋 Verifique logs no terminal do Convex:
```
✅ Email enviado com sucesso!
Para: destinatario@email.com
```
---
## 🔑 **IMPORTANTE: Senha de App do Gmail**
O Gmail **NÃO aceita** senha normal!
### **Como gerar:**
1. Acesse: https://myaccount.google.com/security
2. Ative: **"Verificação em duas etapas"**
3. Vá em: **"Senhas de app"**
4. Gere: Senha para "Email"
5. Use: Senha de 16 caracteres gerada
---
## ✅ **Canais Disponíveis**
| Canal | Velocidade | Ideal Para |
|-------|------------|------------|
| 💬 **Chat** | Imediato | Mensagens urgentes |
| 📧 **Email** | 2 minutos | Notificações formais |
| 🔄 **Ambos** | Variado | Comunicações importantes |
---
## 🧪 **Teste Rápido**
```
1. Configure SMTP (Gmail)
2. Envie notificação para você mesmo
3. Canal: Ambos
4. Verifique:
✅ Chat: Mensagem aparece imediatamente
✅ Email: Chega em até 2 minutos
```
---
## ❓ **Troubleshooting**
### **Email não chega?**
1. ✅ Configuração SMTP testada?
2. ✅ Senha de App (não senha normal)?
3. ✅ Aguardou 2 minutos?
4. ✅ Verifique spam/lixo eletrônico
### **Chat não funciona?**
1. ✅ Destinatário tem acesso ao chat?
2. ✅ Usuário está cadastrado?
### **Erro "Configuração não testada"?**
1. ✅ Clique em "Testar Conexão SMTP"
2. ✅ Aguarde mensagem de sucesso
3. ✅ Tente enviar novamente
---
## 📄 **Documentação Completa**
Veja: `CORRECOES_EMAILS_NOTIFICACOES_COMPLETO.md`
---
**✅ PRONTO PARA USO!** 🎉