Ir al contenido
Español

Roles y permisos: cómo funcionan los accesos

Por quéEntender el modelo de accesos antes de repartir usuarios: de qué se compone «lo que ve un miembro del equipo».
Para quiénAl propietario que está montando su equipo.
Qué obtendrásEl esquema claro «rol (grupo de permisos) + alcance de categorías = acceso» y el manejo del editor del rol.
LimitacionesEl modelo funciona dentro de un solo alojamiento; la visibilidad del dinero no se puede estrechar por categorías — ambos límites se cuentan abajo con franqueza.

Antes de crear los usuarios del equipo conviene saber qué verá cada uno al entrar. El acceso se arma con dos partes independientes: el grupo de acceso responde a «qué se puede hacer», y el alcance por categorías de habitación, a «qué se ve». En este artículo: las dos partes, los tres roles del sistema y el editor de permisos.

Todos los accesos se gestionan en la sección «Accesos (RBAC)» del grupo «Sistema» del menú izquierdo. La página se llama «Administración de RBAC», y su subtítulo marca el marco de entrada: «Gestión de grupos de acceso, permisos y asignaciones de usuarios dentro del hotel actual.» Los accesos describen un alojamiento — no una red de alojamientos ni la empresa entera.

Dentro hay dos pestañas: «Grupos de acceso» y «Usuarios». Ellas guardan las dos partes del acceso:

  • El grupo de acceso es un conjunto de permisos por módulos: lo que se le permite hacer al miembro del equipo. Esto es aquí un «rol»; se configura en la pestaña «Grupos de acceso».
  • El alcance de categorías — qué categorías de habitación ve el miembro del equipo. No vive en el rol, sino en la ficha del usuario, en la pestaña «Usuarios».

Los roles están en una tabla con las columnas ID · Código · Nombre · Permisos · Tipo · Acciones («Editar») — se ve tanto el número de permisos como si el grupo es del sistema o tuyo propio.

De serie el sistema trae tres roles:

  • «Propietario» (owner) — los 39 permisos;
  • «Gerente» (manager) — un conjunto más corto que el del propietario; el detalle exacto se ve en el editor;
  • «Observador» (viewer) — el rol de solo lectura.

En la ficha del usuario el grupo aparece por su nombre con el código — «Propietario (owner)».

El contenido del rol se cambia en el editor «Edición del grupo de acceso»: los campos «* Código del rol», «* Nombre», «Descripción» y el bloque «Permisos». En un rol del sistema, sobre los campos hay una nota: «Rol del sistema: el código y el nombre no se pueden cambiar; solo se puede actualizar el conjunto de permisos.» El código y el nombre van en gris — solo se edita el conjunto de permisos. En tu grupo propio son editables todos los campos.

El grupo propio para tu equipo lo crea el botón «Nuevo grupo» — por ejemplo, «Recepción»: permisos para el «Planner» y las «Reservas», sin «Finanzas».

Los permisos del grupo están agrupados en 17 módulos: «Channel Manager», «Panel de control», «Finanzas», «Datos de huéspedes», «Huéspedes», «Mensajes», «Integraciones», «Reserva en línea», «Pagos», «Planner», «Tarifas», «Reservas», «Habitaciones», «Servicios», «Impuestos», «Plantillas», «Usuarios».

Cada permiso sigue un solo formato — «Módulo: acción — descripción»: en la línea se ve a qué módulo pertenece la acción y qué permite exactamente.

En la mayoría de los módulos los permisos van por parejas — ver y editar. Algunos módulos añaden acciones puntuales, y de tres conviene saber de antemano:

  • «Mensajes» — «envío» y «administración»;
  • «Usuarios» — «gestión», es decir, el permiso de configurar los usuarios y sus accesos;
  • «Huéspedes» — «Rellenar el formulario del huésped por él» y «Descifrar los datos personales del formulario del huésped»: los dos permisos van de los datos del pasaporte que trae el formulario del huésped, y conviene darlos de forma dirigida.

El bloque «Permisos» del editor es cómodo: tiene búsqueda por permisos, un contador «N/N» para cada módulo y los botones «Quitar todos» / «Seleccionar todos».

La visibilidad por categorías no va en el rol

Sección titulada «La visibilidad por categorías no va en el rol»

Buscar la visibilidad por categorías en el editor del rol no sirve — no está ahí. El principio del modelo: el rol gobierna las acciones, no «qué habitaciones se ven».

El corte por categorías se ajusta en la ficha del usuario: pestaña «Usuarios» → botón «Configurar accesos» → pantalla «Configuración de accesos del usuario». Además del nombre, el usuario, el «Alojamiento» y los «Grupos de acceso», incluye el bloque de alcance para el módulo «Habitaciones», con el campo «Modo de alcance»:

  • «Todas las categorías» — el consejo de debajo lo explica: «El usuario ve todas las categorías del alojamiento seleccionado.»
  • «Solo categorías seleccionadas» — solo se ve la lista de categorías marcadas.

El ejemplo clásico es la camarera de pisos: no necesita un rol aparte de «ve su planta». Basta cualquier rol y el modo «Solo categorías seleccionadas» con la lista de las categorías de su planta. El mismo mecanismo cierra el acceso del propietario de la unidad: la unidad del apartamento es una categoría, y un alcance de una sola categoría le deja al propietario su apartamento.

La regla de «el usuario ve solo su dinero» no funciona en el sistema — no la metas en tu esquema de accesos. Las finanzas solo se limitan por el permiso: con el permiso del módulo «Finanzas» se ve todo el movimiento de dinero del alojamiento; el dinero no tiene corte por categorías, y el alcance por categorías no le afecta.

Por eso las parejas del tipo «la camarera ve el dinero de su planta» o «el propietario de la unidad ve solo el pago de su apartamento» no se pueden montar: o el permiso de «Finanzas» — y el cuadro completo, o no hay permiso — y no hay dinero.

Quién cambió qué lo muestra el registro: «Registros» → «Registro de la aplicación» — «Consulta las acciones de trabajo, los eventos del sistema y los errores con filtros por fecha, usuario y entidad.»

Los accesos no son la excepción: crear un usuario deja el evento USER_CREATED, y cambiarle el acceso, USER_ACCESS_UPDATED. El camino rápido hasta ellos es el chip de filtro «Accesos». Para el propietario es la respuesta lista a la pregunta de «quién tocó los permisos de un miembro del equipo y cuándo».