OrderFlow Commerce is an event-driven e-commerce REST API built with Java 21 and Spring Boot.
It simulates a real-world microservices architecture by processing orders asynchronously using RabbitMQ. After checkout, orders are handled in the background — inventory is reserved and confirmation emails are sent — without blocking the client.
Product & Category Management: CRUD operations with relational mapping
User Authentication: JWT-based security with role support (USER, ADMIN)
Shopping Cart: Persistent cart in PostgreSQL with hybrid caching (Redis)
Checkout & Order Processing: Order creation with event publication
Event-Driven Architecture: Decoupled order processing via RabbitMQ
Resilience: Circuit breaker pattern with Resilience4j
Containerized Environment: Run everything with Docker Compose
API Documentation: Interactive Swagger UI
Layer Technology Language Java 21 Framework Spring Boot 3 Database PostgreSQL 15 ORM Spring Data JPA Security Spring Security + JWT Messaging RabbitMQ Caching Redis Resilience Resilience4j Containerization Docker Compose Testing JUnit 5, Mockito, Testcontainers
The system is built as a single Spring Boot application but follows an event-driven design.
Flow
User interacts with REST endpoints (products, cart, checkout)
Checkout creates an order and publishes an OrderCreated event to RabbitMQ
Consumers process the event asynchronously:
Inventory consumer reserves items (simulated)
Email consumer sends a confirmation email
This decouples order creation from time-consuming operations, improving responsiveness and scalability.
Diagram will be added soon
Prerequisites Docker Engine 24+ Docker Compose Git Steps
- Clone the repository
git clone https://github.com/dbfcode/orderflow-ecommerce-async-api.git
cd orderflow-ecommerce-async-api- Start the environment
docker-compose up --buildBuilds the application image
Starts all containers:
PostgreSQL → 5432
RabbitMQ → 5672 (AMQP), 15672 (UI)
Spring Boot → 8080
3. Access the services
Swagger UI: http://localhost:8080/swagger-ui.html
RabbitMQ: http://localhost:15672
user: orderflow
password: orderflow123
PostgreSQL:
host: localhost
port: 5432
database: orderflow
user: orderflow
password: orderflow123
4. Stop containers
docker-compose downUses spring-boot-devtools for auto-reload.
Rebuild if you change Dockerfile or pom.xml.
Access Swagger UI after starting the application.
Postman collection is available in /docs.
| Name | Role | Contributions |
|---|---|---|
| Diego Ferreira | Advanced Developer | RabbitMQ, checkout, Docker, Redis, resilience |
| Giovanna Caxias | Junior Developer | CRUD, JWT auth, cart, Swagger |
Portfolio project. Not licensed for commercial use.
Not accepting external contributions. Feel free to fork.
Built with Java and Docker