How jamalnihal07/coffee-shop-microservices works
Coffee Shop is a Spring Boot microservices backend for identity, customer records, order fulfillment, and payments. The principal flow is a customer request through the gateway to create an order, followed by an order-created Kafka event, payment processing, and a payment-result event that advances or cancels the order; staff then progress paid orders through fulfillment. Separate branches cover Keycloak-backed user management, customer CRUD and rewards, read-only payment queries, and service discovery. The README documents routes and integrations; edges involving unsampled gateway, listener, and publisher wiring are shown only where documented.
Main entry points: ApiGatewayApplication.java API gateway · OrderService.java Order lifecycle and saga · PaymentProcessor.java Payment processing · UserService.java User and token workflows
Components 25
API edge and discovery
- API gateway
api-gateway/src/main/java/com/coffeeshop/gateway/ApiGatewayApplication.java - JWT and routes
api-gateway/src/main/java/com/coffeeshop/gateway/config/SecurityConfig.java - Rate limit and logs
api-gateway/src/main/java/com/coffeeshop/gateway/filter/RateLimitFilter.java - Eureka registry
eureka-server/src/main/java/com/coffeeshop/eureka/EurekaServerApplication.java
Identity and access
- Keycloak
- User API
user-service/src/main/java/com/coffeeshop/user/web/UserController.java - User and token workflows
user-service/src/main/java/com/coffeeshop/user/service/UserService.java - Identity provider client
user-service/src/main/java/com/coffeeshop/user/keycloak/KeycloakClient.java - User database
user-service/src/main/java/com/coffeeshop/user/repo/UserRepository.java
Customer records
- Customer API
customer-service/src/main/java/com/coffeeshop/customer/web/CustomerController.java - Customer CRUD and rewards
customer-service/src/main/java/com/coffeeshop/customer/service/CustomerService.java - Customer database
customer-service/src/main/java/com/coffeeshop/customer/repo/CustomerRepository.java
Orders and payments
- Order API
order-service/src/main/java/com/coffeeshop/order/web/OrderController.java - Order lifecycle and saga
order-service/src/main/java/com/coffeeshop/order/service/OrderService.java - Order database
order-service/src/main/java/com/coffeeshop/order/repo/OrderRepository.java - Outbound event publisher
order-service/src/main/java/com/coffeeshop/order/messaging/OutboundEventPublisher.java - Order-created listener
payment-service/src/main/java/com/coffeeshop/payment/messaging/OrderCreatedListener.java - Payment processing
payment-service/src/main/java/com/coffeeshop/payment/service/PaymentProcessor.java - Simulated payment gateway
payment-service/src/main/java/com/coffeeshop/payment/service/SimulatedPaymentGateway.java - Payment database
payment-service/src/main/java/com/coffeeshop/payment/repo/PaymentRepository.java - Payment queries
payment-service/src/main/java/com/coffeeshop/payment/web/PaymentController.java - Payment result events
payment-service/src/main/java/com/coffeeshop/payment/messaging/OrderCreatedListener.java - Payment result listener
order-service/src/main/java/com/coffeeshop/order/messaging/PaymentResultListener.java
Other components
- Frontend / clients
- Kafka topics
Connections 27
- Frontend / clients → API gateway: sends requests
README.md - API gateway → JWT and routes: validates and routes
README.md - API gateway → Rate limit and logs: limits and logs
README.md - API gateway → Eureka registry: discovers services
README.md - API gateway → User API: routes users
README.md - API gateway → Customer API: routes customers
README.md - API gateway → Order API: routes orders
README.md - API gateway → Payment queries: routes payments
README.md - User API → User and token workflows: delegates to
user-service/src/main/java/com/coffeeshop/user/web/UserController.java - User and token workflows → Identity provider client: calls identity provider
user-service/src/main/java/com/coffeeshop/user/service/UserService.java - Identity provider client → Keycloak: manages identities
user-service/src/main/java/com/coffeeshop/user/keycloak/KeycloakClient.java - User and token workflows → User database: reads and writes
user-service/src/main/java/com/coffeeshop/user/service/UserService.java - Customer API → Customer CRUD and rewards: delegates to
customer-service/src/main/java/com/coffeeshop/customer/web/CustomerController.java - Customer CRUD and rewards → Customer database: reads and writes
customer-service/src/main/java/com/coffeeshop/customer/service/CustomerService.java - Customer CRUD and rewards → Kafka topics: publishes customer-created
customer-service/src/main/java/com/coffeeshop/customer/service/CustomerService.java - Order API → Order lifecycle and saga: delegates to
order-service/src/main/java/com/coffeeshop/order/web/OrderController.java - Order lifecycle and saga → Order database: reads and writes
order-service/src/main/java/com/coffeeshop/order/service/OrderService.java - Order lifecycle and saga → Kafka topics: emits order events
README.md - Order lifecycle and saga → Outbound event publisher: publishes after commit
README.md - Kafka topics → Order-created listener: delivers order-created
README.md - Order-created listener → Payment processing: dispatches payment
README.md - Payment processing → Simulated payment gateway: charges payment
README.md - Payment processing → Payment database: records payment
README.md - Payment processing → Kafka topics: publishes payment result
README.md - Kafka topics → Payment result listener: delivers payment result
README.md - Payment result listener → Order lifecycle and saga: advances or cancels
README.md - Payment queries → Payment database: queries payments
payment-service/src/main/java/com/coffeeshop/payment/web/PaymentController.java