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. Usá Ver para abrir el detalle de una persona.
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).
Pantalla Usuarios completa, con filtros, tabla y botón Crear usuario.
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.
- En la lista, ubicá a la persona (podés usar Buscar).
- En Acciones, hacé clic en Desactivar (o Activar). El cambio es inmediato.
- 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).
Ventana Crear usuario en la sección General, con los campos completos.
Cómo se usa (paso a paso)¶
- En Usuarios, hacé clic en Crear usuario.
- En General ("Datos personales del usuario."), completá Nombre, Apellido y Correo (obligatorios), y opcionalmente Correo secundario y Teléfono.
- Pasá a Equipos ("Elegí a qué equipos pertenece este usuario (al menos uno)."). Elegí un equipo en Elegí un equipo para agregar; se incorpora al seleccionarlo. Repetí para más equipos. Para sacar uno, Quitar.
- (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; se incorpora al seleccionarlo. - Hacé clic en Crear.
Sección Equipos del alta con uno o más equipos agregados y el contador visible.
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 usa formato internacional, sin espacios, paréntesis ni guiones; por ejemplo,
+541100000000. Si el guardado lo rechaza, revisá el código de país y el número. - 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.
Información del usuario DOCS, roles directos y equipos asignados.
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, Estado 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 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.
Permisos efectivos de una cuenta DOCS, con alcance Propio y el rol que los otorga.
Editar un usuario¶
Cómo se usa (paso a paso)¶
- En la lista, hacé clic en Ver sobre la persona.
- Hacé clic en Editar usuario (requiere
user:update). - Modificá Nombre, Apellido, Correo secundario o Teléfono. El correo principal no se puede cambiar.
- (Con
role:assign) En Roles directos: Agregar rol para sumar uno; Deshabilitar para quitar uno (queda tachado y podés Deshacer). - (Con
team:update-members) En Equipos: Agregar equipo para sumar uno; Deshabilitar para quitar uno (con Deshacer). - Hacé clic en Guardar (o Cancelar para descartar todo).
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.
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.