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, Coach y Teacher.
• Coach: por defecto no puede invitar a nadie. Un Administrador de Organizacion puede otorgarle, de forma individual, el permiso de invitar solo Teacher — ver Permisos de Usuario e Invitar Profesores.

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 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
• las acciones Reenviar invitacion y Cancelar invitacion por cada fila

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.

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.

Cancelar Invitaciones¶

• En la lista de invitaciones pendientes existe la accion Cancelar invitacion por cada fila.
• Antes de cancelar se pide confirmacion.
• Al cancelar, la invitacion deja de ser valida de inmediato: el enlace ya no permite registrarse ni unirse a la organizacion, y la fila desaparece de Invitaciones pendientes.
• Quien puede cancelar una invitacion es el mismo alcance que puede crearla: un OrganizationAdmin+ puede cancelar cualquier invitacion de su organizacion, y un Coach habilitado para invitar solo puede cancelar las invitaciones de Teacher que el mismo envio.

Resolucion de Problemas¶

No veo el rol Manager al invitar¶

• El rol Manager esta desactivado. Ya no aparece al invitar ni al cambiar el rol de un usuario, y una invitacion antigua para ese rol ya no puede aceptarse.

No puedo invitar OrganizationAdmin¶

• Verifica tu rol. Solo un Administrador de Organizacion (o superior) puede invitar a ese rol.

Como coach, no veo la opcion de invitar¶

• Este permiso no esta activo por defecto. Pide a tu Administrador de Organizacion que lo active para ti (ver Permisos de Usuario). Aunque lo tengas, solo puedes invitar el rol 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.