# PLAN SPRINT 3 - E2E Tests

**Proyecto:** template-saas
**Sprint:** 3
**Objetivo:** Implementar tests E2E con Playwright para flujos críticos
**Fecha Inicio:** 2026-01-10
**SP Total:** 8

---

## RESUMEN EJECUTIVO

### Estado Actual
- **Tests Unitarios:** 776 tests (76.37% cobertura)
- **Tests E2E:** 0% - No configurado
- **Flujos Críticos:** Sin cobertura E2E

### Gap a Cerrar
Implementar suite de tests E2E para validar flujos completos de usuario:
1. Autenticación (login, registro, OAuth)
2. Onboarding wizard completo
3. Billing (suscripción, cambio de plan)
4. Gestión de equipo (invitaciones)
5. Features principales (storage, notifications)

---

## TAREAS DEL SPRINT

### E2E-001: Setup Playwright

**Agente:** QA-Agent
**SP:** 2
**Dependencia:** Ninguna

#### Entregables
```yaml
entregables:
  - apps/frontend/playwright.config.ts
  - apps/frontend/tests/e2e/fixtures/auth.fixture.ts
  - apps/frontend/tests/e2e/fixtures/tenant.fixture.ts
  - apps/frontend/tests/e2e/utils/helpers.ts
  - apps/frontend/package.json (actualizado con playwright)
```

#### Configuración Base
- Playwright con TypeScript
- Fixtures para autenticación
- Page Object Model setup
- CI/CD integration config

---

### E2E-002: Auth Flow Tests

**Agente:** QA-Agent
**SP:** 2
**Dependencia:** E2E-001

#### Entregables
```yaml
entregables:
  - apps/frontend/tests/e2e/auth/login.spec.ts
  - apps/frontend/tests/e2e/auth/register.spec.ts
  - apps/frontend/tests/e2e/auth/forgot-password.spec.ts
  - apps/frontend/tests/e2e/auth/oauth.spec.ts
```

#### Casos de Test
- Login exitoso con credenciales válidas
- Login fallido con credenciales inválidas
- Registro de nuevo usuario
- Flujo de recuperación de contraseña
- OAuth login (Google mock)
- Logout y limpieza de sesión

---

### E2E-003: Onboarding Flow Tests

**Agente:** QA-Agent
**SP:** 2
**Dependencia:** E2E-001

#### Entregables
```yaml
entregables:
  - apps/frontend/tests/e2e/onboarding/wizard.spec.ts
  - apps/frontend/tests/e2e/onboarding/company-step.spec.ts
  - apps/frontend/tests/e2e/onboarding/invite-step.spec.ts
  - apps/frontend/tests/e2e/onboarding/plan-step.spec.ts
```

#### Casos de Test
- Wizard completo de 4 pasos
- Navegación entre pasos
- Validación de campos obligatorios
- Skip de paso de invitaciones
- Selección de plan
- Completar onboarding

---

### E2E-004: Core Features Tests

**Agente:** QA-Agent
**SP:** 2
**Dependencia:** E2E-002

#### Entregables
```yaml
entregables:
  - apps/frontend/tests/e2e/dashboard/dashboard.spec.ts
  - apps/frontend/tests/e2e/billing/subscription.spec.ts
  - apps/frontend/tests/e2e/team/invitations.spec.ts
  - apps/frontend/tests/e2e/settings/profile.spec.ts
```

#### Casos de Test
- Dashboard carga correctamente
- Ver y cambiar suscripción
- Enviar invitación a equipo
- Actualizar perfil de usuario
- Ver notificaciones
- Gestión de archivos básica

---

## EJECUCIÓN DEL SPRINT

### Orden de Ejecución

```
E2E-001 (Setup)
    │
    ├── E2E-002 (Auth) ──► Paralelo
    │
    └── E2E-003 (Onboarding) ──► Paralelo
            │
            └── E2E-004 (Core Features)
```

### Comandos de Validación

```bash
# Instalar Playwright
cd apps/frontend && npm install -D @playwright/test

# Instalar browsers
npx playwright install

# Ejecutar tests E2E
npm run test:e2e

# Ejecutar con UI
npm run test:e2e:ui

# Generar reporte
npm run test:e2e:report
```

### Métricas de Éxito

| Métrica | Objetivo |
|---------|----------|
| Tests E2E nuevos | 20-25 |
| Flujos cubiertos | 6 críticos |
| Tiempo ejecución | < 5 min |
| Pass rate | 100% |

---

## ESTRUCTURA DE ARCHIVOS

```
apps/frontend/
├── playwright.config.ts
├── tests/
│   └── e2e/
│       ├── fixtures/
│       │   ├── auth.fixture.ts
│       │   └── tenant.fixture.ts
│       ├── utils/
│       │   └── helpers.ts
│       ├── auth/
│       │   ├── login.spec.ts
│       │   ├── register.spec.ts
│       │   └── ...
│       ├── onboarding/
│       │   └── wizard.spec.ts
│       ├── dashboard/
│       │   └── dashboard.spec.ts
│       └── billing/
│           └── subscription.spec.ts
```

---

**Creado:** 2026-01-10
**Sprint:** 3 de 5
**Estado:** COMPLETADO

---

## REPORTE DE EJECUCIÓN

**Fecha Finalización:** 2026-01-10

### Archivos Creados

| Archivo | Descripción |
|---------|-------------|
| `playwright.config.ts` | Configuración Playwright |
| `tests/e2e/fixtures/auth.fixture.ts` | Fixtures de autenticación |
| `tests/e2e/fixtures/tenant.fixture.ts` | Fixtures de tenant |
| `tests/e2e/utils/helpers.ts` | Utilidades de test |
| `tests/e2e/auth/login.spec.ts` | Tests de login (10 tests) |
| `tests/e2e/auth/register.spec.ts` | Tests de registro (7 tests) |
| `tests/e2e/onboarding/wizard.spec.ts` | Tests de onboarding (10 tests) |
| `tests/e2e/dashboard/dashboard.spec.ts` | Tests de dashboard (10 tests) |
| `tests/e2e/billing/subscription.spec.ts` | Tests de billing (10 tests) |

### Métricas

| Métrica | Resultado |
|---------|-----------|
| Tests E2E creados | 47 |
| Archivos de test | 5 |
| Fixtures | 2 |
| Flujos cubiertos | 5 (auth, register, onboarding, dashboard, billing) |