Asegurando la Gestión de Ventas con Pruebas de Integración y Emuladores Firebase

Introducción

En el proyecto TuTiendaWeb, la funcionalidad de gestión de ventas es el corazón de la operación. Garantizar la precisión y robustez de cada transacción, desde la creación hasta la eliminación, es fundamental. Para lograr esto, hemos implementado una suite exhaustiva de pruebas de integración, apalancándonos en los emuladores de Firebase y la potencia de Vitest.

El Desafío

Las operaciones de ventas son inherentemente complejas. Involucran cálculos dinámicos de totales, la aplicación de descuentos, filtrado por múltiples criterios y la necesidad de mantener la integridad de los datos en todo momento. Además, probar estos flujos en un entorno real puede ser lento y costoso. Necesitábamos un enfoque que nos permitiera simular interacciones con la base de datos de manera aislada, rápida y consistente, sin afectar los datos de producción o incurrir en costos de infraestructura en la nube durante el desarrollo y las pruebas.

La Solución

Para abordar este desafío, adoptamos una estrategia de pruebas de integración que utiliza los emuladores locales de Firebase, específicamente para Firestore, combinados con Vitest para orquestar los tests. Esto nos permite ejecutar pruebas contra un entorno de base de datos simulado que se comporta exactamente como la producción, pero con un control total sobre su estado. Las pruebas cubren una amplia gama de escenarios, incluyendo:

• Creación de Ventas: Verificando que los totales se recalculen correctamente al insertar nuevos registros.
• Actualización de Ventas: Probando la capacidad de modificar campos específicos (utilizando notación de punto) y la correcta aplicación de descuentos.
• Consulta de Ventas: Validando el filtrado por fecha, estado de pago, estado de entrega, cliente y límites de resultados.
• Cálculo de Estadísticas: Asegurando que las funciones de agregación devuelvan métricas de ventas precisas.
• Eliminación de Ventas: Confirmando que los registros se borren correctamente.
• Acciones Públicas y Guardas de Sesión: Testeando la seguridad y las reglas de acceso para acciones de venta públicas y la protección de sesiones.

Consideremos un ejemplo simplificado de cómo se podría probar la creación de una venta:

import { describe, it, expect, beforeEach, afterEach } from 'vitest';
import { initializeTestEnvironment, RulesTestEnvironment, get ) } from '@firebase/rules-unit-testing';
import { doc, setDoc } from 'firebase/firestore';
import { createSale } from './sales.service'; // Asumiendo un servicio de ventas

let testEnv: RulesTestEnvironment;

beforeEach(async () => {
  testEnv = await initializeTestEnvironment({
    projectId: 'test-project-id',
    firestore: {
      rules: './firestore.rules',
      host: 'localhost',
      port: 8080,
    },
  });
  await testEnv.clearFirestore(); // Limpiar datos entre pruebas
});

afterEach(async () => {
  await testEnv.cleanup();
});

describe('createSale', () => {
  it('debería crear una venta con totales recalculados correctamente', async () => {
    const db = testEnv.authenticatedContext('test-user').firestore();
    const saleData = {
      items: [{ productId: 'prod1', quantity: 2, price: 100 }],
      discount: 10,
      clientId: 'client1',
    };
    
    await createSale(db, saleData); // Esta función debería calcular el total
    
    const saleDoc = await get(doc(db, 'sales', 'some-generated-id')); // ID de ejemplo
    const sale = saleDoc.data();
    
    expect(sale?.total).toBe(190); // (2*100) - 10
    expect(sale?.clientId).toBe('client1');
  });
});

En este fragmento, initializeTestEnvironment configura la conexión al emulador de Firestore. Antes de cada prueba (beforeEach), el entorno se limpia para asegurar que cada test sea independiente. La función createSale (que sería parte de nuestra lógica de negocio) interactúa con este entorno simulado. Finalmente, aserciones de Vitest verifican que los datos se guarden correctamente y que los cálculos se realicen como se espera.

Decisiones Clave

1. Emuladores Firebase: Proporcionan un entorno de base de datos local y desechable que replica fielmente el comportamiento de la producción, pero con una latencia mínima y sin costo.
2. Limpieza de Datos entre Pruebas: El uso de testEnv.clearFirestore() en beforeEach garantiza que cada prueba se ejecute en un estado conocido, eliminando dependencias entre ellas.
3. Contextos de Autenticación: La capacidad de crear contextos de usuario autenticados (authenticatedContext) permite probar las reglas de seguridad de Firestore de forma efectiva.

Resultados

Esta estrategia ha fortalecido significativamente la confianza en la lógica de negocio de las ventas. La detección temprana de errores relacionados con cálculos o filtrados ha mejorado la calidad del código y ha acelerado el ciclo de desarrollo al proporcionar retroalimentación instantánea. Hemos logrado una cobertura integral que asegura que las operaciones críticas de la tienda funcionen impecablemente.

Lecciones Aprendidas

Invertir en pruebas de integración robustas con emuladores no solo ahorra tiempo y dinero a largo plazo, sino que también fomenta una cultura de desarrollo más segura y confiable. Asegurarse de que los entornos de prueba reflejen la producción lo más fielmente posible es crucial para evitar sorpresas una vez que el código llega a producción. Siempre priorice la prueba de sus flujos de negocio más críticos con datos realistas en entornos controlados.

Generated with Gitvlg.com