🛍️ eMercado | API

eMercado API es la capa de backend para la plataforma ficticia de comercio electrónico eMercado, diseñada con fines educativos. Proporciona servicios RESTful para manejar autenticación, productos, categorías, carrito de compras y más.

Nota: Ninguna de las transacciones o datos son reales; todo es simulado para fines de aprendizaje.

✔ Funcionalidades

• Autenticación: Gestión de usuarios con soporte para inicio de sesión y autenticación mediante JWT.
• Gestión de productos: CRUD para productos, incluyendo detalles, precios, y comentarios.
• Categorías: Navegación y administración de categorías de productos.
• Carrito de compras: Operaciones dinámicas para agregar, eliminar y visualizar productos en el carrito.
• Ventas: Simulación de procesos de compra y manejo de transacciones ficticias.

🛠️ Requisitos previos

• Node.js versión 22 o superior.
• MariaDB configurado y en funcionamiento.

🚀 Instalación y configuración

1. Clona el repositorio

git clone <URL_DEL_REPOSITORIO>
cd e-mercado-api

2. Instala las dependencias

npm install

3. Configura las variables de entorno (Opcional)

Crea un archivo .env y completa los valores necesarios:

# Configuración del servidor
PORT = 3000

# Clave secreta para JWT
SECRET_KEY = claveultrasecreta

# Configuración de base de datos
DB_HOST=localhost
DB_USER=user_db
DB_PASSWORD=password_db
DB_NAME=name_db
DB_PORT=XXXX
DB_CONN_LIMIT=X

# Configuración del token JWT
JWT_EXPIRES_IN = 1h

4. Configura la base de datos

1. Importa el script SQL proporcionado en el repositorio para configurar la base de datos. El archivo se encuentra en la carpeta:

   mariadb/ecommerce.sql

2. Ejecuta el script en tu instancia de MariaDB.

5. Inicia el servidor

Ejecuta el siguiente comando para iniciar la aplicación:

npm run dev

La API estará disponible en http://localhost:3000.

📂 Estructura del proyecto

• app.js - Archivo principal para iniciar la aplicación.
• routes/ - Definición de rutas para los diferentes endpoints.
• controllers/ - Lógica para manejar las solicitudes de cada ruta.
• models/ - Definición de las entidades y conexión con la base de datos.
• mariadb/ecommerce.sql - Script SQL para configurar la base de datos.
• postman/ - Carpeta con colecciones de Postman para probar los endpoints de la API.
  • e-Mercado API Endpoints.postman_collection.json - Colección de pruebas para los endpoints de la API.

🛠️ Construido con

• - Entorno de ejecución para JavaScript en el lado del servidor.
• - Framework para construir aplicaciones web y APIs.
• - Sistema de gestión de bases de datos.
• - Autenticación basada en tokens.
• - Herramienta para probar y documentar APIs.

💻 Desarrollado por

• Valentina Hernández.
• Kelly Salas.
• Fernanda Rigali.
• Ailen Albornoz.