How kukushaa/order-platform works
Order Platform is a Spring Boot microservices system for authentication, user and product management, orders, payments, and email notifications. A key user workflow is registering or signing in, browsing products, initiating a purchase, and receiving an order/payment response; Kafka-backed notifications are also documented. The graph includes shared persistence and token-processing layers. Several services and integrations are represented from the README or file tree because their implementation was not excerpted; those relationships are omitted or marked unverified where wiring is not shown.
Main entry points: api_gateway API gateway · ProductsController.java Product endpoints · PaymentService.java Payment workflow · UsersService.java User operations
Components 29
API edge
- API gateway
api-gateway/src/main/java/com/kukusha/api_gateway
Commerce services
- Product endpoints
product-service/src/main/java/com/kukusha/product_service/controller/ProductsController.java - Product operations
product-service/src/main/java/com/kukusha/product_service/database/service/ProductsService.java - Product repository
product-service/src/main/java/com/kukusha/product_service/database/repository/ProductsRepository.java - PostgreSQL
- Payment client
product-service/src/main/java/com/kukusha/product_service/client/PaymentServiceClient.java - Payment endpoints
payment-service/src/main/java/com/kukusha/payment_service/controller/PaymentsController.java - Payment workflow
payment-service/src/main/java/com/kukusha/payment_service/service/PaymentService.java - Stripe integration
payment-service/src/main/java/com/kukusha/payment_service/service/StripeService.java - Stripe
- Payment records
payment-service/src/main/java/com/kukusha/payment_service/database/service/PaymentInfoService.java - PostgreSQL
- Order endpoints
orders-service/src/main/java/com/kukusha/orders_service/controller/OrdersController.java - Order operations
orders-service/src/main/java/com/kukusha/orders_service/database/service/OrdersService.java - Order repository
orders-service/src/main/java/com/kukusha/orders_service/database/repository/OrdersRepository.java - PostgreSQL
Identity and tokens
- Auth endpoints
auth-service/src/main/java/com/kukusha/auth_service/controller/AuthController.java - Authentication
auth-service/src/main/java/com/kukusha/auth_service/service/AuthService.java - Token processing
token-service/src/main/java/com/kukusha/token_service/service/TokenProcessorDriver.java - User endpoints
users-service/src/main/java/com/kukusha/users_service/controller/UsersController.java - User operations
users-shared-lib/src/main/java/com/kukusha/users_shared_lib/service/UsersService.java - User repository
users-shared-lib/src/main/java/com/kukusha/users_shared_lib/repository/UsersRepository.java - PostgreSQL
Messaging and email
- Kafka message API
kafka-messages-sender-api/src/main/java/com/kukusha/kafka_messages_sender/api/KafkaMessagesSenderAPI.java - Kafka
- Email consumer
email-sender-service/src/main/java/com/kukusha/email_service/kafka/KafkaMailSenderComponent.java - Mail delivery
email-sender-service/src/main/java/com/kukusha/email_service/service/MailService.java - Email templates
email-sender-service/src/main/java/com/kukusha/email_service/service/TemplatesService.java
Other components
- Platform user
Connections 33
- Platform user → API gateway: sends requests
README.md - API gateway → Auth endpoints: routes auth
README.md - API gateway → Product endpoints: routes products
README.md - API gateway → Payment endpoints: routes payments
README.md - API gateway → User endpoints: routes users
README.md - API gateway → Order endpoints: routes orders
README.md - Auth endpoints → Authentication: handles auth
auth-service/src/main/java/com/kukusha/auth_service/controller/AuthController.java - Auth endpoints → Kafka message API: publishes registration
auth-service/src/main/java/com/kukusha/auth_service/controller/AuthController.java - Authentication → User operations: checks and registers
auth-service/src/main/java/com/kukusha/auth_service/service/AuthService.java - Authentication → Token processing: creates tokens
auth-service/src/main/java/com/kukusha/auth_service/service/AuthService.java - User endpoints → User operations: reads and updates
users-service/src/main/java/com/kukusha/users_service/controller/UsersController.java - User operations → User repository: queries and saves
users-shared-lib/src/main/java/com/kukusha/users_shared_lib/service/UsersService.java - User repository → PostgreSQL: persists users
- Product endpoints → Product operations: manages products
product-service/src/main/java/com/kukusha/product_service/controller/ProductsController.java - Product endpoints → User operations: looks up buyer
product-service/src/main/java/com/kukusha/product_service/controller/ProductsController.java - Product endpoints → Payment client: requests payment
product-service/src/main/java/com/kukusha/product_service/controller/ProductsController.java - Product endpoints → Kafka message API: publishes product and order
product-service/src/main/java/com/kukusha/product_service/controller/ProductsController.java - Product operations → Product repository: queries and saves
product-service/src/main/java/com/kukusha/product_service/database/service/ProductsService.java - Product repository → PostgreSQL: persists products
- Payment client → Payment endpoints: calls payment service
- Payment endpoints → Payment workflow: handles payments
payment-service/src/main/java/com/kukusha/payment_service/controller/PaymentsController.java - Payment workflow → Stripe integration: creates or retrieves intent
payment-service/src/main/java/com/kukusha/payment_service/service/PaymentService.java - Stripe integration → Stripe: uses Stripe API
README.md - Payment workflow → Payment records: reads payment record
payment-service/src/main/java/com/kukusha/payment_service/service/PaymentService.java - Payment workflow → Token processing: creates payment token
payment-service/src/main/java/com/kukusha/payment_service/service/PaymentService.java - Payment records → PostgreSQL: persists payment info
- Order endpoints → Order operations: handles order operations
orders-service/src/main/java/com/kukusha/orders_service/controller/OrdersController.java - Order operations → Order repository: queries and saves
orders-service/src/main/java/com/kukusha/orders_service/database/service/OrdersService.java - Order repository → PostgreSQL: persists orders
- Kafka message API → Kafka: sends events
- Kafka → Email consumer: delivers events
README.md - Email consumer → Mail delivery: sends email
- Email consumer → Email templates: renders email