Cómo crear un rol de organización
Crea en Grupo Marea Demo un rol propio, define si aplica a la organización o a ubicaciones, selecciona sus permisos iniciales y vuelve al listado con la creación confirmada.
En este artículo
Los roles de organización permiten controlar quién puede operar permisos y responsabilidades dentro de Grupo Marea Demo sin depender de roles de sistema.
Este flujo crea primero el rol y después guarda sus permisos iniciales. Desde la pantalla de organización puede quedar con scope `organization` o con scope `location` heredable por ubicaciones como Marea Gran Via y Marea Mercado.
Antes de empezar
- Sesión autenticada con Grupo Marea Demo seleccionada en el runtime es-ES.
- Permiso `permissions:view` en contexto de organización para cargar Roles de usuario y el catálogo de permisos.
- Permiso `permissions:manage` en contexto de organización para ver Crear rol, seleccionar permisos y guardar.
- Un nombre de rol que no exista ya en la organización.
Instrucciones
- 1.
Abre Roles de usuario
Entra en `organization/access?tab=roles`. La vista muestra los roles visibles, la búsqueda, el filtro Todos los scopes, la columna Propietario y el botón Crear rol cuando puedes administrar roles.
- 2.
Entra en Crear rol
Pulsa Crear rol para abrir `organization/access/roles/create?tab=roles`. El formulario empieza con Nombre y Descripción vacíos, scope Organización por defecto y el catálogo de permisos disponible.
- 3.
Define nombre y alcance
Escribe un nombre único y añade descripción si ayuda a reconocer el uso operativo. Mantén `organization` para un rol de organización o cambia a `location` para un rol de ubicación propiedad de Grupo Marea Demo.
- 4.
Selecciona permisos
Marca al menos un permiso compatible con el scope elegido. La búsqueda ayuda a localizar permisos por código o descripción, por ejemplo `brand:view`.
- 5.
Guarda y confirma
Pulsa Crear rol. La app crea el rol, guarda sus permisos iniciales, muestra Rol creado y vuelve a Roles de usuario con la lista actualizada.
Validaciones y límites
- Nombre es obligatorio después de quitar espacios al inicio y al final.
- La pantalla solo permite scope `organization` o `location`; no permite crear roles `system`.
- Crear rol permanece deshabilitado hasta que hay nombre, al menos un permiso seleccionado, cambios pendientes y ningún envío en curso.
- Al cambiar el scope, la pantalla recalcula los permisos visibles y retira de la selección los que ya no aplican.
- El catálogo de esta pantalla muestra permisos de organización y ubicación, excluyendo permisos `system`.
- La pantalla no precomprueba duplicados; si el nombre ya existe, la creación falla al guardar.
- Crear el rol y asignar permisos son dos operaciones separadas; si falla la asignación después de crear el rol, la pantalla muestra error pero no hace rollback.
- Crear el rol no asigna usuarios; las asignaciones se gestionan en otro flujo.
Resultado esperado
Queda creado un rol propio de Grupo Marea Demo con scope `organization` o `location`, asociado a sus permisos iniciales y visible de nuevo en Roles de usuario.