👗 Tienda de Ropa Perú — E-commerce Fullstack (Next.js 15 + Express 5)
Plataforma de Comercio Electrónico Especializada en Moda para el Mercado Peruano
Tienda de Ropa Perú es una solución de comercio electrónico diseñada para tiendas de indumentaria textil en el mercado local. Cuenta con una arquitectura desacoplada: frontend veloz con Next.js 15 + Turbopack, backend en Express 5, base de datos relacional para control de inventario y tallas, e integración con métodos de pago nacionales (Yape, Plin y tarjetas vía Culqi).
- 💻 Repositorio GitHub: github.com/Alecwce/tienda-ropa-peru (Privado)
- 🛒 Frontend: Next.js 15.5 + React 19 + Tailwind CSS 4 | Backend: Express 5.1 + Node.js + PostgreSQL
✨ Características de la Tienda
flowchart TD Cliente([🛍️ Comprador]) <--> Storefront["👗 Frontend Next.js 15\n(Turbopack + Tailwind 4)"] Storefront --> Cart["🛒 Carrito de Compras & Checkout"] Cart --> Payments["💳 Pasarela Peruana\n(Yape QR, Plin y Culqi API)"] Storefront <--> API["⚙️ API RESTful Express 5\n(TypeScript + Node.js)"] API --> DB[("🗄️ PostgreSQL\n(Productos, Variantes de Talla/Color, Pedidos)")] API --> Admin["🛡️ Panel Administrativo\n(Gestión de Stock y Envíos)"]
- Catálogo de Moda con Filtros Dinámicos:
- Navegación facetada por categoría (polos, casacas, pantalones, calzado), rango de precio y selección de tallas (S, M, L, XL).
- Checkout Optimizado para Perú:
- Soporte nativo para escaneo directo de código QR de Yape y Plin con confirmación de voucher, además de procesamiento de tarjetas de crédito/débito nacionales mediante Culqi.
- Frontend Ultra-Rápido con Turbopack:
- Desarrollado sobre Next.js 15.5 y React 19, aprovechando Server Components para renderizar el catálogo con latencia casi nula.
- Backend Moderno con Express 5:
- Adopta la nueva versión mayor de Express con manejo nativo de promesas y middleware asíncrono tipado con TypeScript.
🛠️ Stack Tecnológico
| Capa | Tecnología | Propósito |
|---|---|---|
| Frontend Web | Next.js 15.5.2 (Turbopack) | Aplicación web del cliente y SSR de productos |
| UI Library | React 19.1.0 | Componentes reactivos del carrito y checkout |
| Estilos | Tailwind CSS v4 (@tailwindcss/postcss) | Diseño responsive optimizado para móviles |
| Backend API | Express 5.1.0 + TypeScript | Servidor REST para autenticación, órdenes y catálogo |
| Base de Datos | PostgreSQL | Almacenamiento transaccional de pedidos e inventario |
| Pasarela de Pago | Culqi API + Integración Yape/Plin | Cobros digitales locales seguros |
🚀 Puesta en Marcha
# 1. Configurar y levantar el Backend (Express)
cd backend
npm install
npm run dev # Servidor en localhost con nodemon + ts-node
# 2. Configurar y levantar el Frontend (Next.js)
cd ../frontend
npm install
npm run dev # Inicia con Next.js + Turbopack🔗 Relación con Otros Proyectos
- 🛍️ E-commerce & Moda: Conecta con proyectos comerciales como Whims Chupaca Boutique y Ryūkami Store Streetwear.
- 📊 Matriz de Proyectos: Registrado en Proyectos Privados.