UNIR Shop es un sistema de gestión de pedidos y compras de libros implementado como un conjunto de microservicios. Cada microservicio se encarga de una parte específica de la funcionalidad del sistema, como la gestión de libros, solicitudes y el servicio de pasarela.
El proyecto se compone de los siguientes microservicios:
- Requests: Gestión de solicitudes de libros.
- Eureka: Servicio de descubrimiento de Eureka.
- Gateway: Servicio de puerta de enlace.
- Books: Gestión de libros.
- Spring Boot Starter Parent 3.2.0
- Spring Cloud 2023.0.0
- Springdoc OpenAPI Web MVC UI 2.2.0
Los microservicios requests
y books
son los dos microservicios del proyecto, ambos integrados y gestionados a través del Eureka Service Discovery. La configuración inicial ha sido actualizada para utilizar una base de datos Postgres.
- Base de datos Postgres.
- Registro en Eureka Service Discovery.
- Base de datos Postgres.
- Registro en Eureka Service Discovery.
Para iniciar los servicios con la base de datos Postgres, sigue estos pasos:
-
Navega a la carpeta del microservicio correspondiente utilizando el comando
cd
. Por ejemplo, para el servicio de libros ycd books
cd requests
-
Dentro de la carpeta de los microservicio, ejecuta el siguiente comando para iniciar los servicios con Docker Compose:
docker compose --profile db up -d
-
Luego se puede iniciar cada microservicio
mvn spring-boot:run -Dspring-boot.run.profiles=postgres
Estos comandos aseguran que los microservicios se inicien correctamente y establezcan la conexión con la base de datos Postgres.
- Libros Filtrados: Filtrar libros por autor y nombre. (
GET /api/v1/books/
) - Todos los Libros: Listar todos los libros disponibles. (
GET /api/v1/books/
) - Verificar Carrito de Compras: Verificar los libros en el carrito de compras. (
POST /api/v1/books/verify
) - Compra: Realizar una solicitud de compra de libros. (
POST /api/v1/books/request
) - Cambiar Disponibilidad de Libros: Cambiar la disponibilidad de los
libros. (
POST /api/v1/books/changeAvailability
) - Entre otros
- Documentación API: Disponible a través de OpenAPI en
http://127.0.0.1:8082/v3/api-docs
.
- Todas las Solicitudes: Listar todas las solicitudes.
- HealthCheck de Solicitudes: Verificar el estado del servicio de solicitudes.
- Crear Petición de Libros: Enviar una nueva petición de libros.
- Eliminar Solicitud de Libros: Eliminar una solicitud de libros
existente. (
DELETE /api/v1/requests/{uuid}
) - Documentación API: Disponible a través de OpenAPI en
http://127.0.0.1:8081/v3/api-docs
.
La documentación de la API para ambos servicios está disponible a través de Swagger UI:
- Para el servicio de libros (Books Service):
http://127.0.0.1:8082/swagger-ui/index.html
- Para el servicio de solicitudes (Requests Service):
http://127.0.0.1:8081/swagger-ui/index.html
- Clonar el repositorio desde GitHub.
- Asegurarse de tener Maven y Java instalados.
- Ejecutar cada microservicio usando Maven, por ejemplo:
mvn spring-boot:run
en cada directorio de microservicio con el profile activo postgres. - Acceder a la interfaz de Swagger para interactuar con la API.
El link del video se encuentra en el archivo video.txt o en el siguiente link Link video
Las contribuciones al proyecto son bienvenidas despues de la entrega ya que es necesario que para la calificacion unicamente los participantes del grupo colaboren. Se sugiere seguir las prácticas comunes de desarrollo colaborativo utilizando GitHub (forks, pull requests, issues).