Watch the demo video here

A robust, production-ready e-commerce inventory management backend built with Java 17, Spring Boot, PostgreSQL, and Redis.

• Inventory management: create supply, reserve, cancel, query availability
• RESTful API with DTOs
• Redis caching and concurrency control
• JPA with PostgreSQL
• Docker and docker-compose support
• Integration tests

• Docker & Docker Compose

git clone https://github.com/CRYPTOcoderAS/Quarks-Commerce cd quarks-commerce docker-compose up --build

The app will be available at http://localhost:8080

• Configure src/main/resources/application.yml for your local DB/Redis
• Run with ./mvnw spring-boot:run

• POST /api/users — Create user
• GET /api/users/by-username/{username} — Get user by username
• GET /api/users/by-email/{email} — Get user by email
• POST /api/inventory/supply — Create item supply
• POST /api/inventory/reserve — Reserve item quantity
• POST /api/inventory/cancel — Cancel reservation
• GET /api/inventory/{itemId} — Query item availability

A Postman collection is provided in postman_collection.json. Import it into Postman to test all endpoints easily.

./mvnw test

MIT