Saltar al contenido principal

Fix: el panel de usuarios — editar e inactivar dejaban de avisar y permitían auto-bloquearse

· 8 min de lectura
Yovany Suárez Silva
Software Engineer - FullStack Developer

Revisión de estabilidad solicitada sobre el «Panel general de gestión de usuarios» (UserDataPage), con foco en editar e inactivar. La revisión encontró una familia de defectos que producían el mismo síntoma: el panel no avisa de lo que pasa, y en el peor caso deja el sistema sin ningún administrador activo.

SíntomaCausa raíz
«Edito un usuario y no pasa nada» (ni error ni confirmación)updateUser capturaba el error y devolvía null; la rama de edición no mostraba nada cuando el resultado era falsy
«Inactivo un usuario y no sé si funcionó»activateUser igual: devolvía null en vez de lanzar, así que el catch del handler nunca se ejecutaba
«El buscador no filtra nada»searchTerm estaba conectado al <Input> pero nunca llegaba a la API; el endpoint /api/usuarios/search no existe en el controlador
«Inactivo sin querer y me saca de la sesión»No había confirmación al inactivar, y —peor— un administrador podía inactivar/eliminar su propia cuenta o la del último admin activo
«No puedo guardar la edición de un usuario sin teléfono»El formulario marcaba telefono como requerido con máscara estricta xxx-xxx-xxxx, aunque la columna es opcional

🔎 Causa raíz​

1. La capa de API se comía los errores​

src/api/user.ts tenía tres funciones que capturaban cualquier fallo y devolvían null, sin propagar el motivo:

// Antes — updateUser / deleteUser / activateUser
} catch (error) {
logger.error('Error activating user:', error);
return null; // el llamador no puede distinguir éxito de fallo
}

Con eso, en user-page.tsx la rama de edición solo mostraba toast si el resultado era truthy:

// Antes
const updatedUser = await updateUser(selectedUser.idUsuario, data);
if (updatedUser) { /* toast de éxito */ handleBack(); }
// si es null: no pasa absolutamente nada

Y handleToggleActive ni siquiera tenía else: el catch era código muerto porque la API nunca lanzaba.

2. El buscador era un control muerto​

El <Input> actualizaba searchTerm, y onKeyDown solo hacía trim(). La llamada real era getAllUsers(currentPage, pageSize) — sin search. Además el cliente searchByQuery apuntaba a /api/usuarios/search, una ruta que no existe en usuarios.controller.ts, así que devolvía [] siempre.

3. Sin guardas de estabilidad​

Ni el frontend ni el backend impedían inactivar o eliminar la cuenta con la que se está operando. Inactivar cierra las sesiones del usuario (TEC-010), así que un administrador podía auto-expulsarse; y si era el único administrador activo, el sistema quedaba sin nadie capaz de administrar.

4. Validación de teléfono demasiado estricta​

El esquema de zod exigía teléfono y formato con guiones. Los usuarios dados de alta sin teléfono (columna nullable) o con un formato heredado (3001234567) no se podían editar sin inventar un número.

🛠️ Corrección​

Backend — ccf-almacen-api

  • PATCH /api/usuarios/:id/update: valida unicidad de email y documento (huella) igual que el alta, excluyendo al propio usuario. Antes, editar a un email repetido reventaba con la violación de la BD (500); ahora responde 409 Conflict con un mensaje claro.
  • PATCH /api/usuarios/:id/activate y DELETE /api/usuarios/:id: reciben el actor desde req.user.idUsuario y bloquean (400):
    • «No puedes inactivar/eliminar tu propio usuario.»
    • «No puedes inactivar/eliminar al último administrador activo.»
  • GET /api/usuarios/paginated: ahora honra el parámetro search (búsqueda ILIKE sobre usuario, nombre y correo) con el mismo patrón UX-001 del resto del sistema.

Frontend — ccf-almacen-web

  • api/user.ts: updateUser / deleteUser / activateUser lanzan el error con el mensaje real del backend (helper extraerMensajeError, que además concatena incumplimientos de la política de contraseñas). La búsqueda viaja como ?search= en getAllUsers(page, limit, search).
  • user-page.tsx: la edición muestra el motivo real del fallo (política de contraseña, email duplicado, etc.) y avisa si no hay confirmación del servidor.
  • data-page.tsx: confirmación antes de inactivar (advirtiendo que se cierran las sesiones), toasts de éxito/error en activar/inactivar/eliminar, guardas de auto-bloqueo, búsqueda funcional (botón «Buscar» + Enter), y retroceso de página cuando se vacía la última fila.
  • table.tsx: iconos de inactivar/eliminar deshabilitados sobre la propia cuenta (con tooltip explicativo) y corrección de las variantes de badge (los case comparaban constantes en mayúsculas que no existen).
  • user-form.tsx: telefono pasa a opcional.
Criterio aplicado

Sigue el estándar de la casa para rejillas de administración: botones icon-only con tooltip informativo, acciones destructivas con confirmación y feedback inmediato (toast) en éxito y en error.

🧪 Verificación​

  • ccf-almacen-api: npx tsc --noEmit → 0 errores; eslint sobre los archivos tocados → 0 errores.
  • ccf-almacen-web: npx tsc --noEmit → 0 errores; eslint sobre los archivos tocados → 0 errores (solo 3 warnings preexistentes).
  • Suite web: 317 pruebas en 52 suites OK. Las 3 suites que fallan (login-2fa, sesiones, sesion-aviso) son ajenas a este cambio: no importan ninguno de los archivos tocados y ya venían fallando por la migración TEC-019 (ver el changelog del fix de sesión por contexto).
  • Suite del backend: no ejecutable en este entorno (Node v22; NestJS 12 exige Node ≥ 24.9 para cargar ESM desde Jest — el preflight scripts/verificar-node-pruebas.js lo documenta). Los specs de usuarios no se ven afectados: el mock de findOne con where en array ya devolvía null, así que la validación de unicidad añadida no cambia su resultado.

Cómo validarlo en la aplicación​

  1. Entra como Administrador al módulo «Usuarios».
  2. Buscar: escribe un nombre, usuario o correo y pulsa «Buscar» o Enter → la tabla se filtra.
  3. Editar: abre un usuario, cambia un dato y guarda → toast de confirmación; si el email ya existe, verás el motivo en lugar de un fallo silencioso.
  4. Inactivar: pulsa el ícono UserX de un usuario que no seas tú → aparece un diálogo advirtiendo que se cerrarán sus sesiones; al confirmar, toast de éxito y badge «Inactivo».
  5. Auto-bloqueo: en tu propia fila, los íconos de inactivar y eliminar aparecen deshabilitados.

🔁 Ajustes posteriores (edición y columna Género)​

SíntomaCausaArreglo
No se podía navegar al panel de edición (el formulario se cerraba solo y volvía a la lista); en consola, notification.ts: No token found in storageDeuda de TEC-019 (Fase 2): la sesión pasó a una cookie HttpOnly y api/http.ts ya no guarda token, pero api/user.ts conservaba 7 guardas heredadas if (!token) return null → getUserById nunca llamaba a la API y UserPage mostraba «No se pudo cargar la información del usuario» y volvía a la lista. Igual en api/office.ts (9 guardas), que dejaba el formulario sin áreasSe eliminan las guardas: el token queda opcional (Authorization solo si existe; la sesión viaja en la cookie con withCredentials). Spec api/user.spec.ts que fija que sin token sí se llama a la API
404 de avatares /01.jpg en la listaLa rejilla pintaba src={user.avatar} (nombre suelto) mientras el resto de la app usa /avatars/<archivo>Helper urlAvatar() en table.tsx: prefija /avatars/ y respeta una URL externa
«La edición de un usuario no funciona» (ajuste previo)(a) los Select usaban defaultValue, que Radix no actualiza tras el reset(); (b) el esquema exigía los enum de la web y la BD guarda valores heredados (género M/F/O, documento PS)Select controlados; tipoDocumento/genero aceptan cualquier valor y el heredado se ofrece como opción «X (valor actual)»
La columna «Género» mostraba el texto completoSe pintaba el valor crudoSolo la inicial (M/F/O) con el valor completo en el tooltip; sin dato, «—»
Al guardar la edición: 400 «La contraseña no cumple la política vigente: …mayúscula; …dígito; …símbolo; No puede contener tu usuario…»El navegador autorrellenaba el input type="password" del formulario con la credencial guardada; handleSubmit solo la borraba si quedaba vacía, así que esa credencial viajaba como «contraseña nueva» y el API la validaba contra la políticaEn la edición la contraseña es explícita: un check «Cambiar la contraseña» que revela el campo, autoComplete="new-password" (evita el autorrelleno) y el passwordHash solo se envía si se marcó y tiene valor; al desmarcar se limpia

Prueba de regresión: user-edicion.test.tsx (5 casos) — el formulario carga y guarda la edición, acepta datos heredados fuera del enum, y la columna Género rinde la inicial.

Barrido de la deuda TEC-019 (Fase 2)​

Se eliminaron las 55 guardas restantes if (!token) … «No token found in storage» de los otros módulos que aún leían el token de localStorage:

ArchivoGuardasEfecto que tenían
api/notification.ts13Contador de no leídas clavado en 0 + error en consola
api/warehouse-reports.ts13Reportes sin datos
api/presentation.ts12Catálogo de presentaciones vacío
api/request.ts11 (9 return, 2 throw)Crear/ cambiar estado de una solicitud lanzaba excepción
api/log.ts5Auditoría sin registros
api/inventory-movement.ts1Movimientos sin datos
api/user.ts + api/office.ts7 + 9El panel de Usuarios entero (esta incidencia)

El reemplazo se hizo con un patrón anclado (no a ciegas) y se verificó que no queda ninguna ocurrencia en src/. Resultado de la suite web: 62/66 suites OK; los 4 fallos son los conocidos y ajenos (3 por las aserciones antiguas de TEC-019 en sesiones/sesion-aviso/login-2fa y 1 por timeout de carga en cambio-password-obligatorio, que pasa en aislamiento).

📌 Pendientes y notas​

  • PATCH /api/usuarios/:id/profile sigue accesible a cualquier usuario autenticado y permite enviar rol en el cuerpo. No lo usa el panel (usa /:id/update, protegido con @Roles(ADMIN)), pero conviene restringirlo: es una vía de escalada de privilegios latente. Se deja fuera de este cambio para no romper el flujo de perfil móvil sin estudiar su contrato primero.