The Inventory Management System is a distributed microservices-based application developed using Spring Boot and Spring Cloud. It is designed to simulate a real-world inventory/e-commerce platform, enabling seamless management of users, products, inventory, carts, and payments with high scalability and modularity.

• ✅ Service Discovery with Eureka Server
• ✅ API Gateway as a single entry point with routing & JWT validation
• ✅ User Authentication & Authorization with Spring Security + JWT
• ✅ Product Catalog Management (CRUD for products)
• ✅ Inventory Management (stock validation, search by location)
• ✅ Shopping Cart (add/remove/update cart items)
• ✅ Payment Processing integrated with Cart Service
• ✅ Independent databases per service (MySQL/H2)
• ✅ Centralized Exception Handling

• Port: 8761
• Purpose: Service registry
• Dashboard: http://localhost:8761

• Port: 8080
• Routes:
  • /user-service/** → USER-SERVICE
  • /product-service/** → PRODUCT-SERVICE
  • /inventory-service/** → INVENTORY-SERVICE
  • /cart-service/** → CART-SERVICE
  • /payment-service/** → PAYMENT-SERVICE
• Responsibilities: Routing, JWT validation

• Port: 8085
• Features:
  • POST /auth/login → Login & issue JWT
  • POST /auth/register → Register user
  • GET /users → Manage users
• Security: Spring Security + JWT

• Port: 8084
• Features:
  • POST /products → Create product
  • GET /products → List all
  • GET /products/{id} → By ID
  • PUT /products/{id} → Update
  • DELETE /products/{id} → Delete
  • GET /products/inventory/{invtId} → By inventory

• Port: 8083
• Features:
  • POST /inventory → Add record
  • GET /inventory → All inventories
  • GET /inventory/{id} → By ID
  • PUT /inventory/{id} → Update
  • DELETE /inventory/{id} → Delete
  • GET /inventory/inventoriesByLocation/{loc} → Filter by location

• Port: 8082
• Features:
  • POST /cart → Create new cart
  • GET /cart/{id} → Get cart by ID
  • DELETE /cart/{id} → Delete cart
  • POST /cart/{id}/items → Add item
  • GET /cart/{id}/items → List items
  • PUT /cart/{id}/items/{itemId} → Update item
  • DELETE /cart/{id}/items/{itemId} → Remove item
• Integration: Calls Product Service for product details

• Port: 8085
• Features:
  • POST /payments/checkout → Process payment for a cart
• Flow:
  1. Fetches cart via Cart Service
  2. Validates user & total amount
  3. Saves payment record

1. User logs in via User Service → JWT issued
2. Client includes JWT in request headers
3. API Gateway validates JWT
4. Request forwarded to relevant service
5. Services trust JWT-validated traffic only via Gateway

User Service DB

erDiagram
  USER {
    long user_id PK
    string username
    string password_hash
    string role
  }

Product Service DB

erDiagram
  PRODUCT {
    long product_id PK
    string product_name
    string category
    decimal price
  }

Inventory Service DB

erDiagram
  INVENTORY {
    long inventory_id PK
    string category
    string location
  }

Cart Service DB

erDiagram
  CART ||--o{ CART_ITEM : contains
  CART {
    long cart_id PK
    long user_id
  }
  CART_ITEM {
    long cart_item_id PK
    long cart_id FK
    long product_id
    int quantity
  }

Payment Service DB

erDiagram
  PAYMENT {
    long payment_id PK
    long user_id
    long cart_id
    decimal amount
    string payment_status
    string payment_mode
  }

• Java 17+
• Maven 3.8+
• MySQL running locally

# Build all services
mvn clean install

# Run each microservice
mvn spring-boot:run

• Eureka: 8761
• Gateway: 8080
• User: 8085
• Product: 8084
• Inventory: 8083
• Cart: 8082
• Payment: 8085

• Showcases real-world inventory management system
• Implements microservices best practices
• Demonstrates Spring Security & JWT
• Uses Eureka + Gateway for scalability
• Clean separation: each service has its own DB & logic