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/usuarios.ts

@@ -4,6 +4,60 @@ import { hashPassword, generateToken } from "./auth/utils";
 import { registrarAtividade } from "./logsAtividades";
 import { Id } from "./_generated/dataModel";
 
+/**
+ * Associar funcionário a um usuário
+ */
+export const associarFuncionario = mutation({
+  args: {
+    usuarioId: v.id("usuarios"),
+    funcionarioId: v.id("funcionarios"),
+  },
+  returns: v.object({ sucesso: v.boolean() }),
+  handler: async (ctx, args) => {
+    // Verificar se o funcionário existe
+    const funcionario = await ctx.db.get(args.funcionarioId);
+    if (!funcionario) {
+      throw new Error("Funcionário não encontrado");
+    }
+
+    // Verificar se o funcionário já está associado a outro usuário
+    const usuarioExistente = await ctx.db
+      .query("usuarios")
+      .withIndex("by_funcionarioId", (q) => q.eq("funcionarioId", args.funcionarioId))
+      .first();
+
+    if (usuarioExistente && usuarioExistente._id !== args.usuarioId) {
+      throw new Error(
+        `Este funcionário já está associado ao usuário: ${usuarioExistente.nome} (${usuarioExistente.matricula})`
+      );
+    }
+
+    // Associar funcionário ao usuário
+    await ctx.db.patch(args.usuarioId, {
+      funcionarioId: args.funcionarioId,
+    });
+
+    return { sucesso: true };
+  },
+});
+
+/**
+ * Desassociar funcionário de um usuário
+ */
+export const desassociarFuncionario = mutation({
+  args: {
+    usuarioId: v.id("usuarios"),
+  },
+  returns: v.object({ sucesso: v.boolean() }),
+  handler: async (ctx, args) => {
+    await ctx.db.patch(args.usuarioId, {
+      funcionarioId: undefined,
+    });
+
+    return { sucesso: true };
+  },
+});
+
 /**
  * Criar novo usuário (apenas TI)
  */
@@ -405,6 +459,30 @@ export const atualizarPerfil = mutation({
  */
 export const obterPerfil = query({
   args: {},
+  returns: v.union(
+    v.object({
+      _id: v.id("usuarios"),
+      nome: v.string(),
+      email: v.string(),
+      matricula: v.string(),
+      funcionarioId: v.optional(v.id("funcionarios")),
+      avatar: v.optional(v.string()),
+      fotoPerfil: v.optional(v.id("_storage")),
+      fotoPerfilUrl: v.union(v.string(), v.null()),
+      setor: v.optional(v.string()),
+      statusMensagem: v.optional(v.string()),
+      statusPresenca: v.optional(v.union(
+        v.literal("online"),
+        v.literal("offline"),
+        v.literal("ausente"),
+        v.literal("externo"),
+        v.literal("em_reuniao")
+      )),
+      notificacoesAtivadas: v.boolean(),
+      somNotificacao: v.boolean(),
+    }),
+    v.null()
+  ),
   handler: async (ctx) => {
     console.log("=== DEBUG obterPerfil ===");
     
@@ -464,6 +542,7 @@ export const obterPerfil = query({
       nome: usuarioAtual.nome,
       email: usuarioAtual.email,
       matricula: usuarioAtual.matricula,
+      funcionarioId: usuarioAtual.funcionarioId,
       avatar: usuarioAtual.avatar,
       fotoPerfil: usuarioAtual.fotoPerfil,
       fotoPerfilUrl,