E-commerce Workshop

Welcome to the Workshop! This workshop aims to guide you through the process of building a microservices-based e-commerce system using Java, Spring Boot, Kafka, and Docker. By the end of this workshop, you will have a basic understanding of microservices architecture and hands-on experience in building and integrating multiple services.

System Overview

The e-commerce system consists of the following microservices:

Product Service: Manages product information, including CRUD operations for products.
Order Service: Handles order creation and processing
Email Service: Handles mock sending of emails

Setup Instructions

Follow the steps below to set up the e-commerce system on your local machine:

Prerequisites

Make sure you have the following prerequisites installed on your system:

Java Development Kit (JDK) 11 or later:
- Download and install the JDK from the Oracle website or adopt OpenJDK.
- Set up the JAVA_HOME environment variable to point to the JDK installation directory.
Apache Maven:
- Download and install Maven from the Apache Maven website.
- Add Maven to your system's PATH environment variable.
Docker:
- Install Docker Desktop based on your operating system:
  - For Windows: Docker Desktop for Windows
  - For macOS: Docker Desktop for Mac
  - For Linux: Follow the appropriate instructions for your Linux distribution.
IntelliJ IDEA:
- Download and install IntelliJ IDEA Community Edition from the JetBrains website.
- Follow the installation wizard instructions to complete the setup.

Steps

Follow the steps below to set up the e-commerce system on your local machine:

Clone the repository:

git clone https://github.com/Joeoh/MicroServices-Workshop.git

cd MicroServices-Workshop

Set up the Kafka environment:

cd kafka docker-compose up -d
Import the projects into IntelliJ IDEA:
- Open IntelliJ IDEA and choose "Open" or "Import" from the welcome screen.
- Navigate to the root directory of each microservice project (product-service, order-service, etc.) and select the respective pom.xml file.
- Follow the prompts to import the projects and let IntelliJ IDEA download the necessary dependencies.
Build the microservices:
- Open the Maven Projects tool window in IntelliJ IDEA.
- Expand each microservice project and navigate to "Lifecycle" -> "install".
- Click the "Execute Maven Goal" button to build each project.
Start the services from within Intellij:
- Open the Application class for the service (EmailServiceApplication,OrderServiceApplication, ServiceRegistrationService)
- Right click on the main method and run
Access the services:
- Each microservice can be accessed using the following URLs:
  - Product Service: http://localhost:2222
  - Order Service: http://localhost:2223
  - Email Service: http://localhost:2224
- Use a tool like cURL or Postman to interact with the services' REST APIs.
Accessing the services:

Here we're going to use cURL to access the services via the command line. You can also use tools such as Postman

Product Service

Create a new product:

curl -X POST -H "Content-Type: application/json" -d '{"name":"Product Name", "price": 10.99}' http://localhost:2222/products

Get a product by ID:

curl http://localhost:2222/products/{product-id}

Update a product:

curl -X PUT -H "Content-Type: application/json" -d '{"name":"Updated Product Name", "price": 19.99}' http://localhost:2222/products/{product-id}

Delete a product:

curl -X DELETE http://localhost:2222/products/{product-id}

Order Service

Create a new order:

curl -X POST -H "Content-Type: application/json" -d '{"orderId": "order-123", "customerId": 456, "productId": 1, "quantity": 2}' http://localhost:2223/orders

Get an order by ID:

curl http://localhost:2223/orders/{order-id}

Update an order:

curl -X PUT -H "Content-Type: application/json" -d '{"quantity": 3}' http://localhost:2223/orders/{order-id}

Delete an order:

curl -X DELETE http://localhost:2223/orders/{order-id}

Please replace {product-id}, {order-id}, and any other placeholders with the actual IDs or values you want to use in the commands.