# US-MGN-001-006-001: Signup / Auto-Registro de Usuarios

**RF Asociado:** [RF-MGN-001-006](../../02-modelado/requerimientos-funcionales/mgn-001/RF-MGN-001-006-registro-usuarios.md)
**Módulo:** MGN-001 - Fundamentos
**Epic:** Autenticación y Seguridad
**Prioridad:** P1 (Post-MVP)
**Story Points:** 5
**Sprint:** Sprint 4
**Fecha:** 2025-11-24

---

## User Story

**Como** usuario nuevo,
**Quiero** registrarme en el sistema sin necesidad de que un administrador me cree la cuenta,
**Para** comenzar a usar el ERP rápidamente (modelo SaaS).

---

## Criterios de Aceptación

### Escenario 1: Registro exitoso
**Cuando** completo formulario signup con email, nombre, contraseña, nombre de empresa,
**Entonces** sistema crea tenant, empresa, usuario admin, envía email de verificación.

### Escenario 2: Email duplicado globalmente
**Cuando** intento registrarme con email ya usado en otro tenant,
**Entonces** retorna error "Email ya registrado".

### Escenario 3: Verificación de email
**Cuando** hago clic en enlace de verificación,
**Entonces** cuenta activada, puedo hacer login.

---

## Reglas de Negocio

- **RN-1:** Signup crea: tenant + empresa + usuario admin
- **RN-2:** Cuenta inicia con status='pending_verification'
- **RN-3:** Email de verificación expira en 24 horas
- **RN-4:** Plan inicial: Free Trial (30 días)

---

## Tareas Técnicas

- [ ] POST /api/v1/auth/signup - Registro
- [ ] POST /api/v1/auth/verify-email - Verificar email
- [ ] Crear tenant + schema + migrations
- [ ] Enviar email de verificación
- [ ] Tests

---

## Estimación: 5 SP

---

## Referencias

- [RF-MGN-001-006](../../02-modelado/requerimientos-funcionales/mgn-001/RF-MGN-001-006-registro-usuarios.md)
