https://github.com/nirmalks/bookstore-microservices

Microservices version of the bookstore. Converted from the monolith version - https://github.com/nirmalks/bookstore-spring-be
https://github.com/nirmalks/bookstore-microservices

java spring-boot spring-boot-cloud spring-boot-oauth2 spring-cloud spring-cloud-gateway spring-data-jpa spring-eureka spring-mvc swagger

Last synced: about 2 months ago
JSON representation

Microservices version of the bookstore. Converted from the monolith version - https://github.com/nirmalks/bookstore-spring-be

Host: GitHub
URL: https://github.com/nirmalks/bookstore-microservices
Owner: nirmalks
Created: 2025-08-13T05:13:00.000Z (11 months ago)
Default Branch: main
Last Pushed: 2025-11-19T10:05:18.000Z (7 months ago)
Last Synced: 2025-11-19T12:06:47.247Z (7 months ago)
Topics: java, spring-boot, spring-boot-cloud, spring-boot-oauth2, spring-cloud, spring-cloud-gateway, spring-data-jpa, spring-eureka, spring-mvc, swagger
Language: Java
Homepage:
Size: 243 KB
Stars: 0
Watchers: 0
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

Bookstore APi using Microservices

- Bookstore API using microservices architecture . Converted from the monolith version -https://github.com/nirmalks/bookstore-spring-be
- Backend Stack: Spring Boot, Spring Security (JWT), Spring Data JPA, PostgreSQL, Flyway, Spring Eureka client, Spring Eureka server, Spring Cloud gateway, Spring Boot Oauth2, Spring Webflux
- Tools & Libraries: Swagger

Key Features

* RESTful APIs for managing books, authors, users, orders, carts, and genres
* JWT-based authentication and role-based authorization (user, admin)
* Advanced book search with filtering and pagination using JPA Specifications
* Swagger documentation for API testing
* Flyway integration for consistent DB migrations

Admin Capabilities
* Add or update books, authors, and genres

User Capabilities
* Register, log in, and manage account profile
* Browse and search books
* Add items to cart and place orders
* View orders

## Running with Docker

This project is containerized using Docker and Docker Compose. It includes the Microservices (Spring Boot), Databases (PostgreSQL), and Observability stack (Prometheus, Grafana, Zipkin).

### Prerequisites
* [Docker](https://www.docker.com/get-started) and [Docker Compose](https://docs.docker.com/compose/install/) installed on your machine.
* Java 17+ (if running Maven locally).

### 1. Build the Artifacts
Before building the Docker images, ensure the JAR files are generated for each service. Run the following command from the root directory:

```bash
./mvnw clean package -DskipTests
```
2. Directory Setup

Ensure the following monitoring configuration files exist in the root directory before starting:

prometheus.yml
alert.rules.yml
alertmanager/alertmanager.yml

3. Start the Containers

Build the images and start all infrastructure services:
```bash
docker-compose up -d --build
```
4. Startup Sequence

Databases (User, Catalog, Checkout) initialize.
Discovery Service (Eureka) starts.
Config Server waits for Discovery.
Microservices & API Gateway start once the core services are healthy.

## Accessing the Application

## swagger
* User service - http://localhost:8081/swagger-ui/index.html
* Catalog service - http://localhost:8082/swagger-ui/index.html
* Checkout service - http://localhost:8083/swagger-ui/index.html

## Stopping the Application
To stop all containers and remove the network:

```bash
docker-compose down
```
To stop and remove database volumes (reset all data):

```bash
docker-compose down -v
```

## Screenshots

### Zipkin

Log with traceid in gateway
gateway-log