Skip to content

Gestion de Invitaciones

Esta guia explica como el personal de la organizacion invita usuarios y como revisar invitaciones pendientes.

Quien Puede Invitar

  • Administrador de organizacion: puede invitar OrganizationAdmin, Manager, Coach y Teacher.
  • Manager: solo puede invitar Coach y Teacher.

Control de Roles

Los limites de rol se validan en UI y backend. Aunque alguien modifique una solicitud manualmente, la API bloquea roles no permitidos.

Donde Encontrarlo

  1. Abre Usuarios en el area de administracion de tu organizacion.
  2. Haz clic en Invitar usuario.
  3. Agrega uno o varios correos.
  4. Selecciona el rol.
  5. Haz clic en Enviar invitacion.

Flujo de Invitacion

flowchart TD
    A[Org Admin o Manager abre Invitar usuario] --> B[Ingresa uno o varios correos]
    B --> C[Selecciona rol]
    C --> D[Envia invitacion]
    D --> E[Backend valida techo de rol]
    E --> F[Crea registro pendiente]
    F --> G[Envia correo con enlace]
    G --> H[Aparece en Invitaciones pendientes]
    H --> I[Usuario abre enlace]
    I --> J{El correo ya tiene cuenta?}
    J -- Si --> K[Mostrar Iniciar sesion inmediatamente]
    J -- No --> L[Usuario completa registro]
    K --> M[Usuario entra y revisa invitaciones pendientes]
    L --> M
    M --> N[Usuario acepta o rechaza manualmente]
    N -- Acepta --> O[Sistema asigna rol y organizacion]
    N -- Rechaza --> P[Invitacion cerrada sin asignacion]

Lista de Invitaciones Pendientes

La seccion Invitaciones pendientes aparece sobre la lista de usuarios y muestra:

  • correo invitado
  • rol objetivo de la invitacion
  • fecha de expiracion
flowchart LR
    A[Invitacion enviada] --> B[Estado: pending]
    B --> C[Visible en Invitaciones pendientes]
    C --> D{Usuario toma accion?}
    D -- Aceptar --> E[Se crea/actualiza membresia y rol]
    D -- Rechazar --> F[Estado revocado]
    D -- Sin accion --> G[Invitacion expira]

Registro con Invitacion

  • Si el correo del enlace ya tiene cuenta, la pantalla muestra Iniciar sesion de inmediato.
  • Si el correo no tiene cuenta, la pantalla muestra formulario de registro.
  • El registro no acepta la invitacion automaticamente.
  • Despues de iniciar sesion, la persona debe aceptar o rechazar manualmente en la pagina de invitaciones.

Invitaciones Multiples

El modal permite agregar varios destinatarios en una sola sesion.

  • Escribe un correo y haz clic en Agregar.
  • Repite para mas correos.
  • Se sugieren usuarios existentes al escribir.
  • Haz clic en Enviar invitacion para procesar todos los correos.

Exito Parcial

Si algunos correos fallan y otros no, la UI muestra un resumen con conteos.

Reenviar Invitaciones

  • En la lista de invitaciones pendientes existe la accion Reenviar invitacion por cada fila.
  • Reenviar crea un nuevo token y actualiza la expiracion de la invitacion pendiente.

Resolucion de Problemas

No puedo invitar OrganizationAdmin o Manager

  • Verifica tu rol. Un Manager solo puede invitar Coach/Teacher.

No veo la invitacion en pendientes

  • Actualiza la pantalla despues de enviar.
  • Verifica que estas en la organizacion correcta.
  • Confirma si ya fue aceptada o expiro.

El usuario dice que el enlace es invalido

  • La invitacion puede haber expirado o ya fue usada.
  • Envia una nueva invitacion.