Manual de uso · Configuración

Paso a paso

Crear un perfil de permisos personalizado

Configuración → Perfiles de Usuario deja añadir una entrada nueva al catálogo de roles de Marko: un nombre, una clave, un ícono y un color que después se pueden marcar como casilla para cualquier persona desde Cuentas → Administrar roles. Este manual recorre crearla, editarla, ver dónde aparece después y borrarla — y, sobre todo, qué no hace por sí sola: nada de lo que vas a leer aquí reparte permisos nuevos.

Los pasos

Parte 1 · Entrar a la pantalla

1. Abre Configuración en el menú lateral y pulsa la pestaña Perfiles de Usuario, marcada en rojo con un candado, casi al final de la fila de pestañas.

   

   Qué deberías verLa cabecera Perfiles De Usuario con una tabla de cinco columnas —Ícono, Nombre, Clave, Descripción y Acciones— y nueve filas ya cargadas: Administrador, Bodeguero, Bodeguero Avanzado, Ejecutivo Avanzado, Ejecutivo de ventas, Facturador, Gerente Financiero, Rendición de gastos y Repartidor. Arriba a la derecha, el botón azul + Nuevo Perfil.
   Estas nueve filas no son un ejemplo, son el catálogo realSon exactamente los mismos nueve roles que ves marcados como casillas en Cuentas → Administrar roles: esta pantalla es de donde salen sus nombres, sus descripciones y sus colores.

Parte 2 · Crear el perfil

2. Pulsa + Nuevo Perfil.

   

   Qué deberías verUna ventana titulada Nuevo Perfil de Usuario con cinco campos: Nombre, Clave, Descripción, Ícono —un desplegable con 15 opciones, de Usuario a Finanzas— y Color. Un único botón para confirmar, rotulado OK.

   No hay botón CancelarPara cerrar sin crear nada, pulsa Esc o haz clic fuera de la ventana: no hay un botón visible para eso, ni aquí ni en Editar.

3. Escribe el Nombre y la Clave —en mayúsculas y con guion bajo, por ejemplo SUPERVISOR_TERRENO— y ajusta Descripción, Ícono y Color si quieres. Pulsa OK.

   

   Qué deberías verLos campos con lo que escribiste. Al pulsar OK con un Nombre y una Clave válidos, la ventana se cierra y sale el aviso verde Perfil creado correctamente.
   La Clave sólo acepta mayúsculas y guion bajoSi escribes algo que no cumple el patrón ^[A-Z_]+$ —una minúscula, un número, un espacio, un acento— sale el aviso rojo «La clave debe estar en mayúsculas y usar guiones bajos» y no se crea nada. Tampoco se crea si dejas Nombre o Clave vacíos («El nombre y la clave son requeridos»), ni si ya existe un perfil con ese mismo nombre o esa misma clave («Ya existe un perfil con ese nombre o clave»).

4. Búscalo en la tabla.

   

   Qué deberías verUna fila nueva, ordenada alfabéticamente por nombre entre las demás. En el ejemplo, Prueba Manual MRKO-375 con la etiqueta negra PERFIL_PRUEBA_MANUAL, su descripción y las mismas acciones que las filas del sistema.

Parte 3 · Editarlo si hace falta

5. Pulsa el botón de tres puntos ⋮ al final de su fila.

   

   Qué deberías verUn menú con dos opciones: Editar y Eliminar. Es el mismo menú en todas las filas, incluidas las nueve del sistema.

6. Pulsa Editar para corregir el nombre, la clave, la descripción, el ícono o el color.

   

   Qué deberías verLa ventana Editar Perfil de Usuario, igual a la de crear pero con los cinco campos ya rellenos. Al confirmar con OK sale Perfil actualizado correctamente; las mismas reglas de la Clave y de nombre/clave únicos del paso 3 aplican aquí también.

Parte 4 · Dónde aparece después

7. Ve a la pestaña Cuentas, abre Administrar roles sobre cualquier persona de cualquier empresa, y busca tu perfil nuevo en el bloque PLATAFORMA.

   

   Qué deberías verEl perfil nuevo como una casilla más, con el mismo formato que Administrador, Facturador o Gerente Financiero: nombre en negrita y la descripción debajo. En el ejemplo, Prueba Manual MRKO-375 sale junto a Facturador, sin marcar.
   Marcar esta casilla no le da a nadie ningún permiso nuevoEsta pantalla sólo agrega el nombre a la lista de casillas; no crea código detrás de él. Qué puede ver cada persona en Marko lo deciden listas fijas de roles escritas en el código de la aplicación —MANAGER, EXECUTIVE, BILLER…— y una clave inventada como PERFIL_PRUEBA_MANUAL no coincide con ninguna de ellas. Marcarla y guardar no oculta ni muestra ninguna pantalla nueva. Sigue leyendo en «Lo que todavía no hace» antes de usar esto para nada importante.

Parte 5 · Borrarlo

8. De vuelta en Perfiles de Usuario, abre el menú ⋮ de la fila y pulsa Eliminar. Confirma con Sí, eliminar.

   

   Qué deberías verUna ventana de confirmación: «¿Está seguro? Se eliminará el perfil "Prueba Manual MRKO-375"», con los botones Sí, eliminar y Cancelar. Al confirmar, aviso verde Perfil eliminado correctamente.
   Eliminar no borra el registro, lo apagaEl botón hace, por dentro, un update a isActive: false; el documento sigue existiendo en la base de datos. La pantalla simplemente deja de listarlo y ya no aparece como casilla en Cuentas. Es la misma treta de «borrado» que usan otras pantallas de Marko con soft delete.

9. Confirma que desapareció.

   

   Qué deberías verLa tabla de vuelta a las nueve filas originales del sistema, sin el perfil de prueba.

Quién entra de verdad

La pestaña se llama «Perfiles de Usuario» y vive dentro de Configuración, así que es fácil suponer que cualquier Administrador de tu empresa puede abrirla. No es así, y vale la pena entender por qué.

Lo que todavía no hace

• No otorga ningún permiso real. Crear un perfil aquí sólo agrega un nombre, una clave, un ícono y un color a una lista. Qué pantallas ve cada persona lo deciden listas fijas de roles escritas en el código —en el menú, en las rutas y en las funciones del servidor—, y una clave inventada no coincide con ninguna de ellas por más que suene a un puesto real.
• Asignar sólo un perfil personalizado no restringe nada: da el menú por defecto. Cuando a una persona no le queda marcado ningún rol que la aplicación reconozca, se comporta como un Ejecutivo de ventas normal y ve el menú comercial completo. No hay «acceso en blanco» ni un menú a medida para la clave nueva.
• 🔴 Puede romper la pantalla de perfil de esa persona. Si le asignas a alguien únicamente un perfil personalizado y esa persona abre su propio Perfil (/profile), la pantalla se cae. El pipe que traduce el rol a texto legible (UserProfilePipe) usa una lista fija de nueve claves y no comprueba si la que recibe está en ella: revienta con un error si no lo está. Verificado leyendo el código, no en vivo — hacerlo habría exigido asignar el perfil a una cuenta de QA que usan otros manuales.
• No es el catálogo de tu empresa, es el de toda la plataforma. El perfil que crees aquí no queda guardado dentro de tu empresa: entra a una colección compartida por Marko entero. Cualquier otra empresa de la plataforma podría, en teoría, ver y asignar el mismo perfil que acabas de crear.
• Eliminar no borra, desactiva. El registro sigue existiendo; sólo deja de listarse. No hay manera de volver a activarlo desde esta pantalla si te arrepientes: hay que crearlo de nuevo.
• No hay botón Cancelar en los formularios. Ni al crear ni al editar. La única forma de salir sin guardar es Esc o un clic fuera de la ventana.
• El botón de confirmar dice «OK», no «Crear» ni «Guardar». Es fácil no verlo la primera vez porque no dice lo que hace.
• Esta misma pantalla no vuelve a comprobar tu rol una vez cargada. Que el menú no te muestre la pestaña no es lo mismo que la pantalla esté bloqueada por dentro. No lo tomes como un atajo: si algún día llegas a ella sin ser administrador de plataforma, es un agujero de seguridad, no una función a tu disposición — repórtalo en vez de usarlo.

Para consultar después

Cuando algo no sale