Volver a Casos de Éxito

Plataforma E-Commerce Storfront

Storfront E-commerce / Retail
7+
Tipos de Promoción
100%
Type-Safe
REST
Arquitectura API

Situación

Las plataformas de e-commerce ofrecen templates rígidos o requieren desarrollo extensivo. Los comerciantes necesitaban un backend flexible que pudiera potenciar storefronts personalizados mientras maneja promociones complejas, inventario y aislamiento multi-tenant out of the box.

Objetivo

Construir una API de e-commerce headless con arquitectura multi-tenant, un potente motor de promociones basado en reglas, gestión de carrito/pedidos y autenticación JWT—diseñada para potenciar cualquier frontend.

Acción

Desarrollamos un monorepo TypeScript usando Express 5 para la API REST, Drizzle ORM con PostgreSQL 17 para acceso type-safe a datos, y Redis para caché de sesiones/carrito. Implementamos un sofisticado motor de promociones soportando porcentaje, monto fijo, BOGO, bundles, descuentos escalonados y envío gratis.

Resultado

Entregamos un backend de e-commerce headless listo para producción. El motor de promociones soporta 7+ tipos de descuento con condiciones componibles. La API maneja carritos de invitados y autenticados, gestión de pedidos y aislamiento multi-tienda con queries por tenant.

Tecnologías Utilizadas

Express 5 TypeScript Drizzle ORM PostgreSQL 17 Redis JWT Auth

El Desafío

Construir un backend de e-commerce desde cero es complejo. Solo las promociones requieren manejar porcentajes, montos fijos, buy-one-get-one, bundles, precios escalonados y más—cada uno con sus propias condiciones y reglas de apilamiento. Storfront necesitaba capacidades enterprise sin complejidad enterprise.

Nuestro Enfoque

Construimos Storfront como una plataforma headless API-first:

  1. Estructura Monorepo — Turborepo con configs compartidas, reglas ESLint y definiciones TypeScript
  2. Stack Type-Safe — Express 5 + TypeScript + Drizzle ORM para type safety de punta a punta
  3. Patrón Service Layer — Routes manejan HTTP, services contienen lógica de negocio con validación Zod
  4. Multi-Tenant por Diseño — Todas las queries con scope a storeId previniendo fuga de datos

Motor de Promociones

El sistema de promociones basado en reglas soporta:

TipoDescripción
Porcentaje10% de descuento en toda la orden
Monto Fijo$5 de descuento en órdenes mayores a $50
Buy X Get YCompra 2, lleva 1 gratis
BundleDescuento al comprar items específicos juntos
EscalonadoDescuentos crecientes en umbrales de cantidad
Envío GratisSin cargo de envío en órdenes calificadas
BOGOCompra uno, lleva otro al 50%

Cada promoción tiene condiciones componibles (valor mínimo del carrito, productos específicos, segmentos de clientes) y reglas de apilamiento.

Aspectos Técnicos Destacados

  • Drizzle ORM — SQL type-safe con migraciones automáticas
  • Sistema de Carrito — Soporta clientes autenticados y sesiones de invitados
  • Auth JWT — Tokens de acceso de corta duración (15m) con rotación de refresh tokens (7d)
  • Docker Compose — PostgreSQL, Redis y Adminer para desarrollo local
  • Vitest — Testing unitario rápido, nativo de ESM

Estructura de la API

/api/v1/auth                    # Login, registro, refresh
/api/v1/stores/:storeId/products    # Catálogo de productos
/api/v1/stores/:storeId/cart        # Operaciones de carrito
/api/v1/stores/:storeId/orders      # Gestión de pedidos
/api/v1/stores/:storeId/promotions  # CRUD de promociones

Los Resultados

Storfront provee una base sólida para cualquier frontend de e-commerce:

  • 7+ tipos de promoción con condiciones componibles
  • 100% type-safe desde base de datos hasta respuesta API
  • Multi-tenant ready con aislamiento de datos apropiado
  • Developer-friendly — Patrones claros, tests comprehensivos

¿Listo para Escribir tu Historia de Éxito?

Hablemos de cómo podemos ayudarte a resolver tus desafíos técnicos.

Hablemos