Product Service is a microservice responsible for managing products in the MicroServiceGrid ecosystem.
Built with Spring Boot 3 and MongoDB, it provides public and admin endpoints with pagination, sorting, and batch operations.

• Public API to fetch products (enabled only)
• Admin API to create, update, delete, enable/disable products
• Batch operations for create/delete
• Pagination and sorting support
• Soft delete via enable/disable

• Java 21
• Spring Boot 3
• Spring Data MongoDB
• Lombok
• Maven/Gradle
• Docker for containerization

PRODUCT-SERVICE/
├── .github/workflows         # CI/CD configurations
├── .idea                     # IDE settings
├── .mvn/wrapper              # Maven Wrapper
├── docker-compose-examples   # docker-compose files for local setup
├── src/
│   ├── main/
│   │   ├── java/com/akul/microservices/product
│   │   │   ├── controller   # REST controllers (Public + Admin)
│   │   │   ├── dto          # Data Transfer Objects
│   │   │   ├── exception    # custom exceptions
│   │   │   ├── model        # entities/models
│   │   │   ├── repository   # MongoDB repositories
│   │   │   └── service      # business logic
│   │   └── resources        # application.properties, configurations
│   └── test/
│       └── java/com/akul/microservices/product

1️⃣ Clone the repository:

git clone https://github.com/Andrij72/product-service.git

2️⃣ Start MongoDB (local, for tests):

docker run -d -p 27017:27017 --name mongodb mongo:latest

Or use the prepared docker-compose files:

docker-compose-examples/
├── docker-compose.local.yml       # local MongoDB + build from local Dockerfile
├── docker-compose.override.yml    # additional local settings for IntelliJ Run
├── docker-compose.dev-latest.yml  # development: MongoDB + latest dev image
└── docker-compose.prod.yml        # production: MongoDB + verified release image

3️⃣ Run the service:

./mvnw spring-boot:run

or

./gradlew bootRun

Here is used SKU (Stock Keeping Unit) – a unique identifier for each product. It helps track inventory, sales, and product details easily.

Pagination: ?page=0&size=12 Sorting: fixed by sku, name, price, createdAt ascending

• Public API returns only enabled products.
• Admin API allows full product lifecycle management.*
• Batch delete expects a JSON array of SKUs:

["SKU123", "SKU456", "SKU789"]

To simplify API testing and avoid duplicating request examples in the documentation, a ready-to-use Postman collection is provided with the project.

📁 Location in repository

The collection file is available in the root of the project:

Microservices product-service.postman_collection.json

• CI/CD via GitHub Actions
• develop → builds dev-latest Docker image
• main → builds latest Docker image
• Tests via Maven/Gradle; optional MongoDB ENV
• Docker images use SHA tags

Integration tests are implemented with JUnit 5, RestAssured, and Testcontainers (MongoDB 7.0.5). They cover:

• ✅ Creating a single product

• ✅ Creating multiple products in batch

• ✅ Retrieving all products

• ✅ Searching products by sku

Database is cleaned before each test run, and a dedicated MongoDB container starts automatically.