Skip to content
isinning1 edited this page May 18, 2025 · 5 revisions

Entrega Parcial Práctico – MISW4403

parcial práctico del curso MISW4403 – Diseño y Construcción de APIs.


1. Descripción general del proyecto

Se desarrolló una API RESTful utilizando el framework NestJS, cuyo objetivo es gestionar entidades de tipo biblioteca, libro y la asociación muchos-a-muchos entre ambas. La solución cumple con los requerimientos funcionales, técnicos y de pruebas solicitados en el enunciado oficial del parcial.


2. Estructura de entrega

La entrega incluye los siguientes componentes:

a. Código fuente completo

Ubicado en el repositorio principal del proyecto. La estructura del código incluye:

  • Controladores (.controller.ts)
  • Servicios (.service.ts)
  • Entidades (.entity.ts)
  • DTOs (.dto.ts)
  • Pruebas unitarias (.spec.ts)

Se organiza en tres módulos:

  • biblioteca/
  • libro/
  • biblioteca-libro/

3. Pruebas unitarias

Se implementaron pruebas unitarias con Jest. El resultado de npm run test:cov arrojó una cobertura superior al 80% en líneas, funciones y ramas.

Los módulos probados son:

  • Biblioteca
  • Libro
  • Asociación Biblioteca-Libro

4. Colecciones Postman

Se diseñaron y entregaron 3 colecciones independientes, cubriendo operaciones válidas e inválidas:

Colección Archivo
Bibliotecas Bibliotecas.postman_collection.json
Libros Libros.postman_collection.json
Biblioteca-Libro Bibliotecas-Libros.postman_collection.json

Incluyen:

  • Variables de entorno (baseUrl, libraryId, bookId, etc.)
  • Scripts pre-request para automatizar datos
  • Tests de validación de código de estado y mensajes
  • Pruebas de errores como ID inválido, formatos incorrectos y asociaciones inexistentes

Se adjuntó también el archivo de entorno:


5. Release en GitHub

Se creó un release oficial con los siguientes datos:

  • Tag: v1.0.0
  • Título: parcial-practico
  • Descripción: resumen de los contenidos entregados
  • Archivo adjunto: .zip del proyecto

6. Validaciones importantes

  • La API responde correctamente en todos los endpoints
  • Las validaciones de los DTO están activas y funcionan
  • Los errores 400 y 404 se devuelven con mensajes claros y controlados
  • Las pruebas Postman cubren tanto escenarios exitosos como fallidos
  • La relación muchos-a-muchos funciona correctamente