How tahaberkamcadev/ecom works
This is an event-driven e-commerce backend. A client enters through the JWT-protected gateway; inventory handles strongly consistent checkout and stock reservation. Outbox events reach Kafka through Debezium, where order and payment services choreograph the purchase saga, including cancellation compensation. Projection service maintains CQRS catalog and order read APIs, with Redis caching and Elasticsearch search; user and review services provide account and review capabilities. The runtime links below follow README-documented flows; unsampled implementation details are not asserted.
Main entry points: JwtAuthenticationFilter.java API gateway · ProductQueryService.java Projection APIs · ProductService.java Inventory and checkout · Order.java Order service
Components 13
API edge
- API gateway
api-gateway/src/main/java/com/tahaberkamcadev/api_gateway/security/JwtAuthenticationFilter.java
Commerce services
- User service
user-service/src/main/java/com/tahaberkamcadev/e_com/user_service/service/AuthService.java - Inventory and checkout
inventory-service/src/main/java/com/tahaberkamcadev/inventory_service/service/ProductService.java - Review service
review-service/src/main/java/com/tahaberkamcadev/review_service/service/ReviewService.java
Purchase saga
- Order service
order-service/src/main/java/com/tahaberkamcadev/order_service/entity/Order.java - Payment service
payment-service/src/main/java/com/tahaberkamcadev/payment_service/service/PaymentService.java
Read models
- Projection APIs
projection-service/src/main/java/com/tahaberkamcadev/projection_service/service/ProductQueryService.java
Messaging and stores
- Kafka
- Debezium CDC
- PostgreSQL
- Redis
- Elasticsearch
Other components
- E-commerce client
Connections 26
- E-commerce client → API gateway: sends requests
README.md - API gateway → User service: routes auth
README.md - API gateway → Inventory and checkout: routes commerce
README.md - API gateway → Review service: routes reviews
README.md - API gateway → Projection APIs: routes catalog
README.md - API gateway → Redis: limits requests
README.md - E-commerce client → API gateway: requests purchase
README.md - API gateway → Inventory and checkout: forwards purchase
README.md - Inventory and checkout → PostgreSQL: reserves stock
README.md - Inventory and checkout → Debezium CDC: writes outbox
README.md - Order service → PostgreSQL: writes orders
README.md - Order service → Debezium CDC: writes outbox
README.md - Payment service → PostgreSQL: writes payments
README.md - Payment service → Debezium CDC: writes outbox
README.md - Review service → PostgreSQL: stores reviews
README.md - Review service → Debezium CDC: writes outbox
README.md - Debezium CDC → Kafka: publishes events
README.md - Kafka → Order service: delivers saga events
README.md - Kafka → Payment service: delivers saga events
README.md - Kafka → Inventory and checkout: delivers compensation
README.md - Kafka → Projection APIs: delivers projection events
README.md - Projection APIs → PostgreSQL: stores read models
README.md - Projection APIs → Elasticsearch: indexes products
README.md - Projection APIs → Redis: caches details
README.md - API gateway → Order service: no public routes
README.md - API gateway → Payment service: no public routes
README.md