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

packages/backend/convex/ferias.ts

@@ -1,5 +1,6 @@
 import { v } from "convex/values";
 import { mutation, query, internalMutation } from "./_generated/server";
+import { internal } from "./_generated/api";
 import { Id } from "./_generated/dataModel";
 
 // Validador para períodos
@@ -123,7 +124,7 @@ export const obterDetalhes = query({
   },
 });
 
-// Mutation: Criar solicitação de férias
+// Mutation: Criar solicitação de férias (com validação de saldo)
 export const criarSolicitacao = mutation({
   args: {
     funcionarioId: v.id("funcionarios"),
@@ -137,13 +138,22 @@ export const criarSolicitacao = mutation({
       throw new Error("É necessário adicionar pelo menos 1 período");
     }
     
-    if (args.periodos.length > 3) {
-      throw new Error("Máximo de 3 períodos permitidos");
-    }
-    
     const funcionario = await ctx.db.get(args.funcionarioId);
     if (!funcionario) throw new Error("Funcionário não encontrado");
     
+    // Calcular total de dias
+    let totalDias = 0;
+    for (const p of args.periodos) {
+      totalDias += p.diasCorridos;
+    }
+    
+    // Reservar dias no saldo (impede uso duplo)
+    await ctx.runMutation(internal.saldoFerias.reservarDias, {
+      funcionarioId: args.funcionarioId,
+      anoReferencia: args.anoReferencia,
+      totalDias,
+    });
+    
     // Buscar usuário que está criando (pode não ser o próprio funcionário)
     const usuario = await ctx.db
       .query("usuarios")
@@ -209,6 +219,11 @@ export const aprovar = mutation({
       ],
     });
     
+    // Atualizar saldo (de pendente para usado)
+    await ctx.runMutation(internal.saldoFerias.atualizarSaldoAposAprovacao, {
+      solicitacaoId: args.solicitacaoId,
+    });
+    
     // Notificar funcionário
     if (funcionario) {
       const usuario = await ctx.db
@@ -264,6 +279,11 @@ export const reprovar = mutation({
       ],
     });
     
+    // Liberar dias reservados de volta ao saldo
+    await ctx.runMutation(internal.saldoFerias.liberarDias, {
+      solicitacaoId: args.solicitacaoId,
+    });
+    
     // Notificar funcionário
     if (funcionario) {
       const usuario = await ctx.db
@@ -306,11 +326,24 @@ export const ajustarEAprovar = mutation({
       throw new Error("É necessário adicionar pelo menos 1 período");
     }
     
-    if (args.novosPeriodos.length > 3) {
-      throw new Error("Máximo de 3 períodos permitidos");
+    const funcionario = await ctx.db.get(solicitacao.funcionarioId);
+    
+    // Liberar dias antigos
+    await ctx.runMutation(internal.saldoFerias.liberarDias, {
+      solicitacaoId: args.solicitacaoId,
+    });
+    
+    // Calcular novos dias e reservar
+    let totalNovosDias = 0;
+    for (const p of args.novosPeriodos) {
+      totalNovosDias += p.diasCorridos;
     }
     
-    const funcionario = await ctx.db.get(solicitacao.funcionarioId);
+    await ctx.runMutation(internal.saldoFerias.reservarDias, {
+      funcionarioId: solicitacao.funcionarioId,
+      anoReferencia: solicitacao.anoReferencia,
+      totalDias: totalNovosDias,
+    });
     
     await ctx.db.patch(args.solicitacaoId, {
       status: "data_ajustada_aprovada",
@@ -328,6 +361,11 @@ export const ajustarEAprovar = mutation({
       ],
     });
     
+    // Atualizar saldo (marcar como usado)
+    await ctx.runMutation(internal.saldoFerias.atualizarSaldoAposAprovacao, {
+      solicitacaoId: args.solicitacaoId,
+    });
+    
     // Notificar funcionário
     if (funcionario) {
       const usuario = await ctx.db