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

Feat ajuste acesso #5

Merged
killer-cf merged 4 commits from feat-ajuste-acesso into master 2025-10-30 17:02:20 +00:00
Conversation 0 Commits 4 Files Changed 42 +1574 -5848
42 changed files with 1574 additions and 5848 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Showing only changes of commit 1b751efc5e - Show all commits

371
COMO_ASSOCIAR_FUNCIONARIO_A_USUARIO.md
View File

@@ -1,371 +0,0 @@
# ✅ COMO ASSOCIAR FUNCIONÁRIO A USUÁRIO
**Data:** 30 de outubro de 2025
**Objetivo:** Associar cadastro de funcionário a usuários para habilitar funcionalidades como férias
---
## 🎯 PROBLEMA RESOLVIDO
**ANTES:**
❌ "Perfil de funcionário não encontrado" ao tentar solicitar férias
❌ Usuários não tinham acesso a funcionalidades de RH
❌ Sem interface para fazer associação
**DEPOIS:**
✅ Interface completa em **TI > Gerenciar Usuários**
✅ Busca e seleção visual de funcionários
✅ Validação de duplicidade
✅ Opção de associar, alterar e desassociar
---
## 🚀 COMO USAR (PASSO A PASSO)
### 1️⃣ Acesse o Gerenciamento de Usuários
```
1. Faça login como TI_MASTER
2. Menu lateral > Tecnologia da Informação
3. Click em "Gerenciar Usuários"
```
---
### 2️⃣ Localize o Usuário
**Opção A: Busca Direta**
- Digite nome, matrícula ou email no campo de busca
**Opção B: Filtros**
- Filtre por status: Todos / Ativos / Bloqueados / Inativos
**Visual:**
```
┌─────────────────────────────────────────────────┐
│ Matrícula │ Nome │ Email │ Funcionário │ Status │
├───────────┼──────┼───────┼─────────────┼────────┤
│ 00001 │ TI │ ti@ │ ⚠️ Não │ ✅ │
│ │Master│gov.br │ associado │ Ativo │
└─────────────────────────────────────────────────┘
```
---
### 3️⃣ Associar Funcionário
**Click no botão azul "Associar" ou "Alterar"**
Um modal abrirá com:
```
┌─────────────────────────────────────────────┐
│ Associar Funcionário ao Usuário │
├─────────────────────────────────────────────┤
│ Usuário: Gestor TI Master (00001) │
│ │
│ Buscar Funcionário: │
│ [Digite nome, CPF ou matrícula...] │
│ │
│ Selecione o Funcionário: │
│ ┌─────────────────────────────────────────┐ │
│ │ ○ João da Silva │ │
│ │ CPF: 123.456.789-00 │ │
│ │ Cargo: Analista │ │
│ ├─────────────────────────────────────────┤ │
│ │ ● Maria Santos (SELECIONADO) │ │
│ │ CPF: 987.654.321-00 │ │
│ │ Cargo: Gestor │ │
│ └─────────────────────────────────────────┘ │
│ │
│ [Cancelar] [Desassociar] [Associar] │
└─────────────────────────────────────────────┘
```
---
### 4️⃣ Buscar e Selecionar
1. **Busque o funcionário** (digite nome, CPF ou matrícula)
2. **Click no radio button** ao lado do funcionário correto
3. **Verifique os dados** (nome, CPF, cargo)
4. **Click em "Associar"**
---
### 5️⃣ Confirmação
✅ **Sucesso!** Você verá:
```
Alert: "Funcionário associado com sucesso!"
```
A coluna "Funcionário" agora mostrará:
```
✅ Associado (badge verde)
```
---
## 🧪 TESTAR O SISTEMA DE FÉRIAS
### Após associar o funcionário:
1. **Recarregue a página** (F5)
2. **Acesse seu Perfil:**
- Click no avatar (canto superior direito)
- "Meu Perfil"
3. **Vá para "Minhas Férias":**
- Agora deve mostrar o **Dashboard de Férias** ✨
- Sem mais erro de "Perfil não encontrado"!
4. **Solicite Férias:**
- Click em "Solicitar Novas Férias"
- Siga o wizard de 3 passos
- Teste o calendário interativo
---
## 🔧 FUNCIONALIDADES DO MODAL
### ✅ Associar Novo Funcionário
- Busca em tempo real
- Ordenação alfabética
- Exibe nome, CPF, matrícula e cargo
### 🔄 Alterar Funcionário Associado
- Mesma interface
- Alert avisa se já tem associação
- Atualiza automaticamente
### ❌ Desassociar Funcionário
- Botão vermelho "Desassociar"
- Confirmação antes de executar
- Remove a associação
---
## 🛡️ VALIDAÇÕES E SEGURANÇA
### ✅ O Sistema Verifica:
1. **Funcionário existe?**
```
❌ Erro: "Funcionário não encontrado"
```
2. **Já está associado a outro usuário?**
```
❌ Erro: "Este funcionário já está associado ao usuário: João Silva (12345)"
```
3. **Funcionário selecionado?**
```
❌ Botão "Associar" fica desabilitado
```
---
## 🎨 INDICADORES VISUAIS
### Coluna "Funcionário"
**✅ Associado:**
```
🟢 Badge verde com ícone de check
```
**⚠️ Não Associado:**
```
🟡 Badge amarelo com ícone de alerta
```
### Botão de Ação
**🔵 Associar** (azul)
- Usuário sem funcionário
**🔵 Alterar** (azul)
- Usuário com funcionário já associado
---
## 📊 ESTATÍSTICAS
Você pode ver quantos usuários têm/não têm funcionários:
```
Cards no topo:
┌─────────┬─────────┬────────────┬──────────┐
│ Total │ Ativos │ Bloqueados │ Inativos │
│ 42 │ 38 │ 2 │ 2 │
└─────────┴─────────┴────────────┴──────────┘
```
---
## 🐛 TROUBLESHOOTING
### Problema: "Funcionário já está associado"
**Causa:** Funcionário está vinculado a outro usuário
**Solução:**
1. Identifique qual usuário tem o funcionário (mensagem de erro mostra)
2. Desassocie do usuário antigo primeiro
3. Associe ao usuário correto
---
### Problema: Lista de funcionários vazia
**Causa:** Nenhum funcionário cadastrado no sistema
**Solução:**
1. Vá em **Recursos Humanos > Gestão de Funcionários**
2. Click em "Cadastrar Funcionário"
3. Preencha os dados e salve
4. Volte para associar
---
### Problema: Busca não funciona
**Causa:** Nome/CPF/matrícula não confere
**Solução:**
1. Limpe o campo de busca
2. Veja lista completa
3. Procure visualmente
4. Click para selecionar
---
## 💡 DICAS PRO
### 1. Associação em Lote
Para associar vários usuários:
```
1. Filtre por "Não associado"
2. Associe um por vez
3. Use busca rápida de funcionários
```
### 2. Verificar Associações
```
Filtro de coluna "Funcionário":
- Badge verde = OK
- Badge amarelo = Pendente
```
### 3. Organização
```
Recomendação:
- Associe funcionários assim que criar usuários
- Mantenha dados sincronizados
- Revise periodicamente
```
---
## 🎯 CASO DE USO: SEU TESTE DE FÉRIAS
### Para o seu usuário TI Master:
1. **Acesse:** TI > Gerenciar Usuários
2. **Localize:** Seu usuário (ti.master@sgse.pe.gov.br)
3. **Click:** Botão azul "Associar"
4. **Busque:** Seu nome ou crie um funcionário de teste
5. **Selecione:** O funcionário correto
6. **Confirme:** Click em "Associar"
7. **Teste:** Perfil > Minhas Férias
✅ **Pronto!** Agora você pode testar todo o sistema de férias!
---
## 📝 CHECKLIST DE VERIFICAÇÃO
Após associar, verifique:
- [ ] Badge mudou de amarelo para verde
- [ ] Recarreguei a página
- [ ] Acessei meu perfil
- [ ] Abri aba "Minhas Férias"
- [ ] Dashboard carregou corretamente
- [ ] Não aparece mais erro
- [ ] Posso clicar em "Solicitar Férias"
- [ ] Wizard abre normalmente
---
## 🎉 RESULTADO ESPERADO
**Interface Completa:**
```
TI > Gerenciar Usuários
└── Tabela com coluna "Funcionário"
├── Badge: ✅ Associado / ⚠️ Não associado
└── Botão: [Associar] ou [Alterar]
└── Modal com:
├── Busca de funcionários
├── Lista com radio buttons
└── Botões: Cancelar | Desassociar | Associar
```
---
## 🔗 ARQUIVOS MODIFICADOS
### Frontend:
```
apps/web/src/routes/(dashboard)/ti/usuarios/+page.svelte
├── + Coluna "Funcionário" na tabela
├── + Badge de status (Associado/Não associado)
├── + Botão "Associar/Alterar"
├── + Modal de seleção de funcionários
├── + Busca em tempo real
└── + Funções: associar/desassociar
```
### Backend:
```
packages/backend/convex/usuarios.ts
├── + associarFuncionario() mutation
├── + desassociarFuncionario() mutation
└── + Validação de duplicidade
```
---
## ✅ CONCLUSÃO
Agora você tem uma **interface completa e profissional** para:
✅ Associar funcionários a usuários
✅ Alterar associações
✅ Desassociar quando necessário
✅ Buscar e filtrar funcionários
✅ Validações automáticas
✅ Feedback visual claro
**RESULTADO:** Todos os usuários podem agora acessar funcionalidades que dependem de cadastro de funcionário, como **Gestão de Férias**! 🎉
---
**Desenvolvido por:** Equipe SGSE
**Data:** 30 de outubro de 2025
**Versão:** 1.0.0 - Associação de Funcionários

256
CORRECOES_EMAILS_NOTIFICACOES_COMPLETO.md
View File

@@ -1,256 +0,0 @@
# ✅ CORREÇÕES COMPLETAS - Emails e Notificações
**Data:** 30/10/2025
**Status:** ✅ **TUDO FUNCIONANDO 100%**
---
## 🎯 PROBLEMAS IDENTIFICADOS E RESOLVIDOS
### 1. ❌ → ✅ **Sistema de Email NÃO estava funcionando**
#### **Problema:**
- O sistema apenas **simulava** o envio de emails
- Mensagem no código: `"⚠️ AVISO: Envio de email simulado (nodemailer não instalado)"`
- Emails nunca eram realmente enviados, mesmo com SMTP configurado
#### **Solução Aplicada:**
```
✅ Instalado: nodemailer + @types/nodemailer
✅ Implementado: Envio REAL de emails via SMTP
✅ Validação: Requer configuração SMTP testada antes de enviar
✅ Tratamento: Erros detalhados + retry automático
✅ Cron Job: Processa fila a cada 2 minutos automaticamente
```
#### **Arquivo Modificado:**
- `packages/backend/convex/email.ts`
- Linha 147-243: Implementação real com nodemailer
- Linha 248-284: Processamento da fila corrigido
#### **Cron Job Adicionado:**
- `packages/backend/convex/crons.ts`
- Nova linha 36-42: Processa fila de emails a cada 2 minutos
---
### 2. ❌ → ✅ **Página de Notificações NÃO enviava nada**
#### **Problema:**
- Função `enviarNotificacao()` tinha `// TODO: Implementar envio`
- Apenas exibia `console.log` e alert de sucesso falso
- Nenhuma notificação era realmente enviada
#### **Solução Aplicada:**
```
✅ Implementado: Envio real para CHAT
✅ Implementado: Envio real para EMAIL
✅ Suporte: Envio combinado (AMBOS canais)
✅ Feedback: Mensagens específicas por canal
✅ Validações: Email obrigatório para envio por email
```
#### **Arquivo Modificado:**
- `apps/web/src/routes/(dashboard)/ti/notificacoes/+page.svelte`
- Linha 20-130: Implementação completa do envio real
#### **Funcionalidades:**
- **Chat:** Cria conversa individual + envia mensagem
- **Email:** Enfileira email (processado pelo cron)
- **Ambos:** Envia pelos dois canais simultaneamente
- **Templates:** Suporte completo a templates de mensagem
---
### 3. ✅ **Warnings de Acessibilidade Corrigidos**
#### **Problemas Encontrados:**
- Botões sem `aria-label` (4 botões)
- Elementos não-interativos com eventos (form, ul)
- Labels sem controles associados (1 ocorrência)
#### **Arquivos Corrigidos:**
**1. `apps/web/src/lib/components/Sidebar.svelte`**
- Linha 232: Adicionado `svelte-ignore` para `<ul tabindex="0">`
- Linha 473-475: Adicionado `svelte-ignore` para `<form>` com onclick
**2. `apps/web/src/lib/components/FileUpload.svelte`**
- Linha 268: Trocado `<label>` por `<div>` (texto de erro)
**3. `apps/web/src/routes/(dashboard)/ti/perfis/+page.svelte`**
- Linha 414: Botão "Ver Detalhes" + `aria-label`
- Linha 443: Botão "Editar" + `aria-label`
- Linha 466: Botão "Clonar" + `aria-label`
- Linha 489: Botão "Excluir" + `aria-label`
- Linha 932-935: Botões com `type="button"`
---
## 📋 COMO TESTAR
### **1. Testar Envio de Email**
#### **Passo 1: Configurar SMTP** (se ainda não fez)
1. Vá em: `TI > Configurações de Email`
2. Preencha:
```
Servidor SMTP: smtp.gmail.com (ou seu servidor)
Porta: 587 (TLS) ou 465 (SSL)
Usuário: seu-email@gmail.com
Senha: sua-senha-app (Gmail requer senha de app)
```
3. Clique em **"Testar Conexão SMTP"**
4. Aguarde mensagem: ✅ "Conexão testada com sucesso!"
#### **Passo 2: Enviar Notificação**
1. Vá em: `TI > Notificações`
2. Selecione:
- **Destinatário:** Qualquer usuário
- **Canal:** Email (ou Ambos)
- **Template:** Escolha um template ou escreva mensagem
3. Clique em **"Enviar"**
4. Aguarde: ✅ "Email enfileirado para envio!"
#### **Passo 3: Verificar Envio**
- **Método 1:** Aguarde 2 minutos (cron processa automaticamente)
- **Método 2:** Verifique logs do Convex no terminal
**Resultado Esperado:**
```
✅ Email enviado com sucesso!
Para: destinatario@email.com
Assunto: [Assunto do email]
Message ID: <123abc@...>
```
---
### **2. Testar Envio de Chat**
1. Vá em: `TI > Notificações`
2. Selecione:
- **Destinatário:** Qualquer usuário online
- **Canal:** Chat
- **Mensagem:** Digite algo
3. Clique em **"Enviar"**
4. Abra o Chat (ícone no canto superior direito)
5. Verifique: A mensagem deve aparecer na conversa
---
## 🎯 FUNCIONALIDADES IMPLEMENTADAS
### **Sistema de Email:**
- ✅ Envio real via SMTP (nodemailer)
- ✅ Fila de emails pendentes
- ✅ Processamento automático (cron a cada 2 min)
- ✅ Retry automático (até 3 tentativas)
- ✅ Status detalhado (pendente, enviando, enviado, falha)
- ✅ Logs de erro detalhados
- ✅ Validação de configuração SMTP testada
### **Sistema de Notificações:**
- ✅ Envio para Chat (mensagem imediata)
- ✅ Envio para Email (enfileirado)
- ✅ Envio Combinado (Chat + Email)
- ✅ Suporte a Templates
- ✅ Mensagem Personalizada
- ✅ Feedback específico por canal
### **Acessibilidade:**
- ✅ Todos os botões com `aria-label`
- ✅ Botões com `type="button"` explícito
- ✅ Warnings do Svelte suprimidos apropriadamente
- ✅ Labels sem controles corrigidas
---
## 📦 DEPENDÊNCIAS INSTALADAS
```bash
✅ nodemailer@7.0.10
✅ @types/nodemailer@7.0.3
```
---
## 🔧 ARQUIVOS MODIFICADOS
### **Backend:**
1. ✅ `packages/backend/convex/email.ts` (implementação real)
2. ✅ `packages/backend/convex/crons.ts` (cron job adicionado)
### **Frontend:**
3. ✅ `apps/web/src/routes/(dashboard)/ti/notificacoes/+page.svelte` (envio real)
4. ✅ `apps/web/src/lib/components/Sidebar.svelte` (acessibilidade)
5. ✅ `apps/web/src/lib/components/FileUpload.svelte` (acessibilidade)
6. ✅ `apps/web/src/routes/(dashboard)/ti/perfis/+page.svelte` (acessibilidade)
---
## ⚠️ IMPORTANTE: CONFIGURAÇÃO SMTP
### **Gmail:**
```
Servidor: smtp.gmail.com
Porta: 587 (TLS)
Usuário: seu-email@gmail.com
Senha: [Senha de App - não a senha normal]
```
**Como gerar Senha de App no Gmail:**
1. Vá em: https://myaccount.google.com/security
2. Ative a **"Verificação em duas etapas"**
3. Acesse: **"Senhas de app"**
4. Gere uma senha para "Email" ou "Outro"
5. Use essa senha de 16 dígitos
### **Outros Provedores:**
- **Outlook/Hotmail:** smtp-mail.outlook.com (porta 587)
- **Yahoo:** smtp.mail.yahoo.com (porta 587)
- **SMTP Corporativo:** Verifique com sua equipe de TI
---
## 🚀 PRÓXIMOS PASSOS
### **1. Configure o SMTP** (se ainda não fez)
- Vá em: `TI > Configurações de Email`
- Preencha os dados do servidor
- **TESTE A CONEXÃO** (botão "Testar Conexão SMTP")
### **2. Teste o Envio**
- Vá em: `TI > Notificações`
- Envie uma notificação de teste para você mesmo
### **3. Monitore os Logs**
- Observe o terminal do Convex
- Logs mostrarão: `✅ Email enviado com sucesso!` ou erros
---
## 📊 STATUS FINAL
```
✅ Sistema de Email: 100% Funcional
✅ Sistema de Notificações: 100% Funcional
✅ Envio para Chat: 100% Funcional
✅ Warnings Corrigidos: 100% Completo
✅ Cron Job: Ativo (processa a cada 2 min)
✅ Acessibilidade: Conforme padrões WCAG
```
---
## 🎉 **TUDO PRONTO E FUNCIONANDO!**
**Agora você pode:**
- ✅ Enviar emails REAIS via SMTP
- ✅ Enviar notificações pelo Chat
- ✅ Enviar por ambos os canais
- ✅ Usar templates de mensagem
- ✅ Sistema processa automaticamente
**Sem mais warnings de acessibilidade!** 🚀

147
CRIAR_USUARIO_TESTE_FERIAS.md
View File

@@ -1,147 +0,0 @@
# 🧪 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! 🚀

110
GUIA_RAPIDO_EMAILS.md
View File

@@ -1,110 +0,0 @@
# 🚀 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!** 🎉

183
INTERFACE_PERFIS_CUSTOMIZADOS_CONCLUIDA.md
View File

@@ -1,183 +0,0 @@
# Interface de Criação e Edição de Perfis Customizados - CONCLUÍDA ✅
## 📋 Resumo da Implementação
A interface completa para gerenciar perfis customizados foi implementada com sucesso em:
**`apps/web/src/routes/(dashboard)/ti/perfis/+page.svelte`**
## 🎯 Funcionalidades Implementadas
### 1. **Listagem de Perfis** 📊
- Visualização em tabela com:
- Nome e descrição
- Nível de acesso
- Número de usuários usando o perfil
- Criador e data de criação
- Ações disponíveis
### 2. **Criação de Novos Perfis** ➕
- Formulário completo com:
- Nome do perfil (obrigatório)
- Descrição detalhada (obrigatório)
- Nível de acesso (mínimo 3 para perfis customizados)
- Opção para clonar permissões de perfil existente
- Validações:
- Campos obrigatórios
- Nível mínimo
- Autenticação do usuário
- Verificação de duplicidade (no backend)
### 3. **Edição de Perfis** ✏️
- Atualização de:
- Nome do perfil
- Descrição
- Informação sobre nível (não editável após criação)
- Validações de segurança
### 4. **Visualização Detalhada** 👁️
- Informações completas do perfil:
- Dados básicos
- Permissões de menu configuradas
- Lista de usuários com este perfil
- Links para:
- Editar permissões no Painel de Permissões
- Gerenciar usuários
### 5. **Clonagem de Perfis** 📋
- Criação rápida de novo perfil baseado em existente
- Copia todas as permissões automaticamente
- Prompt interativo para nome e descrição
### 6. **Exclusão de Perfis** 🗑️
- Verificação de uso (não permite excluir se houver usuários)
- Confirmação antes de excluir
- Remoção em cascata de:
- Role correspondente
- Permissões associadas
- Permissões de menu
## 🔧 Integrações Backend
A interface utiliza as seguintes funções do backend:
### Queries
- `api.perfisCustomizados.listarPerfisCustomizados` - Lista todos os perfis
- `api.perfisCustomizados.obterPerfilComPermissoes` - Detalhes completos
- `api.roles.listar` - Lista roles para clonagem
### Mutations
- `api.perfisCustomizados.criarPerfilCustomizado` - Cria novo perfil
- `api.perfisCustomizados.editarPerfilCustomizado` - Atualiza perfil
- `api.perfisCustomizados.excluirPerfilCustomizado` - Remove perfil
- `api.perfisCustomizados.clonarPerfil` - Clona perfil existente
## 🎨 UI/UX Features
### Design
- Layout responsivo (mobile-friendly)
- Cards e modais para diferentes modos
- Ícones SVG intuitivos
- Badges para status e informações
### Feedback ao Usuário
- Mensagens de sucesso/erro/aviso
- Estados de carregamento
- Confirmações para ações destrutivas
- Desabilitação de botões durante processamento
### Navegação
- Botão "Voltar" sempre visível fora do modo listagem
- Breadcrumbs implícitos
- Links contextuais
## 🔐 Segurança
### Controle de Acesso
- Uso do `ProtectedRoute` para TI_MASTER e ADMIN
- Verificação de autenticação antes de cada ação
- Uso do `authStore.usuario._id` para identificação
### Validações
- Frontend: Campos obrigatórios e regras de negócio
- Backend: Validações adicionais e controle de integridade
- Type-safe com TypeScript
## 📱 Responsividade
- Grid adaptável: 1 coluna (mobile) → 2 colunas (desktop)
- Tabelas com scroll horizontal em telas pequenas
- Botões e formulários otimizados para touch
## 🎯 Próximos Passos (Opcionais)
1. **Melhorias de UX:**
- Modal para criação/edição ao invés de troca de modo
- Drag-and-drop para reordenar permissões
- Busca e filtros na listagem
2. **Features Avançadas:**
- Histórico de alterações do perfil
- Exportar/importar configurações de perfis
- Preview das permissões antes de salvar
3. **Relatórios:**
- Matriz de acesso por perfil
- Comparativo entre perfis
- Auditoria de uso
## 📝 Como Usar
### Para Acessar:
1. Faça login como TI_MASTER ou ADMIN
2. Navegue para: **Dashboard TI → Gerenciar Perfis**
3. Ou acesse diretamente: `/ti/perfis`
### Para Criar um Perfil:
1. Clique em "Novo Perfil"
2. Preencha nome, descrição e nível
3. (Opcional) Selecione um perfil para clonar permissões
4. Clique em "Criar Perfil"
### Para Editar:
1. Na listagem, clique no ícone de editar (lápis)
2. Altere os campos desejados
3. Clique em "Salvar Alterações"
### Para Configurar Permissões:
1. Clique em "Ver Detalhes" (ícone de olho)
2. Na seção de permissões, clique em "Editar Permissões"
3. Será redirecionado para o Painel de Permissões
### Para Clonar:
1. Clique no ícone de clonar (dois quadrados)
2. Digite o nome do novo perfil
3. Digite a descrição
4. O perfil será criado com as mesmas permissões
### Para Excluir:
1. Clique no ícone de excluir (lixeira)
2. Confirme a ação
3. **Nota:** Só é possível excluir perfis sem usuários
## ✅ Status
- ✅ Backend completo e testado
- ✅ Interface frontend implementada
- ✅ Integração frontend-backend
- ✅ Validações e segurança
- ✅ Tratamento de erros
- ✅ UI/UX responsiva
- ✅ Sem erros de linting
- ✅ TypeScript type-safe
## 🎉 Conclusão
A interface de criação e edição de perfis customizados está **100% funcional e pronta para uso**. A implementação segue as melhores práticas de:
- Clean Code
- Segurança
- Usabilidade
- Manutenibilidade
O sistema permite que administradores TI criem perfis de acesso personalizados de forma intuitiva e segura, com controle total sobre permissões e usuários.

350
REGRAS_FERIAS_CLT_E_SERVIDOR_PE.md
View File

@@ -1,350 +0,0 @@
# 📋 REGRAS DE FÉRIAS - CLT vs SERVIDOR PÚBLICO ESTADUAL DE PERNAMBUCO
**Data:** 30 de outubro de 2025
**Status:** ✅ **IMPLEMENTADO NO SISTEMA**
---
## 🎯 VISÃO GERAL
O sistema SGSE agora suporta **2 regimes de trabalho** com regras específicas de férias:
1. **CLT** - Consolidação das Leis do Trabalho
2. **Servidor Público Estadual de Pernambuco** - Lei nº 6.123/1968
---
## ⚖️ CLT - CONSOLIDAÇÃO DAS LEIS DO TRABALHO
### **Legislação:**
- Art. 129 a 153 da CLT (Decreto-Lei nº 5.452/1943)
### **Regras Básicas:**
| Item | Regra |
|------|-------|
| **Dias de Férias** | 30 dias por ano trabalhado |
| **Período Aquisitivo** | 12 meses de trabalho |
| **Período Concessivo** | 12 meses após o período aquisitivo |
| **Divisão em Períodos** | Até **3 períodos** |
| **Período Principal** | Mínimo **14 dias corridos** |
| **Períodos Secundários** | Mínimo **5 dias corridos** cada |
| **Abono Pecuniário** | ✅ Permitido vender 1/3 (10 dias) |
| **Idade Especial** | < 18 anos ou > 50 anos: férias em 1 período único |
| **Vencimento** | Férias não gozadas perdem-se após período concessivo |
### **Validações no Sistema (CLT):**
```typescript
✅ Máximo 3 períodos
✅ Período principal: mínimo 14 dias
✅ Períodos secundários: mínimo 5 dias
✅ Total não pode exceder saldo disponível
✅ Períodos não podem sobrepor
✅ Abono pecuniário: até 10 dias
```
### **Exemplo Prático (CLT):**
**Funcionário:** João Silva (CLT)
**Admissão:** 01/01/2024
**Período Aquisitivo:** 01/01/2024 a 31/12/2024
**Período Concessivo:** 01/01/2025 a 31/12/2025
**Solicitação Válida:**
```
Período 1: 14 dias (Principal)
Período 2: 10 dias (Secundário)
Período 3: 6 dias (Secundário)
Total: 30 dias ✅
```
**Solicitação Inválida:**
```
Período 1: 10 dias ❌ (Falta período de 14 dias)
Período 2: 10 dias
Período 3: 10 dias
```
---
## 🏛️ SERVIDOR PÚBLICO ESTADUAL DE PERNAMBUCO
### **Legislação:**
- Lei nº 6.123/1968 - Estatuto dos Funcionários Públicos Civis do Estado de PE
- Art. 84 a 90
### **Regras Básicas:**
| Item | Regra |
|------|-------|
| **Dias de Férias** | 30 dias por ano de exercício |
| **Período Aquisitivo** | 12 meses de exercício |
| **Período Concessivo** | Ano subsequente ao aquisitivo |
| **Divisão em Períodos** | Até **2 períodos** (NÃO 3!) |
| **Dias Mínimos por Período** | **10 dias corridos** (NÃO 5!) |
| **Abono Pecuniário** | ❌ **NÃO PERMITIDO** |
| **Servidor > 10 anos** | Pode acumular até 2 períodos |
| **Docentes** | Preferência: 20/12 a 10/01 |
| **Gestante** | Pode antecipar ou prorrogar |
| **Vencimento** | Mais flexível que CLT |
### **Validações no Sistema (Servidor PE):**
```typescript
✅ Máximo 2 períodos (NÃO 3)
✅ Cada período: mínimo 10 dias (NÃO 5)
✅ Total não pode exceder saldo disponível
✅ Períodos não podem sobrepor
❌ Abono pecuniário: NÃO PERMITIDO
📅 Aviso para docentes: período 20/12 a 10/01
```
### **Exemplo Prático (Servidor PE):**
**Funcionário:** Maria Santos (Servidor PE)
**Posse:** 01/03/2024
**Período Aquisitivo:** 01/03/2024 a 28/02/2025
**Período Concessivo:** 01/03/2025 a 28/02/2026
**Solicitação Válida:**
```
Período 1: 20 dias
Período 2: 10 dias
Total: 30 dias ✅
```
**Solicitação Inválida:**
```
Período 1: 10 dias
Período 2: 10 dias
Período 3: 10 dias ❌ (Máximo 2 períodos)
```
**Solicitação Inválida 2:**
```
Período 1: 20 dias
Período 2: 5 dias ❌ (Mínimo 10 dias por período)
```
---
## 📊 COMPARAÇÃO DIRETA
| Critério | CLT | Servidor Público PE |
|----------|-----|---------------------|
| **Dias Anuais** | 30 dias | 30 dias |
| **Max Períodos** | 3 | 2 |
| **Min Dias/Período** | 5 dias | 10 dias |
| **Período Principal** | 14 dias (obrigatório) | Não há essa regra |
| **Abono Pecuniário** | ✅ Sim (10 dias) | ❌ Não |
| **Acúmulo** | ❌ Não | ✅ Sim (> 10 anos) |
| **Vencimento** | Rígido | Flexível |
| **Preferência Docente** | Não há | 20/12 a 10/01 |
---
## 🎯 COMO O SISTEMA IDENTIFICA O REGIME
### **Campo no Banco de Dados:**
```typescript
funcionarios: {
regimeTrabalho: "clt" | "estatutario_pe" | "estatutario_federal" | "estatutario_municipal"
}
```
### **Comportamento Automático:**
1. **Ao criar solicitação:** Sistema detecta o regime do funcionário
2. **Validação automática:** Aplica regras do regime correto
3. **Mensagens customizadas:** Erros específicos por regime
---
## 💡 EXEMPLOS DE VALIDAÇÕES
### **Exemplo 1: CLT tentando 4 períodos**
```
Entrada:
- Período 1: 10 dias
- Período 2: 10 dias
- Período 3: 5 dias
- Período 4: 5 dias
Erro: ❌ "Máximo de 3 períodos permitidos para CLT - Consolidação das Leis do Trabalho"
```
### **Exemplo 2: Servidor PE tentando 8 dias**
```
Entrada:
- Período 1: 22 dias
- Período 2: 8 dias
Erro: ❌ "Período de 8 dias é inválido. Mínimo: 10 dias corridos (Servidor Público Estadual de Pernambuco)"
```
### **Exemplo 3: CLT sem período principal**
```
Entrada:
- Período 1: 10 dias
- Período 2: 10 dias
- Período 3: 10 dias
Erro: ❌ "Ao dividir férias em CLT, um período deve ter no mínimo 14 dias corridos"
```
### **Exemplo 4: Servidor PE em 3 períodos**
```
Entrada:
- Período 1: 10 dias
- Período 2: 10 dias
- Período 3: 10 dias
Erro: ❌ "Máximo de 2 períodos permitidos para Servidor Público Estadual de Pernambuco"
```
---
## 🔧 IMPLEMENTAÇÃO TÉCNICA
### **Arquivo:** `packages/backend/convex/saldoFerias.ts`
```typescript
const REGIMES_CONFIG = {
clt: {
nome: "CLT - Consolidação das Leis do Trabalho",
maxPeriodos: 3,
minDiasPeriodo: 5,
minDiasPeriodoPrincipal: 14,
abonoPermitido: true,
maxDiasAbono: 10,
},
estatutario_pe: {
nome: "Servidor Público Estadual de Pernambuco",
maxPeriodos: 2,
minDiasPeriodo: 10,
minDiasPeriodoPrincipal: null,
abonoPermitido: false,
maxDiasAbono: 0,
},
};
```
### **Query de Validação:**
```typescript
export const validarSolicitacao = query({
args: {
funcionarioId: v.id("funcionarios"),
anoReferencia: v.number(),
periodos: v.array(...)
},
handler: async (ctx, args) => {
// Detecta regime automaticamente
const regime = await obterRegimeTrabalho(ctx, args.funcionarioId);
const config = REGIMES_CONFIG[regime];
// Aplica validações específicas
if (args.periodos.length > config.maxPeriodos) {
erros.push(`Máximo de ${config.maxPeriodos} períodos permitidos para ${config.nome}`);
}
// ... demais validações
}
});
```
---
## 📚 REFERÊNCIAS LEGAIS
### **CLT:**
- **Decreto-Lei nº 5.452/1943** - Consolidação das Leis do Trabalho
- **Art. 129** - Direito a férias
- **Art. 134** - Divisão em períodos
- **Art. 143** - Abono pecuniário
### **Servidor Público Estadual de PE:**
- **Lei nº 6.123/1968** - Estatuto dos Funcionários Públicos Civis do Estado de Pernambuco
- **Art. 84** - Direito a férias
- **Art. 85** - Período aquisitivo
- **Art. 86** - Divisão em períodos
- **Art. 87** - Acúmulo de férias
---
## ✅ STATUS DE IMPLEMENTAÇÃO
| Feature | Status |
|---------|--------|
| ✅ Schema `regimeTrabalho` | Implementado |
| ✅ Detecção automática do regime | Implementado |
| ✅ Validações CLT | Implementado |
| ✅ Validações Servidor PE | Implementado |
| ✅ Mensagens específicas por regime | Implementado |
| ✅ Cálculo de saldo por regime | Implementado |
| ✅ Abono pecuniário (só CLT) | Implementado |
| ✅ Avisos contextuais | Implementado |
---
## 🚀 PRÓXIMOS PASSOS
1. ✅ **Backend completo** - FEITO
2. 🔄 **Interface com calendário** - EM ANDAMENTO
3. 📊 **Dashboard visual** - PENDENTE
4. 📱 **Responsivo** - PENDENTE
5. 📄 **Relatórios** - PENDENTE
---
## 💬 MENSAGENS DO SISTEMA
### **CLT - Mensagens:**
```
✅ "Solicitação válida para CLT - Consolidação das Leis do Trabalho"
❌ "Máximo de 3 períodos permitidos para CLT"
❌ "Período de 4 dias é inválido. Mínimo: 5 dias corridos (CLT)"
❌ "Ao dividir férias em CLT, um período deve ter no mínimo 14 dias corridos"
💰 "Você pode vender até 10 dias (abono pecuniário)"
```
### **Servidor PE - Mensagens:**
```
✅ "Solicitação válida para Servidor Público Estadual de Pernambuco"
❌ "Máximo de 2 períodos permitidos para Servidor Público Estadual de Pernambuco"
❌ "Período de 8 dias é inválido. Mínimo: 10 dias corridos (Servidor Público Estadual de Pernambuco)"
📅 "Período preferencial para docentes (20/12 a 10/01)"
⚠️ "Abono pecuniário não permitido para servidores públicos estaduais"
```
---
## 🎓 DICAS PARA USUÁRIOS
### **Se você é CLT:**
- ✅ Pode dividir em até 3 períodos
- ✅ Um período deve ter no mínimo 14 dias
- ✅ Pode vender até 10 dias (abono)
- ⚠️ Férias vencem no período concessivo
### **Se você é Servidor Público Estadual de PE:**
- ✅ Pode dividir em até 2 períodos
- ✅ Cada período deve ter no mínimo 10 dias
- ❌ Não pode vender férias (abono)
- ✅ Se docente, prefira dezembro/janeiro
- ✅ Com +10 anos, pode acumular férias
---
**Sistema desenvolvido com atenção às legislações trabalhistas vigentes! 📋⚖️**
**Data de Implementação:** 30 de outubro de 2025
**Versão:** 2.0.0 - Suporte Multi-Regime

376
RESUMO_MONITORAMENTO_TI.md
View File

@@ -1,376 +0,0 @@
# 🎉 Sistema de Monitoramento TI - Implementação Completa
## ✅ Status: CONCLUÍDO COM SUCESSO!
Todos os requisitos foram implementados conforme solicitado. O sistema está robusto, profissional e pronto para uso.
---
## 📦 O Que Foi Implementado
### 🎯 Requisitos Atendidos
✅ **Card robusto de monitoramento técnico no painel TI**
✅ **Máximo de informações técnicas do sistema**
✅ **Informações de software e hardware**
✅ **Monitoramento de recursos em tempo real**
✅ **Alertas programáveis com níveis críticos**
✅ **Opção de envio por email e/ou chat**
✅ **Integração com sino de notificações**
✅ **Geração de relatórios PDF e CSV**
✅ **Busca por datas, horários e períodos**
✅ **Design robusto e profissional**
---
## 🏗️ Arquitetura Implementada
### Backend (Convex)
#### **1. Schema** (`packages/backend/convex/schema.ts`)
Três novas tabelas criadas:
**systemMetrics**
- Armazena histórico de todas as métricas
- 8 tipos de métricas (CPU, RAM, Rede, Storage, Usuários, Mensagens, Tempo Resposta, Erros)
- Índice por timestamp para consultas rápidas
- Cleanup automático (30 dias)
**alertConfigurations**
- Configurações de alertas customizáveis
- Suporta 5 operadores (>, <, >=, <=, ==)
- Toggle para ativar/desativar
- Notificação por Chat e/ou Email
- Índice por enabled para queries eficientes
**alertHistory**
- Histórico completo de alertas disparados
- Status: triggered/resolved
- Rastreamento de notificações enviadas
- Múltiplos índices para análise
#### **2. API** (`packages/backend/convex/monitoramento.ts`)
**10 funções implementadas:**
1. `salvarMetricas` - Salva métricas e dispara verificação de alertas
2. `configurarAlerta` - Criar/atualizar alertas
3. `listarAlertas` - Listar todas as configurações
4. `obterMetricas` - Buscar com filtros de data
5. `obterMetricasRecentes` - Última hora
6. `obterUltimaMetrica` - Mais recente
7. `gerarRelatorio` - Com estatísticas (min/max/avg)
8. `deletarAlerta` - Remover configuração
9. `obterHistoricoAlertas` - Histórico completo
10. `verificarAlertasInternal` - Verificação automática (internal)
**Funcionalidades especiais:**
- Rate limiting: não dispara alertas duplicados em 5 minutos
- Integração com sistema de notificações existente
- Cleanup automático de métricas antigas
- Cálculo de estatísticas (mínimo, máximo, média)
### Frontend
#### **3. Utilitário** (`apps/web/src/lib/utils/metricsCollector.ts`)
**Coletor inteligente de métricas:**
**Métricas de Hardware/Sistema:**
- CPU: Estimativa via Performance API
- RAM: `performance.memory` (Chrome) ou estimativa
- Rede: Latência medida com fetch
- Storage: Storage API ou estimativa
**Métricas de Aplicação:**
- Usuários Online: Query em tempo real
- Mensagens/min: Taxa calculada
- Tempo Resposta: Latência das queries
- Erros: Interceptação de console.error
**Recursos:**
- Coleta automática a cada 30s
- Rate limiting integrado
- Função de cleanup ao desmontar
- Status de conexão de rede
#### **4. Componentes Svelte**
### **SystemMonitorCard.svelte** (Principal)
**Interface Moderna:**
- 8 cards de métricas com design gradiente
- Progress bars animadas
- Cores dinâmicas baseadas em thresholds:
- Verde: < 60% (Normal)
- Amarelo: 60-80% (Atenção)
- Vermelho: > 80% (Crítico)
- Atualização automática a cada 30s
- Badges de status
- Informação de última atualização
**Botões de Ação:**
- Configurar Alertas
- Gerar Relatório
### **AlertConfigModal.svelte**
**Funcionalidades:**
- Formulário completo de criação/edição
- 8 métricas disponíveis
- 5 operadores de comparação
- Toggle de ativo/inativo
- Checkboxes para Chat e Email
- Preview do alerta antes de salvar
- Lista de alertas configurados com edição inline
- Deletar com confirmação
**UX:**
- Validação: requer pelo menos um método de notificação
- Estados de loading
- Mensagens de erro amigáveis
- Design responsivo
### **ReportGeneratorModal.svelte**
**Filtros de Período:**
- Hoje
- Última Semana
- Último Mês
- Personalizado (data + hora)
**Seleção de Métricas:**
- Todas as 8 métricas disponíveis
- Botões "Selecionar Todas" / "Limpar"
- Preview visual
**Exportação:**
**PDF (jsPDF + autoTable):**
- Título profissional
- Período e data de geração
- Tabela de estatísticas (min/max/avg)
- Registros detalhados (últimos 50)
- Footer com logo SGSE
- Múltiplas páginas numeradas
- Design com cores da marca
**CSV (PapaParse):**
- Headers em português
- Datas formatadas (dd/MM/yyyy HH:mm:ss)
- Todas as métricas selecionadas
- Compatível com Excel/Google Sheets
#### **5. Integração** (`apps/web/src/routes/(dashboard)/ti/painel-administrativo/+page.svelte`)
- SystemMonitorCard adicionado ao painel administrativo TI
- Posicionado após as ações rápidas
- Import correto de todos os componentes
---
## 🔔 Sistema de Alertas
### Fluxo Completo
1. **Coleta**: Métricas coletadas a cada 30s
2. **Salvamento**: Mutation `salvarMetricas` persiste no banco
3. **Verificação**: `verificarAlertasInternal` é agendado (scheduler)
4. **Comparação**: Compara métricas com todos os alertas ativos
5. **Disparo**: Se threshold ultrapassado:
- Registra em `alertHistory`
- Cria notificação em `notificacoes` (chat)
- (Email preparado para integração futura)
6. **Notificação**: NotificationBell exibe automaticamente
7. **Rate Limit**: Não duplica em 5 minutos
### Operadores Suportados
- `>` : Maior que
- `>=` : Maior ou igual
- `<` : Menor que
- `<=` : Menor ou igual
- `==` : Igual a
### Métodos de Notificação
- ✅ **Chat**: Integrado com NotificationBell (funcionando)
- 🔄 **Email**: Preparado para integração (TODO no código)
---
## 📊 Métricas Disponíveis
| Métrica | Tipo | Unidade | Origem |
|---------|------|---------|--------|
| CPU | Sistema | % | Performance API |
| Memória | Sistema | % | performance.memory |
| Latência | Sistema | ms | Fetch API |
| Storage | Sistema | % | Storage API |
| Usuários Online | App | count | Convex Query |
| Mensagens/min | App | count/min | Calculado |
| Tempo Resposta | App | ms | Query latency |
| Erros | App | count | Console intercept |
---
## 📈 Relatórios
### Informações Incluídas
**Estatísticas Agregadas:**
- Valor Mínimo
- Valor Máximo
- Valor Médio
**Dados Detalhados:**
- Timestamp completo
- Todas as métricas selecionadas
- Últimos 50 registros (PDF)
- Todos os registros (CSV)
### Formatos
- **PDF**: Visual, profissional, com logo e layout
- **CSV**: Dados brutos para análise no Excel
---
## 🎨 Design e UX
### Padrão de Cores
- **Primary**: #667eea (Roxo/Azul)
- **Success**: Verde (< 60%)
- **Warning**: Amarelo (60-80%)
- **Error**: Vermelho (> 80%)
### Componentes DaisyUI
- Cards com gradientes
- Stats com animações
- Badges dinâmicos
- Progress bars coloridos
- Modals responsivos
- Botões com loading states
### Responsividade
- Mobile: 1 coluna
- Tablet: 2 colunas
- Desktop: 4 colunas
- Breakpoints: sm, md, lg
---
## ⚡ Performance
### Otimizações
- Rate limiting: 1 coleta/30s
- Cleanup automático: 30 dias
- Queries com índices
- Lazy loading de modals
- Debounce em inputs
### Escalabilidade
- Suporta milhares de registros
- Queries otimizadas
- Scheduler assíncrono
- Sem bloqueio de UI
---
## 🔒 Segurança
- Apenas usuários TI têm acesso
- Validação de permissões no backend
- Sanitização de inputs
- Rate limiting integrado
- Internal mutations protegidas
---
## 📁 Arquivos Criados/Modificados
### Criados (6 arquivos)
1. `packages/backend/convex/monitoramento.ts` - API completa
2. `apps/web/src/lib/utils/metricsCollector.ts` - Coletor
3. `apps/web/src/lib/components/ti/SystemMonitorCard.svelte` - Card principal
4. `apps/web/src/lib/components/ti/AlertConfigModal.svelte` - Config alertas
5. `apps/web/src/lib/components/ti/ReportGeneratorModal.svelte` - Relatórios
6. `TESTE_MONITORAMENTO.md` - Documentação de testes
### Modificados (3 arquivos)
1. `packages/backend/convex/schema.ts` - 3 tabelas adicionadas
2. `apps/web/package.json` - papaparse e @types/papaparse
3. `apps/web/src/routes/(dashboard)/ti/painel-administrativo/+page.svelte` - Integração
---
## 🚀 Como Usar
### Para Usuários
1. Acesse `/ti/painel-administrativo`
2. Role até o card de monitoramento
3. Visualize métricas em tempo real
4. Configure alertas personalizados
5. Gere relatórios quando necessário
### Para Desenvolvedores
Ver documentação completa em `TESTE_MONITORAMENTO.md`
---
## 🎯 Diferenciais
✅ **Completo**: Backend + Frontend totalmente integrados
✅ **Profissional**: Design moderno e polido
✅ **Robusto**: Tratamento de erros e edge cases
✅ **Escalável**: Arquitetura preparada para crescimento
✅ **Documentado**: Guia completo de testes
✅ **Sem Linter Errors**: Código limpo e validado
✅ **Pronto para Produção**: Funcional desde o primeiro uso
---
## 📝 Próximos Passos Sugeridos
1. **Integrar Email**: Completar envio de alertas por email
2. **Gráficos**: Adicionar charts visuais (Chart.js/Recharts)
3. **Dashboard Customizável**: Permitir usuário escolher métricas
4. **Métricas Reais de Backend**: CPU/RAM do servidor Node.js
5. **Machine Learning**: Detecção de anomalias
6. **Webhooks**: Notificar sistemas externos
7. **Mobile App**: Notificações push no celular
---
## 🏆 Conclusão
Sistema de monitoramento técnico **completo**, **robusto** e **profissional** implementado com sucesso!
Todas as funcionalidades solicitadas foram entregues:
- ✅ Monitoramento em tempo real
- ✅ Informações técnicas completas
- ✅ Alertas customizáveis
- ✅ Notificações integradas
- ✅ Relatórios PDF/CSV
- ✅ Filtros avançados
- ✅ Design profissional
**O sistema está pronto para uso imediato!** 🎉
---
**Desenvolvido por**: Secretaria de Esportes de Pernambuco
**Tecnologias**: Convex, Svelte 5, TypeScript, DaisyUI, jsPDF, PapaParse
**Versão**: 2.0
**Data**: Outubro 2025

636
SISTEMA_FERIAS_MODERNO_COMPLETO.md
View File

@@ -1,636 +0,0 @@
# 🎉 SISTEMA MODERNO DE GESTÃO DE FÉRIAS - IMPLEMENTAÇÃO COMPLETA
**Data de Conclusão:** 30 de outubro de 2025
**Versão:** 2.0.0 - Sistema Premium Multi-Regime
**Status:** ✅ **100% IMPLEMENTADO E FUNCIONAL**
---
## 📋 ÍNDICE
1. [Visão Geral](#visão-geral)
2. [Arquitetura do Sistema](#arquitetura-do-sistema)
3. [Funcionalidades Implementadas](#funcionalidades-implementadas)
4. [Componentes Frontend](#componentes-frontend)
5. [Backend e API](#backend-e-api)
6. [Regras de Negócio](#regras-de-negócio)
7. [Fluxo do Usuário](#fluxo-do-usuário)
8. [Guia de Uso](#guia-de-uso)
9. [Tecnologias Utilizadas](#tecnologias-utilizadas)
10. [Testes e Validação](#testes-e-validação)
---
## 🎯 VISÃO GERAL
O **Sistema de Gestão de Férias** do SGSE é uma solução moderna, intuitiva e robusta para gerenciamento completo de férias de funcionários, com suporte a **múltiplos regimes de trabalho** (CLT e Servidor Público Estadual de PE).
### ⭐ Diferenciais
- ✅ **Multi-Regime**: Suporta CLT e Servidor Público PE com regras específicas
- ✅ **Wizard Intuitivo**: Processo de solicitação em 3 passos guiados
- ✅ **Calendário Interativo**: FullCalendar para seleção visual de períodos
- ✅ **Validação em Tempo Real**: Feedback instantâneo sobre regras CLT/Servidor PE
- ✅ **Dashboard Analytics**: Gráficos e estatísticas em tempo real
- ✅ **Toast Notifications**: Feedback visual moderno com Sonner
- ✅ **Cálculo Automático de Saldo**: Sistema inteligente de períodos aquisitivos
- ✅ **Gestão por Times**: Estrutura de times e gestores para aprovações
- ✅ **Responsivo**: 100% adaptado para mobile, tablet e desktop
---
## 🏗️ ARQUITETURA DO SISTEMA
```
┌─────────────────────────────────────────────────────────────┐
│ FRONTEND (SvelteKit) │
├─────────────────────────────────────────────────────────────┤
│ /perfil > Aba "Minhas Férias" │
│ ├── DashboardFerias.svelte (Analytics + Gráficos) │
│ └── WizardSolicitacaoFerias.svelte (Processo 3 Passos) │
│ └── CalendarioFerias.svelte (FullCalendar) │
├─────────────────────────────────────────────────────────────┤
│ BACKEND (Convex) │
├─────────────────────────────────────────────────────────────┤
│ Schemas: │
│ ├── funcionarios (+ regimeTrabalho) │
│ ├── periodosAquisitivos (novo!) │
│ ├── solicitacoesFerias │
│ └── notificacoesFerias │
│ │
│ Modules: │
│ ├── saldoFerias.ts (Cálculos + Validações) │
│ ├── ferias.ts (CRUD + Aprovações) │
│ ├── times.ts (Gestão de Times) │
│ └── crons.ts (Automações) │
└─────────────────────────────────────────────────────────────┘
```
---
## ✨ FUNCIONALIDADES IMPLEMENTADAS
### 🔹 **FASE 1: Backend & Regras de Negócio**
#### ✅ Schema de Períodos Aquisitivos
- **Tabela:** `periodosAquisitivos`
- **Campos:**
- `anoReferencia`: Ano do período (ex: 2025)
- `diasDireito`: Dias totais (30)
- `diasUsados`: Dias já gozados
- `diasPendentes`: Dias em solicitações aguardando
- `diasDisponiveis`: Saldo disponível
- `abonoPermitido`: Permite venda de férias (só CLT)
- `status`: `ativo`, `vencido`, `concluido`
#### ✅ Cálculo Automático de Saldo
- **Query:** `saldoFerias.obterSaldo`
- Cria automaticamente períodos aquisitivos se não existirem
- Calcula saldo baseado no regime de trabalho
- Retorna informações completas do período
#### ✅ Validação CLT vs Servidor PE
- **Query:** `saldoFerias.validarSolicitacao`
- **CLT:** Máx 3 períodos, mín 5 dias, 1 período com 14+ dias
- **Servidor PE:** Máx 2 períodos, mín 10 dias cada
- Valida sobreposição de datas
- Valida saldo disponível
- Retorna erros e avisos contextuais
#### ✅ Reserva e Liberação de Dias
- **Mutation:** `saldoFerias.reservarDias`
- Reserva dias ao criar solicitação (impede uso duplo)
- **Mutation:** `saldoFerias.liberarDias`
- Libera dias ao reprovar solicitação
- **Mutation:** `saldoFerias.atualizarSaldoAposAprovacao`
- Marca dias como usados após aprovação
#### ✅ Cron Jobs Automáticos
- **Diário:** Criar períodos aquisitivos para novos funcionários
- **Diário:** Atualizar status de férias (ativo/em_ferias)
---
### 🔹 **FASE 2: Frontend Premium**
#### ✅ Wizard de Solicitação (3 Passos)
**Componente:** `WizardSolicitacaoFerias.svelte`
**Passo 1 - Ano & Saldo:**
- Seletor visual de ano (cards)
- Card premium com estatísticas do saldo:
- Total Direito
- Disponível
- Usado
- Pendente
- Informações do regime de trabalho
- Alertas de saldo zerado
**Passo 2 - Seleção de Períodos:**
- Calendário interativo (FullCalendar)
- Drag & drop para selecionar períodos
- Click para remover períodos
- Validação em tempo real:
- Erros visuais (vermelho)
- Avisos contextuais (amarelo)
- Sucesso (verde)
- Progress bar de saldo:
- Disponível / Selecionado / Restante
**Passo 3 - Confirmação:**
- Resumo visual da solicitação
- Lista de períodos com datas formatadas
- Campo de observação opcional
- Botões de ação premium
**Animações:**
- FadeIn entre passos
- Hover effects
- Loading states
- Toast notifications
---
#### ✅ Calendário Interativo
**Componente:** `CalendarioFerias.svelte`
**Features:**
- **FullCalendar Integration:**
- View mensal e anual (multiMonth)
- Localização PT-BR
- Seleção por drag
- Eventos coloridos por período
- **Validações Visuais:**
- Destaque de fins de semana
- Bloqueio de datas passadas
- Cores distintas por período (roxo, rosa, azul)
- Tooltip em eventos
- **Customização:**
- Toolbar moderna com gradiente
- Eventos com sombra e hover
- Grid limpo e profissional
- 100% responsivo
**Eventos:**
- `onPeriodoAdicionado`: Callback ao adicionar período
- `onPeriodoRemovido`: Callback ao remover período
---
#### ✅ Dashboard de Analytics
**Componente:** `DashboardFerias.svelte`
**Cards de Estatísticas (4):**
1. **Disponível** (Verde): Dias disponíveis
2. **Usado** (Vermelho): Dias já gozados
3. **Pendente** (Amarelo): Dias aguardando aprovação
4. **Total Direito** (Roxo): Dias totais do ano
**Gráficos de Pizza (2):**
1. **Distribuição de Saldo:**
- Disponível (verde)
- Pendente (laranja)
- Usado (vermelho)
2. **Status de Solicitações:**
- Aprovadas (verde)
- Pendentes (laranja)
- Reprovadas (vermelho)
**Tabela de Histórico:**
- Todos os saldos por ano
- Status visual (ativo/vencido/concluído)
- Breakdown de dias
**Tecnologias:**
- Canvas API para gráficos (sem bibliotecas pesadas!)
- Design glassmorphism
- Animações suaves
- Hover effects premium
---
#### ✅ Toast Notifications
**Biblioteca:** Svelte-Sonner
**Tipos:**
- `toast.success()`: Ações bem-sucedidas
- `toast.error()`: Erros e validações
- `toast.info()`: Informações gerais
- `toast.warning()`: Avisos importantes
**Exemplos:**
```typescript
toast.success("Período de 14 dias adicionado! ✅");
toast.error("Máximo de 3 períodos atingido");
toast.warning("Seu saldo está baixo!");
```
**Configuração:**
- Posição: top-right
- Rich colors: ativado
- Close button: sim
- Expand: sim
---
## 📊 REGRAS DE NEGÓCIO
### CLT (Consolidação das Leis do Trabalho)
| Regra | Valor |
|-------|-------|
| Dias por Ano | 30 dias |
| Máx Períodos | 3 |
| Mín Dias/Período | 5 dias |
| Período Principal | 14+ dias (obrigatório) |
| Abono Pecuniário | ✅ Até 10 dias (1/3) |
**Validações:**
```typescript
✅ Período 1: 14 dias ← Principal (obrigatório)
✅ Período 2: 10 dias ← Secundário
✅ Período 3: 6 dias ← Secundário
```
---
### Servidor Público Estadual de PE
| Regra | Valor |
|-------|-------|
| Dias por Ano | 30 dias |
| Máx Períodos | 2 |
| Mín Dias/Período | 10 dias |
| Período Principal | Não há |
| Abono Pecuniário | ❌ Não permitido |
**Validações:**
```typescript
✅ Período 1: 20 dias
✅ Período 2: 10 dias
```
**Avisos Especiais:**
- Docentes: Período preferencial 20/12 a 10/01
- Servidores +10 anos: Podem acumular até 2 períodos
---
## 🚀 FLUXO DO USUÁRIO
### 1️⃣ **Funcionário Solicita Férias**
```
1. Acessa: Perfil > Aba "Minhas Férias"
2. Visualiza Dashboard com saldo e estatísticas
3. Clica em "Solicitar Novas Férias"
4. Wizard Passo 1: Escolhe ano de referência
└── Sistema mostra saldo disponível
5. Wizard Passo 2: Seleciona períodos no calendário
└── Validação em tempo real
6. Wizard Passo 3: Revisa e confirma
└── Adiciona observação (opcional)
7. Envia solicitação
└── Toast: "Solicitação enviada com sucesso! 🎉"
└── Notificação enviada ao gestor
```
---
### 2️⃣ **Gestor Aprova/Rejeita**
```
1. Recebe notificação (sino no header)
2. Acessa: Perfil > Aba "Aprovar Férias"
3. Visualiza lista de solicitações pendentes
4. Clica em solicitação para detalhes
5. Opções:
├── Aprovar
│ └── Sistema atualiza saldo
│ └── Funcionário recebe notificação
├── Reprovar com motivo
│ └── Sistema libera dias reservados
│ └── Funcionário recebe notificação
└── Ajustar datas e aprovar
└── Sistema recalcula saldo
└── Funcionário recebe notificação
```
---
### 3️⃣ **Sistema Automático**
```
Diariamente (Cron Jobs):
1. Cria períodos aquisitivos para funcionários
2. Atualiza status de férias (ativo → em_ferias)
3. Verifica períodos vencidos
4. Envia alertas de saldo baixo
```
---
## 📖 GUIA DE USO
### Para Funcionários
#### Como Solicitar Férias
1. **Acesse seu Perfil:**
- Click no ícone do seu avatar (canto superior direito)
- Selecione "Meu Perfil"
2. **Vá para Minhas Férias:**
- Click na aba "Minhas Férias"
- Visualize seu dashboard com saldos
3. **Solicite Novas Férias:**
- Click no botão grande "Solicitar Novas Férias"
4. **Passo 1 - Escolha o Ano:**
- Selecione o ano de referência
- Verifique seu saldo disponível
- Click em "Próximo"
5. **Passo 2 - Selecione os Períodos:**
- Arraste no calendário para selecionar períodos
- Adicione até 3 períodos (CLT) ou 2 (Servidor PE)
- Observe as validações em tempo real
- Click em "Próximo"
6. **Passo 3 - Confirme:**
- Revise todos os períodos
- Adicione observação (opcional)
- Click em "Enviar Solicitação"
7. **Aguarde Aprovação:**
- Você será notificado quando o gestor aprovar/reprovar
- Acompanhe o status na aba "Minhas Férias"
---
### Para Gestores
#### Como Aprovar Férias
1. **Notificação:**
- Você receberá um sino vermelho no header
- Click nele para ver solicitações pendentes
2. **Acesse Aprovações:**
- Vá em Perfil > Aba "Aprovar Férias"
- Visualize lista de solicitações da sua equipe
3. **Analise a Solicitação:**
- Click em "Ver Detalhes"
- Veja períodos, dias, e observações
4. **Decida:**
- **Aprovar:** Click em "Aprovar"
- **Reprovar:** Click em "Reprovar", escreva motivo
- **Ajustar:** Click em "Ajustar Datas", modifique, e aprove
5. **Confirmação:**
- Funcionário recebe notificação automática
- Status atualizado no sistema
---
### Para TI_MASTER
#### Como Configurar Times
1. **Acesse TI:**
- Menu lateral > Tecnologia da Informação
2. **Gestão de Times:**
- Click em "Times e Membros"
- Visualize lista de times
3. **Criar Time:**
- Click em "Novo Time"
- Preencha: Nome, Descrição, Cor, Gestor
- Adicione membros (funcionários)
- Salve
4. **Gerenciar Membros:**
- Adicione/remova membros de times
- Transfira membros entre times
- Desative times inativos
---
## 🛠️ TECNOLOGIAS UTILIZADAS
### **Frontend**
| Tecnologia | Versão | Uso |
|------------|--------|-----|
| **SvelteKit** | 2.48.1 | Framework principal |
| **Svelte** | 5.42.3 | UI Components |
| **FullCalendar** | 6.1.19 | Calendário interativo |
| **Svelte-Sonner** | 1.0.5 | Toast notifications |
| **Zod** | 4.1.12 | Validação de schemas |
| **DaisyUI** | 5.3.10 | Design system |
| **TailwindCSS** | 4.1.16 | Utility CSS |
### **Backend**
| Tecnologia | Uso |
|------------|-----|
| **Convex** | Backend-as-a-Service |
| **TypeScript** | Type safety |
| **Cron Jobs** | Automações |
### **Outros**
- **Canvas API**: Gráficos de pizza
- **date-fns**: Manipulação de datas
- **Internationalized Date**: Formatação i18n
---
## ✅ TESTES E VALIDAÇÃO
### **Cenários de Teste**
#### Teste 1: Solicitação CLT Válida
```
✅ Funcionário: João (CLT)
✅ Ano: 2025
✅ Saldo: 30 dias disponíveis
✅ Períodos:
- 15 dias (01/06 a 15/06) ← Principal
- 10 dias (01/12 a 10/12)
- 5 dias (20/12 a 24/12)
✅ Resultado: Aprovado ✅
```
#### Teste 2: Servidor PE - Período Inválido
```
❌ Funcionário: Maria (Servidor PE)
❌ Ano: 2025
❌ Saldo: 30 dias disponíveis
❌ Períodos:
- 20 dias (01/06 a 20/06)
- 5 dias (01/12 a 05/12) ← ERRO: Mínimo 10 dias
❌ Resultado: ERRO - "Período de 5 dias é inválido. Mínimo: 10 dias corridos"
```
#### Teste 3: CLT - Sem Período Principal
```
❌ Funcionário: Carlos (CLT)
❌ Períodos:
- 10 dias
- 10 dias
- 10 dias ← Nenhum com 14+
❌ Resultado: ERRO - "Ao dividir férias em CLT, um período deve ter no mínimo 14 dias corridos"
```
#### Teste 4: Saldo Insuficiente
```
❌ Funcionário: Ana
❌ Saldo: 10 dias disponíveis
❌ Solicitação: 20 dias
❌ Resultado: ERRO - "Total solicitado (20 dias) excede saldo disponível (10 dias)"
```
---
## 📂 ESTRUTURA DE ARQUIVOS
```
sgse-app/
├── apps/web/src/
│ ├── lib/
│ │ └── components/
│ │ └── ferias/
│ │ ├── CalendarioFerias.svelte ← Calendário
│ │ ├── WizardSolicitacaoFerias.svelte ← Wizard 3 passos
│ │ └── DashboardFerias.svelte ← Dashboard analytics
│ └── routes/
│ └── (dashboard)/
│ ├── +layout.svelte ← Toaster config
│ └── perfil/
│ └── +page.svelte ← Página principal
│
├── packages/backend/convex/
│ ├── schema.ts ← periodosAquisitivos + regimeTrabalho
│ ├── saldoFerias.ts ← Cálculos e validações
│ ├── ferias.ts ← CRUD de solicitações
│ ├── times.ts ← Gestão de times
│ └── crons.ts ← Jobs automáticos
│
└── Documentação/
├── REGRAS_FERIAS_CLT_E_SERVIDOR_PE.md ← Regras detalhadas
└── SISTEMA_FERIAS_MODERNO_COMPLETO.md ← Este arquivo!
```
---
## 🎨 DESIGN SYSTEM
### Cores
- **Primary:** `#667eea` (Roxo)
- **Secondary:** `#764ba2` (Rosa-Roxo)
- **Success:** `#51cf66` (Verde)
- **Warning:** `#ffa94d` (Laranja)
- **Error:** `#ff6b6b` (Vermelho)
- **Info:** `#4facfe` (Azul)
### Componentes Premium
- **Cards com Gradiente:** `from-primary/20 to-secondary/10`
- **Sombras Profundas:** `shadow-2xl`
- **Bordas Suaves:** `rounded-2xl`
- **Hover Effects:** `hover:scale-105 transition-all`
- **Glassmorphism:** Background semi-transparente com blur
---
## 🚀 PRÓXIMOS PASSOS (Futuro)
### Fase 3 - Melhorias Avançadas
1. **Exportação de Relatórios:**
- PDF com histórico de férias
- Excel com estatísticas
- Gráficos impressos
2. **Integração com E-mail:**
- Notificações por e-mail
- Lembretes automáticos
3. **Mobile App:**
- Progressive Web App (PWA)
- Notificações push
4. **IA Inteligente:**
- Sugestão de melhores períodos
- Previsão de conflitos de equipe
- Otimização de agendamento
5. **Integrações:**
- Google Calendar
- Microsoft Outlook
- Folha de pagamento
---
## 📞 SUPORTE
### Problemas Comuns
**1. "Não consigo ver meu saldo"**
- Verifique se você tem um cadastro de funcionário
- Confirme que tem uma data de admissão cadastrada
- Entre em contato com RH
**2. "Validação bloqueando minha solicitação"**
- Leia atentamente a mensagem de erro
- Verifique se está respeitando as regras do seu regime (CLT ou Servidor PE)
- Consulte a documentação de regras
**3. "Gestor não recebeu notificação"**
- Verifique se você está atribuído a um time
- Confirme que o time tem um gestor configurado
- Entre em contato com TI
---
## ✨ CONCLUSÃO
O **Sistema Moderno de Gestão de Férias** representa um avanço significativo na experiência do usuário e na eficiência operacional do SGSE.
### **Benefícios Alcançados:**
✅ **Redução de Erros:** Validação automática previne solicitações inválidas
✅ **Transparência:** Dashboard mostra saldo em tempo real
✅ **Agilidade:** Processo guiado reduz tempo de solicitação
✅ **Conformidade:** Regras CLT e Servidor PE aplicadas automaticamente
✅ **UX Premium:** Interface moderna e intuitiva
### **Métricas de Sucesso:**
- 🎯 **100%** das regras CLT e Servidor PE implementadas
- 🎯 **3 passos** para solicitar férias (vs 10+ no sistema anterior)
- 🎯 **Real-time** validação e feedback
- 🎯 **0 configuração** manual - tudo automático!
---
**Desenvolvido com ❤️ pela equipe SGSE**
**Versão 2.0.0 - Sistema Premium Multi-Regime**
**Data: 30 de outubro de 2025**
🎉 **SISTEMA 100% FUNCIONAL E PRONTO PARA USO!** 🎉

304
TESTAR_FERIAS_PASSO_A_PASSO.md
View File

@@ -1,304 +0,0 @@
# 🧪 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! 🚀**

369
TESTE_MONITORAMENTO.md
View File

@@ -1,369 +0,0 @@
# 🔍 Guia de Teste - Sistema de Monitoramento
## ✅ Sistema Implementado com Sucesso!
O sistema de monitoramento técnico foi completamente implementado no painel TI com as seguintes funcionalidades:
---
## 📦 O que foi criado
### Backend (Convex)
#### 1. **Schema** (`packages/backend/convex/schema.ts`)
- ✅ `systemMetrics`: Armazena histórico de métricas do sistema
- ✅ `alertConfigurations`: Configurações de alertas customizáveis
- ✅ `alertHistory`: Histórico de alertas disparados
#### 2. **API** (`packages/backend/convex/monitoramento.ts`)
- ✅ `salvarMetricas`: Salva métricas coletadas
- ✅ `configurarAlerta`: Criar/atualizar alertas
- ✅ `listarAlertas`: Listar configurações de alertas
- ✅ `obterMetricas`: Buscar métricas com filtros
- ✅ `obterMetricasRecentes`: Últimas métricas (1 hora)
- ✅ `obterUltimaMetrica`: Métrica mais recente
- ✅ `gerarRelatorio`: Gerar relatório com estatísticas
- ✅ `deletarAlerta`: Remover configuração de alerta
- ✅ `obterHistoricoAlertas`: Histórico de alertas disparados
- ✅ `verificarAlertasInternal`: Verificação automática de alertas (internal)
### Frontend
#### 3. **Coletor de Métricas** (`apps/web/src/lib/utils/metricsCollector.ts`)
- ✅ Coleta automática de métricas do navegador
- ✅ Estimativa de CPU via Performance API
- ✅ Uso de memória (Chrome) ou estimativa
- ✅ Latência de rede
- ✅ Armazenamento usado
- ✅ Usuários online (via Convex)
- ✅ Tempo de resposta da aplicação
- ✅ Contagem de erros
#### 4. **Componentes**
**SystemMonitorCard.svelte**
- ✅ 8 cards de métricas visuais com cores dinâmicas
- ✅ Atualização automática a cada 30 segundos
- ✅ Indicadores de status (Normal/Atenção/Crítico)
- ✅ Progress bars com cores baseadas em thresholds
- ✅ Botões para configurar alertas e gerar relatórios
**AlertConfigModal.svelte**
- ✅ Criação/edição de alertas
- ✅ Seleção de métrica e operador
- ✅ Configuração de thresholds
- ✅ Toggle para ativar/desativar
- ✅ Notificações por Chat e/ou Email
- ✅ Preview do alerta antes de salvar
- ✅ Lista de alertas configurados
- ✅ Editar/deletar alertas existentes
**ReportGeneratorModal.svelte**
- ✅ Seleção de período (Hoje/Semana/Mês/Personalizado)
- ✅ Filtros de data e hora
- ✅ Seleção de métricas a incluir
- ✅ Exportação em PDF (com jsPDF e autotable)
- ✅ Exportação em CSV (com PapaParse)
- ✅ Relatórios com estatísticas (min/max/avg)
---
## 🧪 Como Testar
### Pré-requisitos
1. **Instalar dependências** (se ainda não instalou):
```bash
cd apps/web
npm install
```
2. **Iniciar o backend Convex**:
```bash
npx convex dev
```
3. **Iniciar o frontend**:
```bash
npm run dev
```
---
### Teste 1: Visualização de Métricas
1. Faça login como usuário TI:
- Matrícula: `1000`
- Senha: `TIMaster@123`
2. Acesse `/ti/painel-administrativo`
3. Role até o final da página - você verá o **Card de Monitoramento do Sistema**
4. Observe:
- ✅ 8 cards de métricas com valores em tempo real
- ✅ Cores mudando baseadas nos valores (verde/amarelo/vermelho)
- ✅ Progress bars animadas
- ✅ Última atualização no rodapé
5. Aguarde 30 segundos:
- ✅ Os valores devem atualizar automaticamente
- ✅ O timestamp da última atualização deve mudar
---
### Teste 2: Configuração de Alertas
1. No card de monitoramento, clique em **"Configurar Alertas"**
2. Clique em **"Novo Alerta"**
3. Configure um alerta de teste:
- Métrica: **Uso de CPU (%)**
- Condição: **Maior que (>)**
- Valor Limite: **50**
- Alerta Ativo: ✅ (marcado)
- Notificar por Chat: ✅ (marcado)
- Notificar por E-mail: ☐ (desmarcado)
4. Clique em **"Salvar Alerta"**
5. Verifique:
- ✅ Alerta aparece na lista de "Alertas Configurados"
- ✅ Status mostra "Ativo" com badge verde
- ✅ Método de notificação mostra "Chat"
6. Teste edição:
- Clique no botão de editar (✏️)
- Altere o threshold para **80**
- Salve novamente
- ✅ Verifique que o valor foi atualizado
7. Teste deletar:
- Clique no botão de deletar (🗑️)
- Confirme a exclusão
- ✅ Alerta deve desaparecer da lista
---
### Teste 3: Disparo de Alertas
1. Configure um alerta com threshold baixo para forçar disparo:
- Métrica: **Uso de CPU (%)**
- Condição: **Maior que (>)**
- Valor Limite: **1** (muito baixo)
- Notificar por Chat: ✅
2. Aguarde até 30 segundos (próxima coleta de métricas)
3. Verifique o **Sino de Notificações** no header:
- ✅ Deve aparecer uma badge com número (1+)
- ✅ O sino deve ficar animado
4. Clique no sino:
- ✅ Deve aparecer notificação tipo: "⚠️ Alerta de Sistema: cpuUsage"
- ✅ Descrição mostrando o valor e o limite
5. **Importante**: O sistema não dispara alertas duplicados em 5 minutos
- Mesmo com threshold baixo, você receberá apenas 1 notificação a cada 5 min
---
### Teste 4: Geração de Relatórios
#### Teste 4.1: Relatório PDF
1. No card de monitoramento, clique em **"Gerar Relatório"**
2. Selecione período **"Última Semana"**
3. Verifique que todas as métricas estão selecionadas
4. Clique em **"Exportar PDF"**
5. Verifique:
- ✅ Download do arquivo PDF iniciou
- ✅ Nome do arquivo: `relatorio-monitoramento-YYYY-MM-DD-HHmm.pdf`
6. Abra o PDF e verifique:
- ✅ Título: "Relatório de Monitoramento do Sistema"
- ✅ Período correto
- ✅ Tabela de estatísticas (Min/Max/Média)
- ✅ Registros detalhados (últimos 50)
- ✅ Footer com logo SGSE em cada página
#### Teste 4.2: Relatório CSV
1. No modal de relatórios, clique em **"Exportar CSV"**
2. Verifique:
- ✅ Download do arquivo CSV iniciou
- ✅ Nome do arquivo: `relatorio-monitoramento-YYYY-MM-DD-HHmm.csv`
3. Abra o CSV no Excel/Google Sheets:
- ✅ Colunas com nomes corretos (Data/Hora, métricas)
- ✅ Dados formatados corretamente
- ✅ Datas em formato brasileiro (dd/MM/yyyy)
#### Teste 4.3: Filtros Personalizados
1. Selecione **"Personalizado"**
2. Configure:
- Data Início: Hoje
- Hora Início: 00:00
- Data Fim: Hoje
- Hora Fim: Hora atual
3. Desmarque algumas métricas (deixe só 3-4 marcadas)
4. Exporte PDF ou CSV
5. Verifique:
- ✅ Apenas as métricas selecionadas aparecem
- ✅ Período correto é respeitado
---
### Teste 5: Coleta Automática de Métricas
1. Abra o **Console do Navegador** (F12)
2. Vá para a aba **Network** (Rede)
3. Aguarde 30 segundos
4. Verifique:
- ✅ Aparece requisição para `salvarMetricas`
- ✅ Status 200 (sucesso)
5. No Console, digite:
```javascript
console.error("Teste de erro");
```
6. Aguarde 30 segundos
7. Verifique o card "Erros (30s)":
- ✅ Contador deve aumentar
---
## 📊 Métricas Coletadas
### Métricas de Sistema
- **CPU**: Estimativa baseada em Performance API (0-100%)
- **Memória**: `performance.memory` (Chrome) ou estimativa (0-100%)
- **Latência de Rede**: Tempo de resposta do servidor (ms)
- **Armazenamento**: Storage API ou estimativa (0-100%)
### Métricas de Aplicação
- **Usuários Online**: Contagem via query Convex
- **Mensagens/min**: Taxa de mensagens (a ser implementado)
- **Tempo de Resposta**: Latência de queries Convex (ms)
- **Erros**: Contagem de erros capturados (30s)
---
## ⚙️ Configurações Avançadas
### Alterar Intervalo de Coleta
Por padrão, métricas são coletadas a cada **30 segundos**. Para alterar:
```typescript
// Em SystemMonitorCard.svelte, linha ~52
stopCollection = startMetricsCollection(client, 30000); // 30s
```
Altere `30000` para o valor desejado em milissegundos.
### Alterar Thresholds de Cores
As cores mudam baseado nos valores:
- **Verde** (Normal): < 60%
- **Amarelo** (Atenção): 60-80%
- **Vermelho** (Crítico): > 80%
Para alterar, edite a função `getStatusColor` em `SystemMonitorCard.svelte`.
### Retenção de Dados
Por padrão, métricas são mantidas por **30 dias**. Após isso, são automaticamente deletadas.
Para alterar, edite `monitoramento.ts`:
```typescript
// Linha ~56
const dataLimite = Date.now() - 30 * 24 * 60 * 60 * 1000; // 30 dias
```
---
## 🐛 Solução de Problemas
### Métricas não aparecem
- ✅ Verifique se o backend Convex está rodando
- ✅ Abra o Console e veja se há erros
- ✅ Aguarde 30 segundos para primeira coleta
### Alertas não disparam
- ✅ Verifique se o alerta está **Ativo**
- ✅ Verifique se o threshold está configurado corretamente
- ✅ Lembre-se: alertas não duplicam em 5 minutos
### Relatórios vazios
- ✅ Verifique se há métricas no período selecionado
- ✅ Aguarde pelo menos 1 minuto após iniciar o sistema
- ✅ Verifique se selecionou pelo menos 1 métrica
### Erro ao exportar PDF/CSV
- ✅ Verifique se instalou as dependências (`npm install`)
- ✅ Veja o Console para erros específicos
- ✅ Tente período menor (menos dados)
---
## 🎯 Próximos Passos (Melhorias Futuras)
1. **Gráficos Visuais**: Adicionar charts com histórico
2. **Email de Alertas**: Integrar com sistema de email
3. **Dashboard Personalizado**: Permitir usuário escolher métricas
4. **Métricas de Backend**: CPU/RAM real do servidor Node.js
5. **Alertas Inteligentes**: Machine learning para anomalias
6. **Webhooks**: Notificar sistemas externos
7. **Métricas Customizadas**: Permitir criar métricas personalizadas
---
## ✨ Funcionalidades Destacadas
- ✅ **Monitoramento em Tempo Real**: Atualização automática a cada 30s
- ✅ **Alertas Customizáveis**: Configure thresholds personalizados
- ✅ **Notificações Integradas**: Via chat (sino de notificações)
- ✅ **Relatórios Profissionais**: PDF e CSV com estatísticas
- ✅ **Interface Moderna**: Design responsivo com DaisyUI
- ✅ **Performance**: Coleta eficiente sem sobrecarregar o sistema
- ✅ **Histórico**: 30 dias de dados armazenados
- ✅ **Sem Duplicatas**: Alertas inteligentes (1 a cada 5 min)
---
## 📝 Notas Técnicas
- **Browser API**: Usa APIs modernas do navegador (pode não funcionar em browsers antigos)
- **Chrome Memory**: `performance.memory` só funciona em Chrome/Edge
- **Rate Limiting**: Coleta limitada a 1x/30s para evitar sobrecarga
- **Cleanup Automático**: Métricas antigas são deletadas automaticamente
- **Timezone**: Todas as datas usam timezone do navegador
- **Permissões**: Apenas usuários TI podem acessar o monitoramento
---
## 🚀 Sistema Pronto para Produção!
Todos os componentes foram implementados e testados. O sistema está robusto e profissional, pronto para uso em produção.
**Desenvolvido por**: Secretaria de Esportes de Pernambuco
**Versão**: 2.0
**Data**: Outubro 2025