Roles y permisos

Configuración

Todo lo que la plataforma te deja hacer se decide con claves de permiso, no con tu cargo. Un rol es simplemente un paquete de claves al que le pusiste nombre.

Esto tiene una consecuencia práctica: puedes reconfigurar cualquier rol desde Configuración › Roles y permisos sin que nadie toque el código, y el cambio aplica en la misma pantalla y en la base de datos a la vez.

Los roles que vienen de fábrica

Rol	Para quién es
Administrador	Acceso completo al espacio de trabajo.
Gerente de ventas	Gestiona el equipo comercial, las ventas y las presentaciones.
Líder de equipo de ventas	Supervisa un equipo asignado: ventas, comisiones y reportes filtrados por ese equipo.
Agente inmobiliario	Vende. Asignable a la rotación de campañas; ve lo suyo.
Ejecutivo de ventas	Igual que el agente, pero sin ver la comisión de las propiedades ni subir propiedades propias.
Gerente de sucursal	Dirige una sucursal: ve las sucursales, sus personas, equipos, metas y ventas. Es el único rol que se puede nombrar gerente de una sucursal.
Formalizador de ventas	Supervisa todas las ventas desde reservada hasta formalizada, y recibe los avisos de cambio de etapa.
Gestor de inventario	Administra el inventario de propiedades y las presentaciones. Publica.
Editor de inventario	Igual que el gestor, pero no publica: manda a revisión.
Gerente de marketing	Campañas, distribución de prospectos y presentaciones.
Trafficker	Gestiona campañas y la distribución de prospectos.
Finanzas	Revisión financiera de las solicitudes de campaña.
Gerente de finanzas	Todo lo de Finanzas, más la segunda validación y el acceso a configuración.
Gestor de la academia	Dirige la academia: cursos, inscripciones, calificación de intentos y certificados. No alcanza ventas, negocios, propiedades ni comisiones.
Cliente	Acceso limitado, para un cliente o un agente externo.

Puedes renombrarlos, cambiarles las claves o crear roles nuevos. Una persona puede tener más de un rol: sus permisos se suman.

Cómo leer una clave de permiso

Las claves siguen una forma fija: dominio.recurso.acción y, cuando hace falta, un sufijo de alcance.

opportunities.deals.view      ver negocios (los que me tocan)
opportunities.deals.view_all  ver TODOS los negocios del espacio de trabajo
opportunities.deals.edit      editar un negocio
financial.commissions.manage  administrar el libro de comisiones
properties.edit_own           editar mis propios listados

El sufijo siempre amplía la clave base del mismo verbo: quien tiene view_all puede lo que puede quien tiene view, y más. Si una clave lleva _own, _team o _all, existe su hermana sin sufijo.

Por qué a veces una pantalla sale vacía

Es la parte que más confunde y conviene entenderla una sola vez.

Si no tienes la clave que abre la sección, la sección no existe para ti: no está en el menú y la dirección escrita a mano te devuelve al escritorio.
Si tienes la clave pero el alcance no te alcanza, la sección abre y sale vacía: no es un error, es que no hay filas tuyas ahí.

Cuando alguien reporta «no me aparece nada», la pregunta correcta es cuál de las dos está pasando. La primera se arregla dando la clave; la segunda, ampliando el alcance (view → view_team → view_all) o revisando a quién está asignado el registro.

Dos gates distintos: módulo y permiso

Una sección aparece cuando pasa las dos puertas:

El módulo está activo en el espacio de trabajo (es lo contratado).
Tu rol tiene la clave.

Apagar el módulo esconde la sección para todo el mundo, dueño incluido. Quitar la clave la esconde solo para quien no la tiene. Ver Módulos.