Fix: el panel de usuarios — editar e inactivar dejaban de avisar y permitían auto-bloquearse
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íntoma | Causa 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 deemaily 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 responde409 Conflictcon un mensaje claro.PATCH /api/usuarios/:id/activateyDELETE /api/usuarios/:id: reciben el actor desdereq.user.idUsuarioy 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ámetrosearch(búsquedaILIKEsobre usuario, nombre y correo) con el mismo patrón UX-001 del resto del sistema.
Frontend — ccf-almacen-web
api/user.ts:updateUser/deleteUser/activateUserlanzan el error con el mensaje real del backend (helperextraerMensajeError, que además concatenaincumplimientosde la política de contraseñas). La búsqueda viaja como?search=engetAllUsers(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 (loscasecomparaban constantes en mayúsculas que no existen).user-form.tsx:telefonopasa a opcional.
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;eslintsobre los archivos tocados → 0 errores.ccf-almacen-web:npx tsc --noEmit→ 0 errores;eslintsobre 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.jslo documenta). Los specs deusuariosno se ven afectados: el mock defindOneconwhereen array ya devolvíanull, así que la validación de unicidad añadida no cambia su resultado.
Cómo validarlo en la aplicación
- Entra como Administrador al módulo «Usuarios».
- Buscar: escribe un nombre, usuario o correo y pulsa «Buscar» o Enter → la tabla se filtra.
- 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.
- Inactivar: pulsa el ícono
UserXde 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». - Auto-bloqueo: en tu propia fila, los íconos de inactivar y eliminar aparecen deshabilitados.
🔁 Ajustes posteriores (edición y columna Género)
| Síntoma | Causa | Arreglo |
|---|---|---|
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 storage | Deuda 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 áreas | Se 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 lista | La 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 completo | Se pintaba el valor crudo | Solo 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ítica | En 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:
| Archivo | Guardas | Efecto que tenían |
|---|---|---|
api/notification.ts | 13 | Contador de no leídas clavado en 0 + error en consola |
api/warehouse-reports.ts | 13 | Reportes sin datos |
api/presentation.ts | 12 | Catálogo de presentaciones vacío |
api/request.ts | 11 (9 return, 2 throw) | Crear/ cambiar estado de una solicitud lanzaba excepción |
api/log.ts | 5 | Auditoría sin registros |
api/inventory-movement.ts | 1 | Movimientos sin datos |
api/user.ts + api/office.ts | 7 + 9 | El 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/profilesigue accesible a cualquier usuario autenticado y permite enviarrolen 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.
