How vanh251/omnichannel-e-commerce-platform works
This is a Java/Spring omnichannel e-commerce backend: web, mobile, and store clients share identity, catalog, inventory, order, and payment services. The principal workflow authenticates a customer, verifies catalog SKU and price, reserves stock while creating a pending order, then completes or compensates the order asynchronously from payment events; notification events are handled separately. The README documents the service boundaries and event flow, but most service implementations were not sampled, so those links cite the README rather than implying source inspection.
Main entry points: apigateway API gateway · orderinventoryservice Order and inventory · paymentservice Payment service · main Product catalog
Components 15
Entry and identity
- API gateway
api-gateway/src/main/java/com/example/apigateway - Identity service
identity-service/src/main/java/com/example/identityservice - Identity PostgreSQL
Catalog and inventory
- Product catalog
product-service/src/main - Product MongoDB
- Order and inventory
order-inventory-service/src/main/java/com/example/orderinventoryservice - Order PostgreSQL
Orders and payments
- Payment service
payment-service/src/main/java/com/example/paymentservice - Payment PostgreSQL
- payOS
Events and notifications
- RabbitMQ exchange and queues
- Notification service
notification-service/src/main/java/com/example/notificationservice - Notification MongoDB
- SMTP / Mailpit
Other components
- Web / mobile / store
Connections 21
- Web / mobile / store → API gateway: calls REST
README.md - API gateway → Identity service: routes REST
README.md - API gateway → Product catalog: routes REST
README.md - API gateway → Order and inventory: routes REST
README.md - API gateway → Payment service: routes REST
README.md - Identity service → Identity PostgreSQL: stores identity
README.md - Identity service → RabbitMQ exchange and queues: publishes outbox events
README.md - Product catalog → Product MongoDB: stores catalog
README.md - Order and inventory → Product catalog: verifies SKU and price
README.md - Product catalog → Order and inventory: returns product details
README.md - Order and inventory → Order PostgreSQL: stores orders and outbox
README.md - Order and inventory → RabbitMQ exchange and queues: publishes order events
README.md - RabbitMQ exchange and queues → Order and inventory: dispatches payment events
README.md - Payment service → Payment PostgreSQL: stores payment and outbox
README.md - Payment service → payOS: creates links and reconciles
README.md - payOS → API gateway: sends webhook
README.md - Payment service → RabbitMQ exchange and queues: publishes payment events
README.md - RabbitMQ exchange and queues → Payment service: dispatches order events
README.md - RabbitMQ exchange and queues → Notification service: dispatches notification events
README.md - Notification service → Notification MongoDB: stores email jobs
README.md - Notification service → SMTP / Mailpit: sends transactional email
README.md