> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.pgecom.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 09- Gestión de Equipos e Inquilinos

# Gestión de Equipos e Inquilinos

La plataforma usa un sistema multi-inquilino donde cada usuario pertenece a uno o más equipos (inquilinos). Esta guía explica cómo gestionar sus equipos.

---

## Comprender Inquilinos

Un **inquilino** es una organización, equipo o espacio de trabajo en la plataforma.

- Cada usuario pertenece al menos a un inquilino.
- Cuando se registra, se crea automáticamente un **inquilino predeterminado** para usted.
- Todas sus operaciones, ofertas y datos de billetera están **limitados a su inquilino actual**.
- Puede pertenecer a **múltiples inquilinos** — por ejemplo, una cuenta personal y una cuenta de negocios.
- Cada inquilino tiene sus propios **miembros, roles y datos**.

---

## Cambiar Entre Inquilinos

1. Mire en la **parte superior de la barra lateral** el menú desplegable de inquilino.
2. Haga clic en el menú desplegable para ver todos los inquilinos a los que pertenece. Su inquilino activo está resaltado.
3. Seleccione un inquilino diferente.
4. El panel de control se actualiza inmediatamente para mostrar los datos de ese inquilino.

> **Consejo**: Su inquilino seleccionado se recuerda. Cuando inicie sesión nuevamente, volverá al último inquilino que estaba viendo.

---

## Invitar Miembros del Equipo

Para agregar a alguien a su equipo:

1. Vaya a **Panel de Control > Configuración > pestaña Equipo** (o **Panel de Control > Equipo**).
2. Haga clic en **Invitar Miembro**.
3. Complete el formulario de invitación:
   - **Correo Electrónico** (obligatorio) — La dirección de correo electrónico de la persona
   - **Nombre** (opcional) — Su nombre para mostrar
   - **Rol** — Seleccione un rol (vea las descripciones de rol más abajo). Cada rol incluye una breve descripción de sus capacidades.
4. Haga clic en **Enviar Invitación**.

La invitación se envía y aparece en la tabla de **Invitaciones Pendientes** con el correo electrónico del invitado, nombre, rol asignado y fecha de expiración.

### Lo Que Ve la Persona Invitada

- **Si ya tiene una cuenta**: Puede aceptar la invitación y el inquilino aparece en su menú desplegable.
- **Si es nuevo**: Se le dirige a la página de registro (`/signup?invite=TOKEN&tenant=ID`) con su correo electrónico prellenado. Después de registrarse, se unen automáticamente a su equipo con el rol asignado.

---

## Invitaciones Pendientes

La página del equipo muestra una sección de **Invitaciones Pendientes** con:

| Columna | Descripción |
|---------|-------------|
| **Correo Electrónico** | La dirección de correo electrónico del invitado |
| **Nombre** | El nombre del invitado (si se proporcionó) |
| **Rol** | El rol asignado (mostrado como insignia) |
| **Expiración** | Cuándo expira la invitación |

Las invitaciones que aún no se han aceptado aparecen aquí hasta que expiren o sean aceptadas.

---

## Miembros Activos

La página del equipo muestra una tabla de **Miembros Activos** con:

| Columna | Descripción |
|---------|-------------|
| **Nombre** | Nombre para mostrar del miembro |
| **Correo Electrónico** | Dirección de correo electrónico del miembro |
| **Rol** | Rol actual (mostrado como insignia) |
| **Unido** | Cuándo se unieron al equipo |
| **Acciones** | Acciones de gestión disponibles |

---

## Descripciones de Roles

Cada miembro del equipo tiene un rol que determina lo que puede hacer. Los roles son jerárquicos (nivel 1–5):

### Propietario (Nivel 5)

- **Acceso completo** a todo.
- Puede gestionar miembros del equipo, roles y configuraciones.
- Puede ver todas las operaciones y ofertas en el inquilino.
- Puede eliminar el inquilino.
- Típicamente hay un propietario por inquilino.

### Administrador (Nivel 4)

- Puede gestionar operaciones, disputas y usuarios.
- Puede ver **todas** las operaciones en el inquilino (no solo las suyas).
- Puede invitar y eliminar miembros (excepto el propietario).
- Puede gestionar configuraciones e integraciones.
- No puede eliminar el inquilino ni cambiar al propietario.

### Gerente (Nivel 3)

- Puede ejecutar y gestionar operaciones.
- Puede ver **todas** las operaciones en el inquilino.
- Puede crear y gestionar ofertas.
- Puede manejar disputas.
- No puede gestionar miembros del equipo.

### Miembro (Nivel 2)

- Puede crear ofertas y negociar.
- Solo puede ver **sus propias** operaciones y ofertas.
- Nivel de acceso estándar para la mayoría de los miembros del equipo.

### Observador (Nivel 1)

- Acceso **de solo lectura**.
- Puede ver todas las operaciones en el inquilino pero **no puede tomar ninguna acción**.
- Los botones de acción de operación están deshabilitados.
- El chat es de solo lectura.
- Los depósitos y retiros de billetera están ocultos.
- Útil para propósitos de monitoreo o auditoría.

---

## Resumen de Permisos

| Capacidad | Propietario | Administrador | Gerente | Miembro | Observador |
|-----------|-------------|---------------|---------|---------|-----------|
| Crear ofertas | Sí | Sí | Sí | Sí | No |
| Realizar operaciones | Sí | Sí | Sí | Sí | No |
| Ver operaciones propias | Sí | Sí | Sí | Sí | Sí |
| Ver todas las operaciones del inquilino | Sí | Sí | Sí | No | Sí |
| Gestionar miembros del equipo | Sí | Sí | No | No | No |
| Cambiar roles | Sí | No | No | No | No |
| Chatear en operaciones | Sí | Sí | Sí | Sí | No (solo lectura) |
| Gestionar configuraciones | Sí | Sí | No | No | No |
| Gestionar integraciones | Sí | Sí | No | No | No |
| Eliminar inquilino | Sí | No | No | No | No |

---

## Permisos Personalizados

Más allá del rol base, puede establecer **anulaciones de permisos personalizados** para miembros individuales:

1. Vaya a **Panel de Control > Configuración > pestaña Equipo**.
2. Encuentre el miembro y haga clic en **Editar Permisos** en su menú desplegable de Acciones.
3. El diálogo **Editar Permisos de Miembro** muestra una matriz de recursos y acciones:

| Recurso | Acciones Disponibles |
|---------|---------------------|
| **Inquilino** | Leer, Actualizar, Eliminar |
| **Integraciones** | Leer, Crear, Actualizar, Eliminar |
| **Ofertas de Intercambio** | Leer, Crear, Actualizar, Eliminar |
| **Operaciones** | Leer, Crear, Actualizar, Eliminar |
| **Billetera** | Leer, Crear, Actualizar, Eliminar |
| **Equipo** | Leer, Crear, Actualizar, Eliminar |
| **Configuración** | Leer, Actualizar |
| **Informes** | Leer |

4. Otorgue o revoque permisos específicos además del rol base del miembro.
5. Haga clic en **Guardar** para aplicar los cambios.

Esto le permite ajustar finamente el acceso — por ejemplo, dar a un rol de Miembro la capacidad de ver informes, o evitar que un Gerente modifique configuraciones.

---

## Asignar y Cambiar Roles

Los propietarios y administradores pueden cambiar roles de miembros (para miembros por debajo de su propio nivel):

1. Vaya a **Panel de Control > Configuración > pestaña Equipo**.
2. Encuentre el miembro cuyo rol desea cambiar.
3. Haga clic en su menú desplegable de **Acciones**.
4. Seleccione **Cambiar a [rol]** — se muestran las opciones de rol disponibles según su nivel de permiso.
5. Los permisos del miembro se actualizan inmediatamente.

---

## Eliminar Miembros del Equipo

Los propietarios y administradores pueden eliminar miembros del equipo:

1. Vaya a **Panel de Control > Configuración > pestaña Equipo**.
2. Encuentre el miembro que desea eliminar.
3. Haga clic en **Eliminar del equipo** en su menú desplegable de Acciones.
4. Confirme la eliminación.

Una vez eliminado:
- El miembro pierde acceso a los datos del inquilino.
- Sus datos personales y otras membresías de inquilino no se ven afectados.
- Pueden ser reinvitados más tarde si es necesario.

> **Advertencia**: Eliminar un miembro no cancela sus operaciones activas. Complete o resuelva cualquier operación abierta antes de eliminar a alguien.
