Volver a proyectos

Silverline

ECOMMERCE · PROYECTO ACADÉMICO

Tienda online de MacBooks reacondicionados, con catálogo, usuarios, pedidos y direcciones. Aquí cuento cómo monté la API y el entorno con MongoDB y Docker Compose.

foco
API, modelos y entorno Docker
contexto
Proyecto académico · backend
tecnologías
  • React
  • Node.js
  • Express
  • MongoDB
  • Docker Compose
Portada ilustrada de Silverline

El backend de una tienda online.

La idea

Catálogo, usuarios y pedidos comparten datos, pero cada parte tiene sus reglas. Y la API tiene que conectarse con la base de datos dentro de Docker.

Qué hice

La API con Node.js, Express y Mongoose: rutas, controladores, servicios y modelos de productos, usuarios, pedidos y direcciones. Docker Compose levanta la API y MongoDB juntas.

Qué no cuento aquí

La interfaz en React también es parte del proyecto, pero esta ficha va de la API y el entorno.

La API y su entorno.

Me centré en ordenar la API de la tienda y en que los servicios se vieran entre ellos.

  • Organización: separar rutas, controladores, servicios y modelos.
  • Datos: modelos de productos, usuarios, pedidos y direcciones con Mongoose.
  • Entorno: Express y MongoDB dentro de Compose, con variables de entorno y un volumen para los datos.
  • Problemas: cuando la API no encontraba la base de datos, revisé los nombres de servicio y desde dónde se ejecutaba cada cosa.

Era un proyecto académico en grupo. La tienda entera no es solo mía.

Las capas.

01React Interfaz del proyecto
02Express Rutas y controladores
03Servicios + Mongoose Reglas y modelos
04MongoDB Donde se guarda todo

Por qué separar las capas

La ruta recibe la petición, el controlador prepara la respuesta y el servicio hace la operación. El modelo dice cómo se guarda el dato. Así encuentro una regla sin tener que buscarla entre el código de HTTP.

Por qué Compose

La API y MongoDB se ven por una red compartida, y un volumen guarda los datos aunque se vuelva a crear el contenedor.

Una petición, paso a paso.

  1. Petición: entra por /api/productos, /api/usuarios o /api/pedidos.
  2. Capas: la ruta, el controlador y el servicio hacen cada uno su parte.
  3. Datos: los modelos guardan productos, usuarios, pedidos y direcciones en MongoDB.
  4. Entorno: Compose pone la red común y el volumen.

El código no es público y la tienda no funciona desde este porfolio.

Lo que aprendí.

Un nombre de servicio de Docker solo funciona dentro de su red. Me di cuenta buscando por qué la API no conectaba con MongoDB: el fallo no estaba en el código, sino en desde dónde se ejecutaba.

Siguiente paso

Documentaría las peticiones y respuestas de cada endpoint y añadiría validación, permisos y control de stock, para poder probar un pedido de principio a fin.

Fuente: Trabajo de API, modelos y Compose compartido durante el desarrollo de Silverline.