Saltar al contenido

CAT-COMMERCE: ecommerce construido sobre Next.js, PostgreSQL y Cloudflare Workers

Una tienda online no es solo un diseño bonito. Es una base de datos que no se cae, un checkout que no pierde ventas y un panel donde manejas todo sin depender de un programador. 35 tablas, 40+ endpoints, arquitectura serverless que escala sin que muevas un dedo.

2 años de desarrollo35 tablas40+ endpoints180+ componentes

Commerce.Sin comisiones.

Arquitectura técnica — lo que hay bajo el capó

No es magia. Es ingeniería.

Stack tecnológico completo

TecnologíaVersiónPara qué sirve
Next.js16.2.10Frontend con App Router, SSR e ISR — tu tienda carga en milisegundos y Google indexa cada producto
Hono4.12.27API ultrarrápida sobre Cloudflare Workers — tus endpoints responden desde el edge, cerca de tus clientes
Neon PostgreSQLServerlessBase de datos PostgreSQL serverless con branching — cada cliente tiene su instancia aislada, sin compartir recursos
Drizzle ORM0.45.2ORM type-safe con migraciones automáticas — cero errores de SQL en producción, TypeScript valida todo en tiempo de compilación
NextAuth.jsv5 BetaAutenticación con Google, GitHub y credenciales — tus clientes entran como quieran, con sesiones JWT seguras
Stripe + PolarStripe 20.1.0Dos pasarelas de pago integradas — Stripe para ventas internacionales, Polar para Perú. Webhooks verificados y protección anti-duplicados en ambas
Cloudflare R2PushDuck 0.6.0Almacenamiento de imágenes y archivos en el edge — tus fotos de producto se sirven rápido, sin costo de ancho de banda
DeepSeek V4 FlashOpenRouterChatbot AI que conoce tu catálogo real — recomienda productos, responde dudas y nunca devuelve un error aunque la IA falle

// No es magia. Es ingeniería.

Rate Limiting de Producción

8 tiers diferenciados con detección de ráfagas, escalación a bloqueo temporal y adaptadores duales (memoria en dev, Cloudflare KV en prod). Diseñado para los patrones de tráfico reales de un ecommerce — no es un middleware genérico. Tu tienda sigue funcionando aunque alguien intente abusar.

Doble Driver de Base de Datos

Dos drivers Drizzle simultáneos: neon-http para lecturas rápidas y neon-serverless WebSocket para transacciones atómicas. Esto permite correr en Cloudflare Workers sin sacrificar integridad transaccional — un producto con variantes, imágenes y precios se crea en una sola operación atómica.

Motor de Recomendaciones con ML

Microservicio standalone con TensorFlow.js que entrena sobre acciones reales de usuarios: vistas, wishlist, carrito y compras. Las recomendaciones tienen razón explícita — "basado en tus compras", "similar a usuarios como tú" — no es una caja negra.

SEO Integrado en el Framework

JSON-LD estructurado (Organization, Product, BreadcrumbList), sitemap bilingüe con hreflang, 72+ páginas con generateMetadata, ISR en productos, hero image preload. No es un plugin que instalaste — el SEO está tejido en cada ruta del código. Google entiende tu tienda sin que tengas que explicarle nada.

Chatbot que Conoce tu Catálogo

Antes de cada request, carga categorías, marcas y productos desde la base de datos en runtime. System prompt de 170 líneas con reglas de negocio, tono de vendedor y respuesta estructurada. Si la IA falla, devuelve un mensaje de fallback — nunca un error 500. Tus clientes siempre reciben una respuesta.

Lo que ya está protegido

  • Webhooks de pago con verificación de firma criptográfica (Stripe)
  • Rate limiting de 8 tiers con detección de abuso y bloqueo temporal
  • Contraseñas hasheadas con bcrypt (10 rounds) — ni nosotros podemos leerlas
  • Validación de entrada con Zod en TODOS los endpoints
  • Protección de rutas admin con doble capa (Next.js middleware + Hono middleware)
  • Transacciones atómicas — el stock se descuenta sin riesgo de sobreventa
  • Índice único parcial que previene pagos duplicados en la misma orden
  • Sesiones JWT vía Auth.js con cookies seguras

Lo que viene en el roadmap

  • Headers de seguridad HTTP (CSP, HSTS, X-Frame-Options) — previenen clickjacking y XSS
  • CSRF protection en API custom

CAT-COMMERCE en números

725+Archivos TypeScript
35Tablas en DB
180+Componentes React
40+Endpoints API
8Tiers de rate limiting
2Pasarelas de pago

Tour del producto — así se ve CAT-COMMERCE en acción

10 pantallas. Lo que ves es lo que tus clientes van a ver.

Página principal de la tienda

Storefront con productos destacados, categorías y búsqueda — tus clientes encuentran lo que buscan en segundos.

Página principal de la tienda

Página de producto con variantes

Ficha de producto con imágenes, talles, colores y stock en tiempo real. Sin sorpresas.

Página de producto con variantes

Carrito de compras

Carrito con resumen, cantidades y cálculo de envío antes de pagar. Transparente.

Carrito de compras

Checkout con Stripe

Checkout con Stripe Elements — tus clientes pagan sin salir de tu tienda. Seguro y rápido.

Checkout con Stripe

Panel de administración — dashboard

Dashboard con métricas de ventas, órdenes recientes y productos más vistos. Todo en un pantallazo.

Panel de administración — dashboard

Panel de administración — gestión de productos

CRUD completo de productos con imágenes por color, variantes y precios multi-moneda.

Panel de administración — gestión de productos

Panel de administración — órdenes

Gestión de órdenes con historial de estados — de pendiente a entregado, cada paso registrado.

Panel de administración — órdenes

Vista móvil de la tienda

100% responsive — tus clientes compran desde el celular igual que desde la computadora.

Vista móvil de la tienda

Modo oscuro

Modo oscuro completo en todos los componentes. Porque tus clientes también compran de noche.

Modo oscuro

Chatbot AI integrado

Chatbot que recomienda productos basado en tu catálogo real. Como un vendedor que nunca duerme.

Chatbot AI integrado

Tu camino a una tienda profesional — cronograma de 4 semanas

Sin sorpresas, sin letra chica. Esto es lo que pasa cada semana.

W0

Semana 0 — Lo que necesitas preparar

Tú preparas:

  • Fotos de tus productos en buena calidad (800x800 px mínimo)
  • Logo de tu marca en formato SVG o PNG con fondo transparente
  • Tu dominio (o te ayudamos a comprar uno)
  • 3-5 categorías principales para organizar tu catálogo
  • Documento de identidad para verificar tu cuenta de pasarela de pago
W1

Semana 1 — Fundación

¿Qué hacemos?

Configuramos tu instancia de CAT-COMMERCE: base de datos aislada, dominio, SSL, pasarela de pago y panel de administración. Cargamos tus primeras categorías y productos de prueba para que veas cómo funciona el sistema.

¿Qué ves?

Tu tienda online con tu dominio, tu logo y tus categorías. Todavía sin productos reales — es el esqueleto sobre el que construimos todo.

W2

Semana 2 — Catálogo y diseño

¿Qué hacemos?

Te preparamos el panel de administración con la estructura de tu tienda: categorías, marca, colores y tipografía. Te enseñamos a cargar tus productos desde el panel — arrastras imágenes, pones precios y descripciones. Si quieres que nosotros los carguemos, usamos parte de tus horas de ingeniero incluidas (cada hora rinde ~15-20 productos según complejidad). Lo ideal es que los cargues tú: conoces tus productos mejor que nadie.

¿Qué ves?

Tu tienda con la estructura lista, diseño aplicado y productos de ejemplo cargados. El panel de administración está operativo para que empieces a cargar tus productos o para que lo hagamos nosotros usando tus horas de ingeniero.

W3

Semana 3 — Pagos, envíos y automatizaciones

¿Qué hacemos?

Activamos Stripe y Polar en modo producción. Configuramos zonas de envío, impuestos y emails transaccionales (confirmación de compra, aviso de envío). Probamos el flujo de compra completo 3 veces.

¿Qué ves?

Tu tienda completamente funcional. Puedes hacer una compra de prueba de punta a punta — del carrito a la confirmación por email — y ver tu panel de administración actualizarse en tiempo real.

W4

Semana 4 — Lanzamiento

¿Qué hacemos?

Últimos ajustes de SEO técnico, sitemap, robots.txt y hreflang. Testeamos velocidad con Lighthouse (objetivo: 90+). Te entregamos acceso completo al panel de administración y una sesión de capacitación de 1 hora.

¿Qué ves?

Tu tienda lista para recibir clientes reales. Indexada en Google, con pagos funcionando y tú sabiendo exactamente cómo gestionar todo desde el panel. Sin depender de nadie.

Preguntas frecuentes sobre CAT-COMMERCE

¿Cuánto tarda en reflejarse un pago en mi cuenta?
Stripe transfiere a tu cuenta bancaria en 7 días hábiles (primer pago puede demorar hasta 14 días por verificación). Polar transfiere en 2-3 días hábiles. Ambas son automáticas — tú solo vendes, el dinero llega solo. En tu panel de administración ves cada pago en tiempo real apenas el cliente completa la compra.
¿Puedo cambiar de plan después de contratar?
Sí, en cualquier momento. Si tu tienda crece y necesitas más horas de desarrollo al mes, pasas al plan superior pagando la diferencia proporcional del mes. Si necesitas bajar, avisas con 15 días de anticipación y ajustamos desde el mes siguiente. Sin penalizaciones, sin letra chica.
¿Qué pasa si me atraso con un pago mensual?
Tienes 7 días de gracia sin penalización. Al día 8, tu tienda se pausa por completo hasta que regularices el pago. Tus datos quedan intactos y al reactivar, todo vuelve a funcionar en horas. Si necesitas darte de baja, te entregamos un export completo de tus datos en JSON y CSV. Sin ataduras.
¿Qué tan personalizable es el diseño de mi tienda?
Mucho. Cambiamos colores, tipografía, layout de página de producto, orden de secciones, banners del hero. Lo que NO hacemos es convertir CAT-COMMERCE en algo que no es — si necesitas un diseño completamente único desde cero, eso es desarrollo web a medida (que también hacemos). CAT-COMMERCE te da una tienda profesional con tu identidad visual, no un clon genérico.
¿Cuántos productos puedo tener? ¿Se pone lenta la tienda con muchos?
La arquitectura está diseñada para escalar. PostgreSQL con índices optimizados maneja 10,000+ productos sin degradación de rendimiento. Las páginas de catálogo usan ISR (Incremental Static Regeneration) — se regeneran cada 5 minutos, no en cada visita. La búsqueda actual usa ILIKE de PostgreSQL (funcional hasta ~50k productos). Para catálogos masivos, la búsqueda full-text con tsvector está en el roadmap de futuras versiones.
¿Puedo vender productos digitales además de físicos?
Sí. CAT-COMMERCE soporta ambos tipos. Para productos digitales (ebooks, cursos, software) configuramos entrega automática por email con link de descarga apenas se confirma el pago. Si tu modelo de negocio es mixto (físico + digital), el sistema maneja ambos en el mismo catálogo sin problemas. Las suscripciones y membresías están en el roadmap para una versión futura.
¿Qué tan profundo es el SEO? ¿No es solo poner meta tags?
El SEO de CAT-COMMERCE no es un plugin — está integrado en el framework. Incluye: JSON-LD estructurado (Organization, Product, BreadcrumbList, FAQPage), sitemap.xml bilingüe con hreflang automático, generateMetadata tipado en 72+ páginas, ISR con revalidate=300 en productos, OpenGraph y Twitter Cards completos, canonical URLs, breadcrumb semántico y preload de hero image. Google ve tu tienda como una aplicación web profesional, no como un sitio genérico.
¿Cómo se ve mi tienda en el celular?
Cada componente de CAT-COMMERCE fue diseñado mobile-first. Las imágenes se optimizan con next/image (WebP/AVIF automático, lazy loading). El checkout de Stripe es responsive nativo. El panel de administración también funciona en tablet — puedes gestionar órdenes desde tu celular mientras estás en el depósito. Probamos en iPhone SE, Pixel y tablets Android.
¿Qué pasa si mi tienda crece a 10,000 productos o más?
La arquitectura escala horizontalmente. Cloudflare Workers maneja el tráfico en el edge global. Neon PostgreSQL escala sin downtime. Agregamos índices adicionales y aumentamos la frecuencia de ISR a demanda. El límite real no es técnico — es de negocio. Si llegás a 10,000 productos, ya estamos hablando de una operación que factura serio, y ajustamos el plan en consecuencia.
Si algún día quiero irme, ¿puedo llevarme mis datos?
100%. Tus datos son tuyos. Te entregamos un export completo en JSON y CSV: productos con imágenes, órdenes con historial, clientes con datos de contacto, reseñas, todo. Sin formatos propietarios, sin excusas. Mantenemos tu instancia activa por 30 días después de la baja por si cambias de opinión. No hacemos vendor lock-in — si el producto es bueno, te quedas porque quieres, no porque estás atrapado.

Commerce.Sin comisiones.

Deja de depender de un marketplace. Tu dominio, tus reglas.

CAT-COMMERCE es tu propio software en tu propio dominio — no alquilas un espacio en la plataforma de otro. Sin comisiones, sin depender del algoritmo de nadie.

Incluye: hosting serverless (Cloudflare Workers), base de datos PostgreSQL aislada, panel de administración, SEO técnico y 4-10 horas de ingeniero por mes. Todo por $200/mes los primeros 3 meses.