Simple Event-Driven Microservice Architecture in Rust

Overview

"Simple Event-Driven Microservice Architecture in Rust" is an open-source project showcasing the simplicity and efficiency of building microservices in Rust. This minimalistic project demonstrates an e-commerce backend system, featuring just two microservices: Catalog and Order.

Getting Started

Prerequisites

During the installation steps you will install the following dependencies when running install_prerequisites_macos.sh

Rust
Brew
Java
Kafka

Installation Steps (MacOs)

Set Executable Permissions
Open your terminal at the root of the project and run the following commands:
```
chmod +x .scripts/install_prerequisites_macos.sh
chmod +x pre_run.sh
```
Install Dependencies
Execute the script to install prerequisites:
```
./.scripts/install_prerequisites_macos.sh
```
Run Kafka Server
Start the Kafka server, which is used for event passing between microservices:
```
./pre_run.sh
```
Start Microservices
Run both the Catalog and Order microservices in separate terminal windows:

For Catalog Microservice:
```
(cd ./catalog_service && cargo run)
```
For Order Microservice:
```
(cd ./order_service && cargo run)
```

Usage

Once the server is operational, you can interact with the microservices through the following endpoints:

Catalog Microservice:
GET http://127.0.0.1:8081/catalog
Retrieves a JSON list of all available products.
Order Microservice:
POST http://127.0.0.1:8080/order
Creates an order in the system. Use the header Content-Type: application/json and the following JSON body structure:
```
{
"item_id": 1,
"name": "James",
"address": "22 Bugs Bunny Street, London, E1 4AH, United Kingdom",
"quantity": 1
}
```