Cómo eliminar un rol de personal
Elimina un rol de personal de la ubicación actual solo cuando no tiene empleados activos asignados. La acción queda protegida por permisos, por la ubicación seleccionada y por una confirmación explícita.
En este artículo
Los roles de personal ordenan el catálogo operativo de cada ubicación. En Marea Gran Via, por ejemplo, roles como `Sala` pueden estar vinculados a empleados activos y no deben retirarse mientras sigan en uso.
Antylogic permite borrar un rol libre de asignaciones desde la tabla de roles o desde su detalle, pero mantiene una protección final en backend para evitar eliminar un rol que todavía sostiene la operación del equipo.
Antes de empezar
- Sesión iniciada en Grupo Marea Demo con la ubicación Marea Gran Via seleccionada.
- Permiso de ubicación `staff-roles:manage`.
- El rol existe en la ubicación actual.
- El rol no tiene empleados activos asignados.
Instrucciones
- 1.
Abre roles de empleados
Entra en gestión de personal y selecciona `Roles de empleados`. La tabla muestra los roles disponibles para la ubicación y permite buscar por nombre.
- 2.
Comprueba las asignaciones
Antes de borrar, revisa si el rol aparece asociado a empleados activos. En el demo ES, `Sala` está asociado a personal de sala, por lo que debe conservarse hasta reasignar o archivar ese personal.
- 3.
Abre la eliminación
Si el rol está libre de empleados activos, usa `Eliminar` desde la fila de la tabla o entra en `location/staff/roles/detail/:roleId` y pulsa el botón destructivo al final del formulario.
- 4.
Confirma el borrado
En el modal `Eliminar rol`, pulsa `Eliminar` para confirmar o `Cancelar` para volver sin cambios. La acción se aplica a un único rol y no pide datos adicionales.
- 5.
Verifica el resultado
Cuando el borrado termina correctamente, la lista de roles se actualiza y aparece `Rol eliminado`. Si el rol sigue asignado, Antylogic conserva el rol y muestra `No se puede eliminar un rol asignado.`
Validaciones y límites
- `staff-roles:manage` es obligatorio para ver y ejecutar la acción de borrado; `staff-roles:view` solo permite consulta.
- La eliminación solo afecta al rol dentro de la ubicación seleccionada; un rol de otra ubicación se trata como no encontrado.
- No se puede borrar un rol con empleados activos asignados; primero hay que reasignar o archivar ese personal.
- No existe borrado masivo de roles ni `DELETE` sobre la colección `/staff-roles`.
- La confirmación no envía payload: el cliente llama a `DELETE /api/app/{orgId}/{locationId}/staff-roles/{roleId}` y espera `204 No Content` si se completa.
Resultado esperado
El catálogo de roles de Marea Gran Via queda limpio sin romper asignaciones activas: los roles libres se eliminan, los roles todavía asignados quedan protegidos y la interfaz informa el resultado con un aviso localizado.