Registro (alta de organización)
Descripción
El registro es el flujo por el cual una nueva organización se da de alta en la plataforma E-Training. Este flujo crea simultáneamente la organización y su primer usuario (contacto principal). Es independiente de invitaciones; únicamente alta de organización.
Caso de uso: Registrar organización
Actor: Persona que desea crear una organización en la plataforma (aún no registrada).
Objetivo: Dar de alta una nueva organización con su usuario contacto.
Precondiciones: Ninguna (ruta pública, sin autenticación).
Flujo principal:
- El actor envía los datos de la organización: nombre de la organización, slug (identificador fiscal) y datos del primer usuario: email, contraseña, nombre, apellidos.
- El sistema valida que el slug no exista y cumpla el formato fiscal.
- El sistema valida que el email no esté ya registrado.
- El sistema valida que todos los campos cumplan las reglas de validación.
- El sistema crea la organización (activa, tipo COMMON) y el usuario (rol administrador, nivel 1).
- El usuario creado queda como contacto principal de la organización.
- El sistema devuelve tokens de autenticación (login automático tras registro).
Resultado esperado: La organización queda registrada; el primer usuario queda creado, autenticado y como contacto principal.
Flujos alternativos:
- Slug ya existe: Error 409 (conflict).
- Email ya registrado: Error 409 (conflict).
- Datos inválidos: Error 422 con detalle de validación.
Datos del formulario
| Campo | Entidad | Obligatorio | Reglas |
|---|---|---|---|
| organization_name | Organización | Sí | - |
| slug | Organización | Sí | Único, formato fiscal (CUIT, CNPJ, RUT, EIN) |
| Usuario | Sí | Único, formato email | |
| password | Usuario | Sí | 8–255 caracteres |
| first_name | Usuario | Sí | 1–255 caracteres |
| last_name | Usuario | Sí | 1–255 caracteres |
Respuestas del sistema
- Éxito: Código 201 y cuerpo con tokens (misma estructura que login):
accessToken,refreshToken,expiresIn,tokenType. Login automático tras el registro. - Slug duplicado: Código 409 (conflict).
- Email duplicado: Código 409 (conflict).
- Validación: Código 422 con detalle de los campos que no cumplen las reglas.
Comportamiento posterior
El primer usuario debe completar el onboarding (explicación del sistema + test para E-Mode si aplica), igual que cualquier otro usuario. Ver 05-modos-existenciales.md y 07-usuarios.md.
Condiciones de negocio (resumen)
- El registro crea organización + primer usuario en una operación atómica (si falla la creación del usuario, la organización se revierte).
- La organización se crea activa y COMMON.
- El primer usuario se crea activo, con rol administrador, nivel 1 y como contacto principal.
- Respuesta: 201 + tokens (login automático).
- Ruta pública (sin autenticación).