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
El caso
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.
Lo que hice
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.
Decisiones
Las capas.
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.
Pruebas
Una petición, paso a paso.
-
Petición: entra por
/api/productos,/api/usuarioso/api/pedidos. - Capas: la ruta, el controlador y el servicio hacen cada uno su parte.
- Datos: los modelos guardan productos, usuarios, pedidos y direcciones en MongoDB.
- 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.
Siguiente paso
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.