Las cuentas del panel solo tienen dos estados: “pueden usarse” y “no pueden usarse”. Cuando el equipo crece, surgen problemas: personas que ya salieron aún pueden iniciar sesión, los vendedores pueden ver clientes de otros y solo una persona puede cambiar la configuración. Los permisos de X1 se diseñan en tres capas: los roles determinan qué se puede hacer, el alcance de datos determina de quién se pueden ver los datos y la sobrescritura individual gestiona las excepciones.

1. Solo hay un superadministrador
El primer administrador creado durante la instalación es el superadministrador; en todo el sitio siempre hay exactamente uno y no se puede desactivar ni eliminar. Existe para garantizar que siempre haya alguien que pueda cambiar la configuración y gestionar cuentas.
Para transferirlo, haz clic en «Transferir superadministrador» en otro administrador normal habilitado e introduce tu contraseña actual para confirmar. Tras la transferencia, tú pasas a ser administrador normal y la otra persona se convierte en el nuevo superadministrador: no es “añadir otro superadministrador”, sino “cambiar uno por otro”.
2. Las cuentas nuevas son administradores normales
En la página de gestión de administradores, basta con rellenar nombre de usuario, contraseña y confirmación de contraseña para crear una cuenta. La cuenta nueva puede iniciar sesión en el panel con normalidad, pero no puede abrir la página de gestión de administradores ni ejecutar las acciones de guardado correspondientes; al acceder a esa dirección se devuelve 403. Para que realmente pueda trabajar, hay que asignarle un rol y permisos.
3. Roles: determinan qué se puede hacer
Un rol es un conjunto de permisos. Los permisos se registran por módulo; por ejemplo, artículos, pedidos de la tienda, compras y caja tienen sus propios permisos. Los cuatro de la caja son típicos: pos.use para abrir tickets, pos.manage para gestionar dispositivos, pos.refund para reembolsar y pos.reprint para reimprimir recibos.
Al marcar permisos para un rol, se recomienda separarlos por puesto: atención al cliente solo recibe consulta de conversaciones y miembros; ventas, pedidos y leads; almacén, inventario y compras; finanzas, movimientos y conciliación. Conviene mantener el número de roles dentro del número de puestos; es más fácil de mantener que un conjunto por persona.

4. Alcance de datos: determina de quién se pueden ver los datos
En el rol también hay un «Alcance de datos»:
- Todo: puede ver los pedidos, miembros y leads de todo el sitio; adecuado para propietarios y finanzas;
- Solo propio: solo ve los datos cuyo comercial es él mismo; adecuado para ventas y atención al cliente.
Al elegir «Solo propio», las consultas de pedidos, miembros y leads añaden automáticamente la condición “comercial = cuenta actual”; la lista, la exportación y el detalle quedan sujetos al mismo conjunto de restricciones. No se trata de ocultar menús, sino de filtrar en la capa de datos. También se puede no restringir de forma global y conceder solo un permiso concreto de “ver solo clientes propios” (member.own), según la costumbre del equipo.
5. Sobrescritura individual: gestionar excepciones
Siempre hay alguien que necesita un permiso más que los demás, pero no merece la pena crear un rol para una sola persona. Estas excepciones se pueden sobrescribir en un administrador concreto: añadir o quitar un permiso sin afectar al resto de permisos de su rol. Cuando la persona se va, se elimina la sobrescritura y el rol no necesita cambios.
6. Desactivación, restablecimiento y transferencia
Los administradores normales se pueden desactivar: tras desactivarlos no pueden iniciar sesión y las sesiones ya iniciadas se invalidan de inmediato, sin esperar al tiempo de expiración. La contraseña restablecida debe tener al menos 8 caracteres; tras el restablecimiento, todas las sesiones de esa cuenta se invalidan y hay que iniciar sesión de nuevo con la nueva contraseña. El sistema no guarda la contraseña anterior y el restablecimiento no se puede deshacer. Todas estas operaciones se registran en el historial de cambios del panel y están protegidas por CSRF y límites de frecuencia.
7. Errores comunes
- Un administrador nuevo inicia sesión y no ve nada: sin rol no hay permisos; crea primero el rol y luego asígnalo.
- Ventas puede ver pedidos de otros: el alcance de datos del rol es «Todo»; cámbialo a «Solo propio».
- Tras una actualización, una cuenta antigua de repente queda restringida: las cuentas creadas antes de que existiera la función de roles tienen el rol vacío y el sistema mantiene el comportamiento permisivo anterior a la actualización; si hay que restringirlas, asígnale un rol explícitamente.
- Tras desactivar una cuenta se descubre que aún puede operar: la desactivación solo afecta a esa cuenta; si varias cuentas comparten acceso, hay que tratarlas una por una.
- Se quiere eliminar un administrador directamente: no hay eliminación, solo desactivación; esto sirve para conservar la auditoría y la atribución del historial.
Resumen
Recuerda las tres capas del diseño de permisos: los roles gestionan “qué se puede hacer”, el alcance de datos gestiona “de quién se puede ver” y la sobrescritura individual gestiona “las excepciones”. El superadministrador se mantiene único y es transferible; al salir, se desactiva en lugar de eliminarse, para que la auditoría tenga constancia.