Issue 3.5.3 — Tests E2E (Flujo completo del CV)

[Azfe]

Issue 3.5.3 — Tests E2E (Flujo completo del CV)

🎯 Objetivo

Validar el flujo completo del sistema, desde la API hasta la base de datos, asegurando que todas las capas funcionan juntas sin errores.

📦 Alcance

Incluye:

• Pruebas E2E del flujo completo del CV.
• Validación de interacciones reales entre API → Use Cases → Repositorios → MongoDB.
• Validación del flujo de creación de recursos y agregación final.
• Validación del endpoint de generación del PDF.

No incluye:

• Tests de frontend.
• Tests unitarios o de integración aislados.

🛠️ Tareas

• Configurar entorno E2E con Docker (API + MongoDB).
• Crear dataset inicial para pruebas.
• Implementar flujo E2E del CV:
  • Crear perfil.
  • Añadir experiencias.
  • Añadir skills.
  • Añadir educación.
  • Añadir certificaciones.
  • Obtener CV completo.
• Validar consistencia de datos en MongoDB.
• Validar que el flujo no rompe reglas de negocio.
• Añadir test E2E para generación del PDF (status 200 + bytes).
• Generar reporte de cobertura E2E.

🧪 Criterios de aceptación

• El flujo completo del CV funciona sin errores.
• Todos los recursos se crean, consultan y agregan correctamente.
• El CV completo se genera con todos los datos agregados.
• El endpoint /cv/download devuelve un PDF válido.
• No existen errores de integración entre capas.
• Cobertura E2E mínima definida (ej. >70%).

🌿 Branch

feature/issue-129-tests-e2e

[Azfe]

Plan: Tests E2E — Flujo completo del CV

Context

Los routers ya están conectados a use cases y repositorios vía DI (Depends()). Los tests unitarios e integración pasan. Ahora necesitamos tests E2E que validen el flujo completo sin mocks: API → Use Cases → Repositories → MongoDB real.

Infraestructura existente:

• tests/e2e/ existe con __init__.py y un placeholder test_complete_cv_flow.py
• El marker e2e está registrado en pyproject.toml y pytest.ini
• CI ya tiene un job e2e-tests en .github/workflows/tests.yml (MongoDB service incluido)
• El client fixture en tests/conftest.py conecta a MongoDB real cuando MONGODB_URL está seteada
  El test_db fixture limpia la BD antes/después de cada test

Limitación del GetCompleteCVUseCase: Solo agrega profile, experiences, skills y education. Los demás campos (tools, certifications, etc.) quedan con valores por defecto en CVCompleteResponse. Esto se refleja correctamente en los tests E2E.

---

Archivos a crear/modificar

1. Crear: tests/e2e/conftest.py

Configuración E2E — SIN dependency_overrides (stack real completo).

pytestmark = pytest.mark.e2e

• Fixture e2e_client que requiere MONGODB_URL (skip si no hay MongoDB)
• Usa httpx.AsyncClient con ASGITransport(app=app) (reutiliza patrón de tests/conftest.py:client)
• Resetea MongoDBClient y conecta a MongoDB real
• Limpia la BD (_clean_database) antes y después de cada test
• NO aplica dependency_overrides — todas las capas son reales

2. Reescribir: tests/e2e/test_complete_cv_flow.py

Flujo E2E completo del CV con las siguientes clases de test:

TestCVCreationFlow

Un test que crea recursos en orden y verifica el CV completo:

1. POST /profile → 201
2. POST /skills (x2) → 201 cada uno
3. POST /education → 201
4. POST /work-experiences → 201
5. GET /cv → 200, verificar profile + skills(2) + education(1) + experiences(1)
6. Verificar que skills están ordenados por order_index
7. Verificar que campos no agregados (contact_info, tools, etc.) son null/vacíos

TestCVWithAllResources

Crear TODOS los tipos de recursos y verificar:

1. Crear profile, skills, education, experiences, certifications, training, tools, social networks, contact info
2. GET /cv → verificar profile + skills + education + experiences (los 4 que el UC agrega)
3. Verificar via GET individuales que los demás recursos existen (tools, certifications, etc.)

TestCVEmptyProfile

1. Crear solo perfil (sin datos adicionales)
2. GET /cv → listas vacías, profile presente

TestCVDownloadPDF

1. Crear perfil mínimo
2. GET /cv/download → 501 (Not Implemented)

TestResourceCRUDFlow

CRUD completo de un recurso (skills):

1. POST → crear, verificar 201 + schema
2. GET list → verificar aparece
3. GET by ID → verificar datos
4. PUT → actualizar, verificar 200
5. GET by ID → verificar actualización persistió
6. DELETE → 200
7. GET by ID → 404

TestBusinessRuleValidation

1. POST /skills con order_index: -1 → 422
2. POST /skills con name: "" → 422
3. GET /skills/nonexistent → 404
4. Verificar formato error: {success, error, message, code}

TestDataConsistency

1. Crear perfil + 2 skills
2. GET /cv → verificar 2 skills
3. DELETE un skill
4. GET /cv → verificar 1 skill
5. GET /skills → verificar 1 skill

3. Crear: tests/e2e/test_contact_flow.py

Flujo E2E del contacto:

1. POST /contact-messages → 201
2. GET /contact-messages → verificar en lista
3. GET /contact-messages/stats/summary → verificar total > 0
4. DELETE /contact-messages/{id} → 200
5. GET /contact-messages → lista vacía

4. Modificar: Makefile

Añadir target:

test-e2e:
	cd deployments && docker compose exec backend pytest tests/e2e -v

---

Payloads de referencia

PROFILE = {"name": "Test User", "headline": "Full Stack Developer"}
SKILL_1 = {"name": "Python", "category": "backend", "order_index": 0, "level": "expert"}
SKILL_2 = {"name": "React", "category": "frontend", "order_index": 1, "level": "advanced"}
EDUCATION = {"institution": "MIT", "degree": "BSc CS", "field": "Computer Science",
             "start_date": "2018-09-01T00:00:00", "order_index": 0}
EXPERIENCE = {"role": "Senior Dev", "company": "Tech Corp",
              "start_date": "2022-01-01T00:00:00", "order_index": 0}
CERTIFICATION = {"title": "AWS SA", "issuer": "Amazon",
                 "issue_date": "2024-01-15T00:00:00", "order_index": 0}
TRAINING = {"title": "Docker Mastery", "provider": "Udemy",
            "completion_date": "2024-01-15T00:00:00", "order_index": 0}
TOOL = {"name": "VS Code", "category": "ide", "order_index": 0}
SOCIAL = {"platform": "github", "url": "https://github.com/test", "order_index": 0}
CONTACT_INFO = {"email": "test@example.com"}
CONTACT_MSG = {"name": "John Doe", "email": "john@test.com",
               "message": "Hello! I'd like to connect with you about a project."}

---

Archivos involucrados

# Crear (3)
tests/e2e/conftest.py
tests/e2e/test_complete_cv_flow.py  (reescribir placeholder)
tests/e2e/test_contact_flow.py

# Modificar (1)
Makefile  (añadir test-e2e target)

## Verificación

# Con Docker (requiere MongoDB)
make test-e2e

# O con MONGODB_URL
MONGODB_URL=mongodb://localhost:27017 pytest tests/e2e/ -v --tb=short

# Lint
ruff check tests/e2e/


# En CI: el job e2e-tests ya está configurado en .github/workflows/tests.yml

[Azfe]

Issue completada.

Todos los archivos que han sido creados/modificados:

• tests/e2e/conftest.py — E2E fixtures with MongoDB skip logic and DB cleanup
• tests/e2e/test_complete_cv_flow.py — 12 E2E tests for the complete CV flow
• tests/e2e/test_contact_flow.py — 9 E2E tests for the contact message flow
• Makefile — Added test-e2e target

All checks passed:

• Ruff lint: clean
• 21 E2E tests collected and correctly skip without MongoDB
• 1567 existing tests (unit + integration) pass without regression

Para verificar las pruebas E2E con una instancia real de MongoDB:

make test-e2e
# or
MONGODB_URL=mongodb://localhost:27017 pytest tests/e2e/ -v --tb=short