Crear rol de ubicación
Crea un rol propio de Marea Gran Via con scope `location`, nombre, descripción opcional y permisos iniciales del catálogo habilitado para esa ubicación.
En este artículo
Esta guía explica cómo dar de alta un rol que pertenece a la ubicación activa `Marea Gran Via` dentro de `Grupo Marea Demo`.
El rol se crea primero y la lista de permisos se guarda después; por eso conviene revisar el resultado antes de asignarlo a personas usuarias.
Antes de empezar
- Sesión activa con `Grupo Marea Demo` y `Marea Gran Via` como contexto seleccionado.
- La cuenta tiene `permissions:manage` en la ubicación para ver `Crear rol`, seleccionar permisos y guardar el alta.
- El catálogo de permisos de la ubicación devuelve al menos un permiso seleccionable.
- El nombre del rol no está vacío, no es `owner` y no se repite en `Marea Gran Via`.
- Con solo `permissions:view`, la pantalla permite consultar roles y permisos, pero no crear un rol nuevo.
Instrucciones
- 1.
Abre roles de ubicación
En la gestión de accesos de `Marea Gran Via`, abre la pestaña `Roles de usuario`. La lista muestra búsqueda, filtro de scope, paginación y el botón `Crear rol` cuando tienes permiso de gestión.
- 2.
Inicia el alta
Pulsa `Crear rol`. El formulario se abre preparado para un rol de ubicación: el scope disponible es `Ubicación` y no permite crear roles de organización ni de sistema desde esta ruta.
- 3.
Nombra el rol
Escribe un nombre claro y único, por ejemplo `Responsable de sala Gran Via`. Añade una descripción si ayuda a explicar cuándo debe usarse ese acceso.
- 4.
Selecciona permisos
Marca uno o más permisos en la tabla. Puedes usar búsqueda o paginación; el formulario solo ofrece permisos compatibles con scope `location` y habilitados para el plan de `Marea Gran Via`.
- 5.
Crea el rol
Cuando el nombre y los permisos estén listos, pulsa `Crear rol`. La app crea el rol y después guarda la lista completa de permisos seleccionados para ese nuevo rol.
- 6.
Verifica el resultado
Tras el aviso `Rol creado`, vuelve al listado de `Roles de usuario` y confirma que el rol aparece en `Marea Gran Via`. Si necesitas validar permisos exactos, abre el detalle antes de asignarlo.
Validaciones y límites
- El botón `Crear rol` solo se habilita con nombre no vacío, al menos un permiso seleccionado, cambios pendientes y sin envío en curso.
- Sin `permissions:manage`, no hay acción operativa de creación ni selección de permisos.
- El backend fuerza scope `location` para esta ruta y rechaza cualquier otro scope.
- Los permisos visibles se filtran para la ubicación y no incluyen permisos de sistema ni permisos solo de organización.
- Los nombres vacíos, `owner` o repetidos en la misma ubicación se tratan como error de validación o conflicto.
- Crear el rol y asignar permisos son dos operaciones separadas; si falla la segunda, puede quedar un rol creado sin la lista prevista.
- Si falta organización o ubicación seleccionada, la pantalla muestra estado de no encontrado en lugar del formulario operativo.
Resultado esperado
El rol queda registrado con `scope='location'`, asociado a `Marea Gran Via`, y con la lista de permisos seleccionados guardada en `role_permissions`.