# Roles y permisos

Cómo se decide quién ve qué — los roles del sistema, las claves de permiso y por qué una pantalla puede aparecer vacía en lugar de negarse.

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.

:::tip[El dueño pasa por encima de todo]
El dueño del espacio de trabajo tiene el catálogo completo de claves siempre. Si
estás probando qué ve un rol, **no lo pruebes con la cuenta del dueño**: va a
poder todo pase lo que pase.
:::

## Dos gates distintos: módulo y permiso

Una sección aparece cuando pasa **las dos** puertas:

1. **El módulo está activo** en el espacio de trabajo (es lo contratado).
2. **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](/empezar/modulos/).

---

Índice completo del centro de ayuda: https://help.linkerestate.com/llms.txt