🛍️ EcoCraft PYME - E-commerce & Panel de Administración

Aplicación web full stack de comercio electrónico desarrollada como proyecto de demostración / muestra para una PYME ficticia ("EcoCraft"), con gestión de productos en tiempo real, carrito de compras, simulación de pagos y persistencia en base de datos relacional.

---

Link Pagina web

https://pyme-ecommerce.onrender.com

---

⏱️ Nota sobre el entorno gratuito: Al estar alojado en el plan gratuito de Render, el servidor backend entra en suspensión tras unos minutos de inactividad (cold start). Si la página no recibe peticiones recientes, la primera carga al abrir el enlace puede demorar aproximadamente 50 segundos en despertar el servicio y restaurar automáticamente la base de datos a su estado inicial.

---

⚠️ Nota de Uso y Propósito

Este proyecto fue creado con fines estrictamente académicos y de portafolio profesional. Representa una tienda virtual simulada (entorno sandbox) de una pequeña y mediana empresa (PYME) ficticia orientada a la venta de productos sustentables y artesanales. Las transacciones, pagos y flujos son simulados.

---

🚀 Tecnologías Utilizadas

Frontend (/client)

• React + Vite: Interfaz de usuario moderna, rápida y reactiva.
• CSS Moderno / Diseño Responsivo: Estilos personalizados adaptados para dispositivos móviles y de escritorio.

Backend (/server)

• Node.js & Express: API RESTful robusta y modular.
• PostgreSQL: Base de datos relacional para la persistencia segura de productos y órdenes.
• pg (node-postgres): Conexión optimizada y consultas parametrizadas contra inyección SQL.
• CORS & dotenv: Gestión de seguridad y variables de entorno.

---

✨ Características Principales

• Catálogo Dinámico: Visualización de productos con categorías, precios, descuentos y descripciones.
• Gestión de Carrito: Control de cantidades, cálculo de totales y simulación de compra en entorno sandbox.
• Panel de Administración (/admin):
  • Creación, edición y eliminación de productos.
  • Respaldo y restauración automática de la base de datos a su versión inicial mediante scripts.
• Despliegue Cloud (Render): Arquitectura separada con backend desplegado en Web Service y frontend optimizado en Static Site, conectado a una base de datos PostgreSQL en la nube.

---

📂 Estructura del Repositorio

pyme-ecommerce/
├── client/             # Código fuente del Frontend (React + Vite)
│   ├── src/
│   └── package.json
├── server/             # Código fuente del Backend (Node.js + Express)
│   ├── routes/         # Endpoints de la API (productos, órdenes)
│   ├── db.js           # Conexión a PostgreSQL
│   ├── index.js        # Punto de entrada del servidor
│   └── package.json
└── .gitignore

##⚙️ Instalación y Ejecución Local Si deseas clonar y correr este proyecto de muestra en tu entorno local, sigue estos pasos:

Clonar el repositorio:

Bash
git clone [https://github.com/FelipeAceved0/Pyme-Ecommerce.git](https://github.com/FelipeAceved0/Pyme-Ecommerce.git)
cd pyme-ecommerce

Configurar el Backend:

Bash
cd server
npm install

Crea un archivo .env en la carpeta server con tu conexión a PostgreSQL:

Fragmento de código

PORT=5000
DATABASE_URL=postgres://usuario:contraseña@localhost:5432/tu_base_de_datos

Inicia el servidor de desarrollo:

Bash
node index.js

Configurar el Frontend:

Bash
cd ../client
npm install

Inicia la aplicación de React:

Bash
npm run dev

🌐 Despliegue en Producción

Frontend: Alojado en Render (Static Site).

Backend: Alojado en Render (Web Service Node.js).

Base de Datos: PostgreSQL en la nube gestionada mediante pool de conexiones seguras.

👨‍💻 Autor

Desarrollado por Felipe Acevedo.