Actualizar rol de personal
Modifica el nombre, la descripción y el color de un rol operativo de personal de la ubicación activa, sin reasignar empleados ni cambiar otros datos del rol.
En este artículo
Esta guía cubre la edición de un rol operativo desde la pestaña Roles de empleados de la gestión de personal. En el contexto demo ES se usa Grupo Marea Demo, ubicación Marea Gran Via, y el rol Sala.
La actualización solo cambia metadatos del rol: nombre, descripción y color. El rol sigue asociado a la misma ubicación y las asignaciones de empleados permanecen intactas.
Antes de empezar
- Sesión iniciada con organización y ubicación activas en la app.
- Ubicación Marea Gran Via seleccionada en Grupo Marea Demo para el ejemplo ES.
- El rol existe en la ubicación seleccionada; para capturas ES se usa `STAFF_ROLE_DETAIL_ROLE_ID=c72e339b-28b7-4edf-8ac1-d45b4185aaaf` y `STAFF_ROLE_LIST_QUERY=Sala`.
- Tener `staff-roles:view` para abrir el detalle del rol.
- Tener `staff-roles:manage` para editar campos y guardar la actualización.
Instrucciones
- 1.
Abrir roles de personal
Entra en la gestión de personal de la ubicación y abre `location/staff?tab=roles`. La tabla de roles muestra nombre, descripción y empleados asociados para situar el rol antes de editarlo.
- 2.
Buscar y abrir el rol
Localiza el rol que quieres modificar. En la demo ES, filtra por Sala y abre la fila o la acción Editar para navegar al detalle con el `roleId` del rol.
- 3.
Editar los campos
Cambia el nombre, la descripción o el color. El nombre y el color son obligatorios; la descripción puede quedar vacía y se guardará sin valor efectivo.
- 4.
Guardar cambios
Pulsa Guardar. La app envía la actualización a `PUT /api/app/{orgId}/{locationId}/staff-roles/{roleId}` con el nombre recortado, la descripción recortada si tiene contenido y el color seleccionado.
- 5.
Confirmar el resultado
Cuando la actualización se completa, Antylogic muestra Rol actualizado, invalida lista y detalle del rol, y vuelve a la gestión de personal de la misma ubicación.
- 6.
Corregir incidencias
Si aparece un error, revisa permisos, ubicación activa, nombre y color. La pantalla permanece en el formulario para corregir el dato o cancelar sin aplicar cambios.
Validaciones y límites
- El detalle necesita `staff-roles:view`; la escritura necesita `staff-roles:manage`.
- Guardar permanece deshabilitado si el usuario no puede gestionar roles, si el nombre queda vacío, si no hay color seleccionado o si no hay cambios respecto a los valores iniciales.
- La actualización usa el `roleId` de la ruta; cualquier `id` enviado en el payload queda sobrescrito por el handler.
- El rol debe pertenecer a la ubicación activa; un rol de otra ubicación se trata como no encontrado.
- La UI limita el color a `gray`, `blue`, `indigo`, `purple`, `pink`, `orange`, `success`, `warning` y `error`. No hay evidencia de validación backend de formato de color ni de unicidad del nombre.
- La acción modifica solo nombre, descripción y color. No reasigna empleados, no modifica registros `staff`, no cambia `location_id` ni cambia `created_at`.
- La eliminación visible en el mismo detalle pertenece a `staff.roles.delete`, no a `staff.roles.update`.
Resultado esperado
El rol queda actualizado en `staff_roles` para la ubicación activa. La lista y el detalle se recargan, y las asignaciones de empleados permanecen intactas.