Documentación de Checklist de Pruebas de Humo: Construyendo Pruebas de Verificación de Build Efectivas

rutas_criticas:
  plataforma_ecommerce:
    autenticacion_usuario:
      prioridad: P0
      flujos:
        - "Login de usuario con credenciales válidas"
        - "Verificación de persistencia de sesión"
        - "Funcionalidad de logout"
      criterios_aceptacion: "Todos los flujos de auth completan sin errores"

    catalogo_productos:
      prioridad: P0
      flujos:
        - "Página principal carga con productos"
        - "Búsqueda de productos devuelve resultados"
        - "Página de detalle de producto se muestra"
      criterios_aceptacion: "Catálogo accesible y buscable"

    proceso_checkout:
      prioridad: P0
      flujos:
        - "Agregar artículo al carrito"
        - "Ver carrito con artículos correctos"
        - "Proceder al checkout"
        - "Completar pago (modo prueba)"
      criterios_aceptacion: "Flujo de compra end-to-end completa"

    gestion_pedidos:
      prioridad: P1
      flujos:
        - "Ver confirmación de pedido"
        - "Acceder historial de pedidos"
      criterios_aceptacion: "Seguimiento de pedidos funcional"

## Estrategia de Pruebas de Humo de Tres Capas

### Capa 1: Humo de Infraestructura (5 minutos)
**Propósito**: Verificar despliegue básico y conectividad

- [ ] URL de aplicación accesible (HTTP 200)
- [ ] Endpoint de health check responde
- [ ] Conexión a base de datos establecida
- [ ] Servicio de caché respondiendo
- [ ] Cola de mensajes accesible
- [ ] CDN sirviendo assets estáticos
- [ ] API gateway enrutando correctamente

### Capa 2: Humo de Componentes (10 minutos)
**Propósito**: Verificar componentes clave se inicializan

- [ ] Página de login carga
- [ ] Página principal renderiza con datos
- [ ] Endpoints API devuelven respuestas esperadas
- [ ] JavaScript frontend carga sin errores
- [ ] Estilizado CSS aplica correctamente
- [ ] Jobs en segundo plano procesando
- [ ] Servicio de email enviando mensajes de prueba

### Capa 3: Humo de Integración (15 minutos)
**Propósito**: Verificar flujos end-to-end críticos

- [ ] Usuario puede hacer login
- [ ] Usuario puede realizar acción primaria (compra, transferencia, post)
- [ ] Datos persisten correctamente
- [ ] Notificaciones por email enviadas
- [ ] Integraciones con terceros respondiendo
- [ ] Logging y monitoreo activos

# smoke_test_suite.py
import pytest
from selenium import webdriver
from api_client import APIClient
import logging

class SmokeTestSuite:
    """
    Suite completa de pruebas de humo para verificación de build
    """

    @pytest.fixture(scope="class")
    def setup(self):
        """Configurar entorno de prueba"""
        self.driver = webdriver.Chrome()
        self.api = APIClient(base_url="https://api.example.com")
        self.logger = logging.getLogger(__name__)
        yield
        self.driver.quit()

    @pytest.mark.smoke
    @pytest.mark.priority_p0
    def test_infrastructure_health(self):
        """Capa 1: Verificar infraestructura"""
        # Health check
        response = self.api.get("/health")
        assert response.status_code == 200
        assert response.json()["status"] == "healthy"

        # Conectividad de base de datos
        db_check = self.api.get("/health/database")
        assert db_check.json()["database"] == "connected"

        self.logger.info("✓ Humo de infraestructura pasado")

    @pytest.mark.smoke
    @pytest.mark.priority_p0
    def test_authentication_flow(self):
        """Capa 2: Verificar autenticación"""
        self.driver.get("https://app.example.com/login")

        # Elementos de login presentes
        assert self.driver.find_element("id", "username")
        assert self.driver.find_element("id", "password")
        assert self.driver.find_element("id", "login-button")

        # Realizar login
        self.driver.find_element("id", "username").send_keys("smoke_test_user")
        self.driver.find_element("id", "password").send_keys("test_password")
        self.driver.find_element("id", "login-button").click()

        # Verificar login exitoso
        assert "dashboard" in self.driver.current_url
        assert self.driver.find_element("class", "user-greeting")

        self.logger.info("✓ Humo de autenticación pasado")

    @pytest.mark.smoke
    @pytest.mark.priority_p0
    def test_critical_business_flow(self):
        """Capa 3: Verificar flujo crítico end-to-end"""
        # Asume ya logueado de prueba anterior

        # Navegar a producto
        self.driver.get("https://app.example.com/products")
        product = self.driver.find_element("class", "product-card")
        product.click()

        # Agregar al carrito
        add_to_cart_btn = self.driver.find_element("id", "add-to-cart")
        add_to_cart_btn.click()

        # Verificar carrito
        cart_count = self.driver.find_element("id", "cart-count").text
        assert int(cart_count) > 0

        # Proceder a checkout
        self.driver.get("https://app.example.com/checkout")
        assert "checkout" in self.driver.current_url

        # Verificar elementos de página checkout
        assert self.driver.find_element("id", "shipping-form")
        assert self.driver.find_element("id", "payment-form")

        self.logger.info("✓ Humo de flujo crítico de negocio pasado")

criterios_go_no_go:
  rechazo_inmediato:
    - "Aplicación falla al desplegar"
    - "Endpoint de health check devuelve errores 5xx"
    - "Conexión a base de datos falla"
    - "Autenticación completamente rota"
    - "Endpoints API críticos devuelven errores 500"
    - "Frontend falla al cargar (pantalla blanca)"
    - "Cualquier prueba de humo P0 falla"

  aceptacion_condicional:
    - condicion: "1-2 pruebas de humo P1 fallan"
      accion: "Aceptar con tickets de bugs, proceder con cautela"
    - condicion: "Degradación de rendimiento <20%"
      accion: "Aceptar, monitorear de cerca"
    - condicion: "Problemas menores de renderizado UI"
      accion: "Aceptar, registrar defectos"

  aceptacion_completa:
    - "Todas las pruebas de humo P0 pasan"
    - "No hay errores críticos en logs"
    - "Tiempos de respuesta dentro de baseline ±10%"
    - "No se introducen vulnerabilidades de seguridad"
    - "Todos los servicios saludables"