Saltar a contenido

Usuarios

Para qué sirve

Permite consultar la nómina de usuarios internos del sistema, darlos de alta, editar sus datos, activarlos o desactivarlos, y ver y modificar sus roles y equipos. En el detalle de cada persona también se ve la tabla de permisos efectivos, que resume qué puede hacer y por qué.

Quién puede usarla

Acción Permiso necesario
Ver la lista y el detalle Consultar usuarios (user:read)
Botón Crear usuario Crear usuarios (user:create)
Editar usuario y Activar/Desactivar Actualizar usuarios (user:update)
Asignar o quitar roles directos (al crear y al editar) Asignar roles (role:assign)
Asignar o quitar equipos en el detalle Actualizar integrantes de equipos (team:update-members)

Sin user:read ves el aviso "No tenés acceso a esta sección". Sobre lo que pasa cuando falta un permiso de asignación, ver la regla de asignación.

Dónde encontrarla

Menú lateral > Organización > Usuarios (/usuarios). El detalle de una persona está en /usuarios/{número}, al que se llega con el botón Ver.

La lista de usuarios

La pantalla muestra la descripción "Consultá la nómina de usuarios internos del sistema." y, arriba a la derecha, el botón Crear usuario (solo con permiso).

📷 IMAGEN PENDIENTE

Captura: pantalla Usuarios completa, con filtros, tabla y botón Crear usuario. Archivo sugerido: img/organizacion-usuarios-lista.png

Filtros

Filtro Qué hace
Buscar Busca por nombre, correo o teléfono. Se aplica solo, mientras escribís.
Estado Activo o Inactivo.
Área Muestra las personas que integran equipos de esa área.
Equipo Muestra las personas de ese equipo. La lista de equipos se acota al área elegida; si cambiás de área, el equipo se limpia.

Columnas

Columna Contenido
Nombre Nombre y apellido.
Correo Correo principal.
Teléfono Teléfono de contacto.
Estado Insignia Activo o Inactivo.
Última conexión Fecha del último ingreso (por ejemplo 29 sep 2026); "—" si nunca ingresó.
Acciones Botón Ver y botón Desactivar o Activar (este último solo con user:update).

Sobre la tabla se indica el rango mostrado ("1–15 de 42") y abajo hay paginación: Por página, Anterior, Siguiente y Página X de Y. Si no hay resultados ves "No se encontraron usuarios."; si falla la carga, "No se pudieron cargar los usuarios." o la alerta No se pudo actualizar el listado con el botón Reintentar.

Activar y desactivar

Desactivar a una persona le quita todos los permisos (a partir de su próxima sesión) e impide nuevos ingresos. No borra nada: sus roles y equipos se conservan, y al Activar de nuevo todo vuelve a valer.

  1. En la lista, ubicá a la persona (podés usar Buscar).
  2. En Acciones, hacé clic en Desactivar (o Activar). El cambio es inmediato.
  3. Aparece un aviso: "Usuario desactivado correctamente." o "Usuario activado correctamente.". Si falla: "No se pudo cambiar el estado del usuario.".

Crear un usuario

Se abre una ventana Crear usuario con un menú lateral de secciones: General, Equipos (con contador) y Roles (con contador; solo si tenés role:assign).

📷 IMAGEN PENDIENTE

Captura: ventana Crear usuario en la sección General, con los campos completos. Archivo sugerido: img/organizacion-usuarios-crear-general.png

Cómo se usa (paso a paso)

  1. En Usuarios, hacé clic en Crear usuario.
  2. En General ("Datos personales del usuario."), completá Nombre, Apellido y Correo (obligatorios), y opcionalmente Correo secundario y Teléfono.
  3. Pasá a Equipos ("Elegí a qué equipos pertenece este usuario (al menos uno)."). Elegí un equipo en Elegí un equipo para agregar y hacé clic en Agregar. Repetí para más equipos. Para sacar uno, Quitar.
  4. (Opcional, solo con role:assign) En Roles ("Elegí qué roles tiene este usuario asignados directo (opcional)."), elegí un rol en Elegí un rol para agregar y Agregar.
  5. Hacé clic en Crear.

📷 IMAGEN PENDIENTE

Captura: sección Equipos del alta con uno o más equipos agregados y el contador visible. Archivo sugerido: img/organizacion-usuarios-crear-equipos.png

Reglas y validaciones

El botón Crear se habilita solo cuando:

  • Nombre, Apellido y Correo están completos, y el correo tiene formato válido.
  • Correo secundario está vacío o es válido.
  • Teléfono está vacío o es válido (números, espacios, paréntesis y guiones, entre 6 y 20 caracteres; puede empezar con +).
  • Hay al menos un equipo agregado.

Los campos inválidos se marcan en rojo. Otras reglas:

  • El correo no se puede repetir: si ya existe otro usuario con ese correo, el sistema lo rechaza y muestra el mensaje que devuelve.
  • Solo se ofrecen equipos activos. En Roles se ofrecen los roles activos de alcance Propio o Global (los de alcance Equipo se asignan a equipos, no a personas).
  • Al crear, el usuario nace activo.
  • Sin role:assign, la sección Roles no aparece y no se asigna ningún rol.

Mensajes: "Usuario creado correctamente." (la ventana se cierra y la lista se actualiza) o "No se pudo crear el usuario." (u otro mensaje del sistema).

Detalle de un usuario

Hacé clic en Ver para abrir la pantalla Detalle de usuario ("Datos personales, roles y equipos asignados."). Muestra cuatro tarjetas.

📷 IMAGEN PENDIENTE

Captura: Detalle de usuario completo, mostrando las cuatro tarjetas. Archivo sugerido: img/organizacion-usuarios-detalle.png

Información del usuario

Nombre, Apellido, Correo, Correo secundario, Teléfono, Tipo de usuario, Creado, Creado por, Última actualización, Actualizado por y Última conexión. Los datos vacíos se muestran como "—".

Roles directos

Son los roles asignados directamente a la persona (alcance Global o Propio). Un resumen indica "{n} vigentes · {n} sin efecto". La tabla tiene las columnas Rol, Alcance, Área, Estado, Permisos y Acciones.

  • La insignia Vigente indica que el rol está activo y otorga permisos.
  • La insignia Rol inactivo indica que el rol está desactivado y no otorga permisos efectivos ("Rol inactivo: no otorga permisos efectivos."). Con Ver asignaciones a roles inactivos se muestran esas asignaciones.
  • Ver rol abre el detalle del rol. Si no tiene ninguno: "No tiene roles asignados directamente.".

Equipos

Los equipos a los que pertenece. Resumen "{n} activos · {n} inactivos"; columnas Equipo, Área, Estado, Permisos y Acciones. Las insignias Equipo inactivo y Área inactiva avisan que ese equipo no está aportando permisos. Ver equipo abre el detalle. Si no pertenece a ninguno: "No pertenece a ningún equipo.".

Permisos efectivos

La lista de todo lo que la persona puede hacer, con las columnas Permiso, Alcance (Global, Propio, Área o Equipo), Área y Otorgado por (el rol o equipo que lo concede). La insignia Permiso inactivo marca permisos que el sistema ya no usa. Si no tiene ninguno: "No tiene permisos efectivos.".

Para diagnosticar accesos

Si alguien dice "no puedo entrar a tal pantalla", revisá esta tabla: si el permiso no aparece, no lo recibe de ningún rol vigente; si aparece, la columna Otorgado por te dice de dónde viene.

Editar un usuario

Cómo se usa (paso a paso)

  1. En la lista, hacé clic en Ver sobre la persona.
  2. Hacé clic en Editar usuario (requiere user:update).
  3. Modificá Nombre, Apellido, Correo secundario o Teléfono. El correo principal no se puede cambiar.
  4. (Con role:assign) En Roles directos: Agregar rol para sumar uno; Deshabilitar para quitar uno (queda tachado y podés Deshacer).
  5. (Con team:update-members) En Equipos: Agregar equipo para sumar uno; Deshabilitar para quitar uno (con Deshacer).
  6. Hacé clic en Guardar (o Cancelar para descartar todo).

📷 IMAGEN PENDIENTE

Captura: detalle de usuario en modo edición, con un rol deshabilitado (tachado), un equipo agregado con la marca Nuevo y los botones Cancelar y Guardar. Archivo sugerido: img/organizacion-usuarios-editar.png

Reglas y validaciones

  • Guardar se deshabilita si Nombre o Apellido están vacíos, o si Correo secundario o Teléfono son inválidos.
  • Los roles y equipos que agregás o quitás se aplican recién al Guardar. Los elementos nuevos llevan la marca Nuevo (con Quitar rol agregado / Quitar equipo agregado para arrepentirte).
  • Solo se valida que sean activos los roles y equipos nuevos: los que ya tenía la persona se conservan aunque después se hayan desactivado.
  • Los roles de alcance Equipo no se pueden asignar directamente a una persona.
  • La foto de perfil no se cambia desde acá: cada persona la cambia en Mi perfil.

Importante

Si no tenés role:assign o team:update-members, esos botones no se ofrecen; y si de todos modos el cambio llegara sin el permiso, esa parte se ignora sin avisar y se conserva lo anterior. Ver la regla de asignación.

Mensajes: "Usuario actualizado correctamente." o "No se pudieron guardar los cambios." (u otro mensaje del sistema).

Casos de error frecuentes

Lo que ves Qué significa Qué hacer
No tenés acceso a esta sección No tenés user:read. Pedí el permiso a una persona administradora.
Crear deshabilitado Falta un dato obligatorio, hay un formato inválido o no agregaste ningún equipo. Revisá los campos en rojo y la sección Equipos.
Rechazo por correo repetido al crear Ya existe un usuario con ese correo. Buscalo en la lista; si está Inactivo, reactivalo.
Guardé roles/equipos y no cambió nada Falta el permiso de asignación (se ignora sin error). Verificá role:assign / team:update-members.
Los permisos de la persona no cambiaron Los cambios se aplican al renovar la sesión. Esperar o que la persona vuelva a ingresar.
"No se pudo cambiar el estado del usuario." Falló la activación/desactivación. Reintentá; si persiste, avisá a soporte.

Lo que no se puede hacer

No existe la eliminación de usuarios (solo desactivarlos), ni el cambio del correo principal desde la pantalla, ni el alta de usuarios externos.

Ver también