Cómo editar un rol de personal
Actualiza el nombre, la descripción y el color de un rol de personal existente en Marea Gran Via sin cambiar empleados asignados ni roles de acceso.
En este artículo
Los roles de personal ayudan a ordenar el equipo de una ubicación y a reconocer cada función dentro de la interfaz.
Esta edición solo cambia la ficha del rol en la ubicación activa: no reasigna empleados, no modifica permisos de usuarios y no afecta a roles de acceso.
Antes de empezar
- Trabajar dentro de Grupo Marea Demo y la ubicación Marea Gran Via.
- Tener un rol de personal existente en la ubicación activa; en el demo ES se usa `STAFF_ROLE_DETAIL_ROLE_ID=c72e339b-28b7-4edf-8ac1-d45b4185aaaf`.
- Tener permiso `staff-roles:view` para abrir el detalle del rol.
- Tener permiso `staff-roles:manage` para editar y guardar cambios.
Instrucciones
- 1.
Abre la pestaña Roles
En gestión de personal, entra en la pestaña Roles. La tabla muestra los roles de la ubicación, su descripción, los empleados asociados y la acción disponible. En el demo ES puedes buscar `Sala`.
- 2.
Entra en la edición
Selecciona la fila del rol o pulsa Editar. Si el usuario solo puede consultar, la acción aparece como Ver y el formulario se abre en modo solo lectura.
- 3.
Actualiza los campos
Modifica Nombre, Descripción o Color. El color identifica visualmente el rol en la interfaz, pero esta acción no cambia empleados asignados ni permisos de acceso.
- 4.
Guarda los cambios
Pulsa Guardar cuando el botón esté habilitado. Tras una actualización correcta, la aplicación muestra Rol actualizado y vuelve a la pestaña Roles con la lista refrescada.
- 5.
Cancela si no quieres aplicar cambios
Pulsa Cancelar o vuelve desde el encabezado para regresar a la pestaña Roles sin enviar el guardado.
Validaciones y límites
- Nombre es obligatorio y se guarda sin espacios iniciales ni finales.
- Color es obligatorio desde la UI; los colores visibles son `gray`, `blue`, `indigo`, `purple`, `pink`, `orange`, `success`, `warning` y `error`.
- Guardar solo se habilita si hay cambios, el nombre no está vacío, hay color seleccionado, el formulario no es de solo lectura y no se está enviando.
- La edición usa `PUT /api/app/{orgId}/{locationId}/staff-roles/{roleId}`; no hay `PATCH` para edición parcial.
- Una descripción vacía se guarda como sin descripción.
- No se debe documentar que el nombre sea único, porque no hay validación explícita de duplicados en la acción revisada.
Resultado esperado
El rol queda actualizado en `staff_roles` para la ubicación activa, la lista y el detalle se refrescan, y los empleados asignados no cambian.