Saltar a contenido

Admin → Usuarios (/admin/users)

  • Permisos mínimos: AccessAdmin.USUARIOS_VIEW. Para editar, AccessAdmin.USUARIOS_EDIT. Para enviar invitaciones externas, AccessAdmin.SEND_EXTERNAL_INVITE.
  • APIs:
  • GET /api/admin/users
  • PATCH /api/admin/users
  • GET /api/admin/roles
  • GET /api/admin/centros_costos?size=1000
  • POST /api/auth/register_external_email

Objetivo

Administrar los usuarios del sistema: activar/desactivar cuentas, asignar roles, definir centros de costos autorizados y enviar invitaciones de registro.

Operativa

1. Listado y búsqueda

  1. Abre /admin/users. La tabla muestra datos básicos, estado, fechas clave, roles y centros de costos asignados.
  2. Usa la barra DSL para filtrar (ej. email~=eseasa.com, is_active=false, roles~=ingenieria).
  3. Configura columnas, orden y paginación según tus necesidades.

2. Editar un usuario existente

  1. Selecciona “Editar” en la fila deseada.
  2. En el modal puedes:
  3. Cambiar nombre, apellidos, correo y estado (Activo).
  4. Marcar/desmarcar roles (checkbox por rol).
  5. Seleccionar centros de costos autorizados (agrupados por proyecto).
  6. Guarda con “Guardar cambios” y espera el toast de confirmación.

3. Enviar invitación (usuario nuevo)

  1. Haz clic en “Invitar usuario”.
  2. Ingresa el correo electrónico.
  3. El sistema llama a POST /api/auth/register_external_email y envía el correo con instrucciones de registro. Se mostrará un toast confirmando.

4. Buenas prácticas

  • Mantén al menos un rol con permisos administrativos en cada área crítica.
  • Revoca los centros de costos que el usuario ya no debe operar; las dependencias backend (por ejemplo, filtros en Ingeniería) usan esta lista para autorizar consultas.
  • Cuando desactives un usuario (is_active=false), recuerda que no podrá iniciar sesión pero seguirá existiendo para auditoría.

Consejos adicionales

  • Usa la opción “Ver JSON” del menú contextual de la tabla para copiar la información completa y compartirla con soporte.
  • Si necesitas crear usuarios internos manualmente, hazlo desde /api/admin/users en la API o construye un flujo adicional; esta pantalla se centra en mantenimiento y no en altas directas.