Invitaciones
Descripción
Las organizaciones pueden invitar a usuarios (no registrados) a unirse vía email. El usuario invitado recibe un correo con un enlace que lo lleva a una pantalla de registro para finalizar su alta en la plataforma y en la organización. Los usuarios solo se crean por invitación (salvo el primer usuario, creado en el registro de organización). Ver 07-usuarios.md y 08-registro.md.
Quién puede invitar
| Tipo de organización | A quién puede invitar |
|---|---|
| COMMON | Usuarios a su propia organización |
| SUPER_ADMIN | Usuarios a su propia organización o a otras organizaciones |
El template del email de invitación es el mismo en ambos casos.
Flujo de invitación
- La organización invita a un usuario (no registrado) vía email.
- El usuario recibe un email con un enlace que lo lleva a una pantalla de registro.
- El email queda fijado por la invitación (no lo elige el usuario).
- La organización asigna el rol que tendrá el usuario al invitarlo.
- El usuario debe completar los campos que la plataforma aún no tiene: nombre, apellidos, contraseña, etc.
- Al completar el registro, el usuario queda unido a la organización y finaliza su alta.
Completar el registro (usuarios invitados)
Los usuarios invitados deben completar los campos necesarios para finalizar su registro dentro de la plataforma y la organización.
Campos típicos: nombre, apellidos, contraseña (y cualquier otra información que no se haya proporcionado en la invitación).
Reglas de validación (comportamiento visible):
| Campo | Regla | Comportamiento si no se cumple |
|---|---|---|
| Obligatorio, formato email, único | Error 422 o 409 | |
| password | Obligatorio, 8–255 caracteres | Error 422 |
| first_name | Obligatorio, 1–255 caracteres | Error 422 |
| last_name | Obligatorio, 1–255 caracteres | Error 422 |
La contraseña se almacena de forma segura y el sistema no la devuelve.
Onboarding tras la invitación
Tras completar el registro, los usuarios invitados deben completar un onboarding que incluye:
- Explicación del sistema.
- Un test (si todavía no lo han realizado), cuyo resultado determina el E-Mode. Ver 05-modos-existenciales.md.
Sin completar el onboarding (y el test, si aplica), el usuario no puede avanzar.
Nivel por defecto
El usuario invitado recibe nivel 1 (NIVEL_1) por defecto. Ver 06-niveles.md.
Condiciones de negocio (resumen)
- La invitación es por email; el usuario completa el registro mediante un enlace.
- El email viene fijado por la invitación; el rol lo asigna la organización al invitar.
- Solo se invita a usuarios no registrados.
- Los usuarios invitados deben completar registro + onboarding.
- Nivel por defecto: 1.