# kukushaa/order-platform architecture

> Architecture diagram of the GitHub repository kukushaa/order-platform, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kukushaa/order-platform
- Repository: https://github.com/kukushaa/order-platform

## Overview

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/src/main/java/com/kukusha/api_gateway`](https://github.com/kukushaa/order-platform/tree/main/api-gateway/src/main/java/com/kukusha/api_gateway) (API gateway), [`product-service/src/main/java/com/kukusha/product_service/controller/ProductsController.java`](https://github.com/kukushaa/order-platform/blob/main/product-service/src/main/java/com/kukusha/product_service/controller/ProductsController.java) (Product endpoints), [`payment-service/src/main/java/com/kukusha/payment_service/service/PaymentService.java`](https://github.com/kukushaa/order-platform/blob/main/payment-service/src/main/java/com/kukusha/payment_service/service/PaymentService.java) (Payment workflow), [`users-shared-lib/src/main/java/com/kukusha/users_shared_lib/service/UsersService.java`](https://github.com/kukushaa/order-platform/blob/main/users-shared-lib/src/main/java/com/kukusha/users_shared_lib/service/UsersService.java) (User operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_edge["API edge"]
  node_gateway["API gateway"]
end

subgraph group_commerce["Commerce services"]
  node_products_controller["Product endpoints"]
  node_products_service["Product operations"]
  node_products_repository["Product repository"]
  node_product_store[("PostgreSQL")]
  node_payment_client["Payment client"]
  node_payments_controller["Payment endpoints"]
  node_payment_service["Payment workflow"]
  node_stripe_service["Stripe integration<br/>[StripeService.java]"]
  node_stripe["Stripe"]
  node_payment_info_service["Payment records"]
  node_payment_store[("PostgreSQL")]
  node_orders_controller["Order endpoints"]
  node_orders_service["Order operations<br/>[OrdersService.java]"]
  node_orders_repository["Order repository"]
  node_orders_store[("PostgreSQL")]
end

subgraph group_identity["Identity and tokens"]
  node_auth_controller["Auth endpoints"]
  node_auth_service["Authentication<br/>[AuthService.java]"]
  node_token_driver["Token processing"]
  node_users_controller["User endpoints"]
  node_users_service["User operations<br/>[UsersService.java]"]
  node_users_repository["User repository"]
  node_user_store[("PostgreSQL")]
end

subgraph group_messaging["Messaging and email"]
  node_kafka_api["Kafka message API"]
  node_kafka["Kafka"]
  node_email_consumer["Email consumer"]
  node_mail_service["Mail delivery<br/>[MailService.java]"]
  node_templates["Email templates"]
end

node_buyer(("Platform user"))

node_buyer -->|"sends requests"| node_gateway
node_gateway -->|"routes auth"| node_auth_controller
node_gateway -->|"routes products"| node_products_controller
node_gateway -->|"routes payments"| node_payments_controller
node_gateway -->|"routes users"| node_users_controller
node_gateway -->|"routes orders"| node_orders_controller
node_auth_controller -->|"handles auth"| node_auth_service
node_auth_controller -->|"publishes registration"| node_kafka_api
node_auth_service -->|"checks and registers"| node_users_service
node_auth_service -->|"creates tokens"| node_token_driver
node_users_controller -->|"reads and updates"| node_users_service
node_users_service -->|"queries and saves"| node_users_repository
node_users_repository -.->|"persists users"| node_user_store
node_products_controller -->|"manages products"| node_products_service
node_products_controller -->|"looks up buyer"| node_users_service
node_products_controller -->|"requests payment"| node_payment_client
node_products_controller -->|"publishes product and order"| node_kafka_api
node_products_service -->|"queries and saves"| node_products_repository
node_products_repository -.->|"persists products"| node_product_store
node_payment_client -.->|"calls payment service"| node_payments_controller
node_payments_controller -->|"handles payments"| node_payment_service
node_payment_service -->|"creates or retrieves intent"| node_stripe_service
node_stripe_service -->|"uses Stripe API"| node_stripe
node_payment_service -->|"reads payment record"| node_payment_info_service
node_payment_service -->|"creates payment token"| node_token_driver
node_payment_info_service -.->|"persists payment info"| node_payment_store
node_orders_controller -->|"handles order operations"| node_orders_service
node_orders_service -->|"queries and saves"| node_orders_repository
node_orders_repository -.->|"persists orders"| node_orders_store
node_kafka_api -.->|"sends events"| node_kafka
node_kafka -->|"delivers events"| node_email_consumer
node_email_consumer -.->|"sends email"| node_mail_service
node_email_consumer -.->|"renders email"| node_templates

click node_gateway "https://github.com/kukushaa/order-platform/tree/main/api-gateway/src/main/java/com/kukusha/api_gateway"
click node_auth_controller "https://github.com/kukushaa/order-platform/blob/main/auth-service/src/main/java/com/kukusha/auth_service/controller/AuthController.java"
click node_auth_service "https://github.com/kukushaa/order-platform/blob/main/auth-service/src/main/java/com/kukusha/auth_service/service/AuthService.java"
click node_token_driver "https://github.com/kukushaa/order-platform/blob/main/token-service/src/main/java/com/kukusha/token_service/service/TokenProcessorDriver.java"
click node_users_controller "https://github.com/kukushaa/order-platform/blob/main/users-service/src/main/java/com/kukusha/users_service/controller/UsersController.java"
click node_users_service "https://github.com/kukushaa/order-platform/blob/main/users-shared-lib/src/main/java/com/kukusha/users_shared_lib/service/UsersService.java"
click node_users_repository "https://github.com/kukushaa/order-platform/blob/main/users-shared-lib/src/main/java/com/kukusha/users_shared_lib/repository/UsersRepository.java"
click node_products_controller "https://github.com/kukushaa/order-platform/blob/main/product-service/src/main/java/com/kukusha/product_service/controller/ProductsController.java"
click node_products_service "https://github.com/kukushaa/order-platform/blob/main/product-service/src/main/java/com/kukusha/product_service/database/service/ProductsService.java"
click node_products_repository "https://github.com/kukushaa/order-platform/blob/main/product-service/src/main/java/com/kukusha/product_service/database/repository/ProductsRepository.java"
click node_payment_client "https://github.com/kukushaa/order-platform/blob/main/product-service/src/main/java/com/kukusha/product_service/client/PaymentServiceClient.java"
click node_payments_controller "https://github.com/kukushaa/order-platform/blob/main/payment-service/src/main/java/com/kukusha/payment_service/controller/PaymentsController.java"
click node_payment_service "https://github.com/kukushaa/order-platform/blob/main/payment-service/src/main/java/com/kukusha/payment_service/service/PaymentService.java"
click node_stripe_service "https://github.com/kukushaa/order-platform/blob/main/payment-service/src/main/java/com/kukusha/payment_service/service/StripeService.java"
click node_payment_info_service "https://github.com/kukushaa/order-platform/blob/main/payment-service/src/main/java/com/kukusha/payment_service/database/service/PaymentInfoService.java"
click node_orders_controller "https://github.com/kukushaa/order-platform/blob/main/orders-service/src/main/java/com/kukusha/orders_service/controller/OrdersController.java"
click node_orders_service "https://github.com/kukushaa/order-platform/blob/main/orders-service/src/main/java/com/kukusha/orders_service/database/service/OrdersService.java"
click node_orders_repository "https://github.com/kukushaa/order-platform/blob/main/orders-service/src/main/java/com/kukusha/orders_service/database/repository/OrdersRepository.java"
click node_kafka_api "https://github.com/kukushaa/order-platform/blob/main/kafka-messages-sender-api/src/main/java/com/kukusha/kafka_messages_sender/api/KafkaMessagesSenderAPI.java"
click node_email_consumer "https://github.com/kukushaa/order-platform/blob/main/email-sender-service/src/main/java/com/kukusha/email_service/kafka/KafkaMailSenderComponent.java"
click node_mail_service "https://github.com/kukushaa/order-platform/blob/main/email-sender-service/src/main/java/com/kukusha/email_service/service/MailService.java"
click node_templates "https://github.com/kukushaa/order-platform/blob/main/email-sender-service/src/main/java/com/kukusha/email_service/service/TemplatesService.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_gateway,node_buyer toneBlue
class node_products_controller,node_products_service,node_products_repository,node_product_store,node_payment_client,node_payments_controller,node_payment_service,node_stripe_service,node_stripe,node_payment_info_service,node_payment_store,node_orders_controller,node_orders_service,node_orders_repository,node_orders_store toneAmber
class node_auth_controller,node_auth_service,node_token_driver,node_users_controller,node_users_service,node_users_repository,node_user_store toneMint
class node_kafka_api,node_kafka,node_email_consumer,node_mail_service,node_templates toneRose
```

## Components

### API edge

- [API gateway](https://github.com/kukushaa/order-platform/tree/main/api-gateway/src/main/java/com/kukusha/api_gateway): `api-gateway/src/main/java/com/kukusha/api_gateway`

### Commerce services

- [Product endpoints](https://github.com/kukushaa/order-platform/blob/main/product-service/src/main/java/com/kukusha/product_service/controller/ProductsController.java): `product-service/src/main/java/com/kukusha/product_service/controller/ProductsController.java`
- [Product operations](https://github.com/kukushaa/order-platform/blob/main/product-service/src/main/java/com/kukusha/product_service/database/service/ProductsService.java): `product-service/src/main/java/com/kukusha/product_service/database/service/ProductsService.java`
- [Product repository](https://github.com/kukushaa/order-platform/blob/main/product-service/src/main/java/com/kukusha/product_service/database/repository/ProductsRepository.java): `product-service/src/main/java/com/kukusha/product_service/database/repository/ProductsRepository.java`
- **PostgreSQL**
- [Payment client](https://github.com/kukushaa/order-platform/blob/main/product-service/src/main/java/com/kukusha/product_service/client/PaymentServiceClient.java): `product-service/src/main/java/com/kukusha/product_service/client/PaymentServiceClient.java`
- [Payment endpoints](https://github.com/kukushaa/order-platform/blob/main/payment-service/src/main/java/com/kukusha/payment_service/controller/PaymentsController.java): `payment-service/src/main/java/com/kukusha/payment_service/controller/PaymentsController.java`
- [Payment workflow](https://github.com/kukushaa/order-platform/blob/main/payment-service/src/main/java/com/kukusha/payment_service/service/PaymentService.java): `payment-service/src/main/java/com/kukusha/payment_service/service/PaymentService.java`
- [Stripe integration](https://github.com/kukushaa/order-platform/blob/main/payment-service/src/main/java/com/kukusha/payment_service/service/StripeService.java): `payment-service/src/main/java/com/kukusha/payment_service/service/StripeService.java`
- **Stripe**
- [Payment records](https://github.com/kukushaa/order-platform/blob/main/payment-service/src/main/java/com/kukusha/payment_service/database/service/PaymentInfoService.java): `payment-service/src/main/java/com/kukusha/payment_service/database/service/PaymentInfoService.java`
- **PostgreSQL**
- [Order endpoints](https://github.com/kukushaa/order-platform/blob/main/orders-service/src/main/java/com/kukusha/orders_service/controller/OrdersController.java): `orders-service/src/main/java/com/kukusha/orders_service/controller/OrdersController.java`
- [Order operations](https://github.com/kukushaa/order-platform/blob/main/orders-service/src/main/java/com/kukusha/orders_service/database/service/OrdersService.java): `orders-service/src/main/java/com/kukusha/orders_service/database/service/OrdersService.java`
- [Order repository](https://github.com/kukushaa/order-platform/blob/main/orders-service/src/main/java/com/kukusha/orders_service/database/repository/OrdersRepository.java): `orders-service/src/main/java/com/kukusha/orders_service/database/repository/OrdersRepository.java`
- **PostgreSQL**

### Identity and tokens

- [Auth endpoints](https://github.com/kukushaa/order-platform/blob/main/auth-service/src/main/java/com/kukusha/auth_service/controller/AuthController.java): `auth-service/src/main/java/com/kukusha/auth_service/controller/AuthController.java`
- [Authentication](https://github.com/kukushaa/order-platform/blob/main/auth-service/src/main/java/com/kukusha/auth_service/service/AuthService.java): `auth-service/src/main/java/com/kukusha/auth_service/service/AuthService.java`
- [Token processing](https://github.com/kukushaa/order-platform/blob/main/token-service/src/main/java/com/kukusha/token_service/service/TokenProcessorDriver.java): `token-service/src/main/java/com/kukusha/token_service/service/TokenProcessorDriver.java`
- [User endpoints](https://github.com/kukushaa/order-platform/blob/main/users-service/src/main/java/com/kukusha/users_service/controller/UsersController.java): `users-service/src/main/java/com/kukusha/users_service/controller/UsersController.java`
- [User operations](https://github.com/kukushaa/order-platform/blob/main/users-shared-lib/src/main/java/com/kukusha/users_shared_lib/service/UsersService.java): `users-shared-lib/src/main/java/com/kukusha/users_shared_lib/service/UsersService.java`
- [User repository](https://github.com/kukushaa/order-platform/blob/main/users-shared-lib/src/main/java/com/kukusha/users_shared_lib/repository/UsersRepository.java): `users-shared-lib/src/main/java/com/kukusha/users_shared_lib/repository/UsersRepository.java`
- **PostgreSQL**

### Messaging and email

- [Kafka message API](https://github.com/kukushaa/order-platform/blob/main/kafka-messages-sender-api/src/main/java/com/kukusha/kafka_messages_sender/api/KafkaMessagesSenderAPI.java): `kafka-messages-sender-api/src/main/java/com/kukusha/kafka_messages_sender/api/KafkaMessagesSenderAPI.java`
- **Kafka**
- [Email consumer](https://github.com/kukushaa/order-platform/blob/main/email-sender-service/src/main/java/com/kukusha/email_service/kafka/KafkaMailSenderComponent.java): `email-sender-service/src/main/java/com/kukusha/email_service/kafka/KafkaMailSenderComponent.java`
- [Mail delivery](https://github.com/kukushaa/order-platform/blob/main/email-sender-service/src/main/java/com/kukusha/email_service/service/MailService.java): `email-sender-service/src/main/java/com/kukusha/email_service/service/MailService.java`
- [Email templates](https://github.com/kukushaa/order-platform/blob/main/email-sender-service/src/main/java/com/kukusha/email_service/service/TemplatesService.java): `email-sender-service/src/main/java/com/kukusha/email_service/service/TemplatesService.java`

### Other components

- **Platform user**

## Connections

- Platform user → API gateway: sends requests (evidence: `README.md`)
- API gateway → Auth endpoints: routes auth (evidence: `README.md`)
- API gateway → Product endpoints: routes products (evidence: `README.md`)
- API gateway → Payment endpoints: routes payments (evidence: `README.md`)
- API gateway → User endpoints: routes users (evidence: `README.md`)
- API gateway → Order endpoints: routes orders (evidence: `README.md`)
- Auth endpoints → Authentication: handles auth (evidence: `auth-service/src/main/java/com/kukusha/auth_service/controller/AuthController.java`)
- Auth endpoints → Kafka message API: publishes registration (evidence: `auth-service/src/main/java/com/kukusha/auth_service/controller/AuthController.java`)
- Authentication → User operations: checks and registers (evidence: `auth-service/src/main/java/com/kukusha/auth_service/service/AuthService.java`)
- Authentication → Token processing: creates tokens (evidence: `auth-service/src/main/java/com/kukusha/auth_service/service/AuthService.java`)
- User endpoints → User operations: reads and updates (evidence: `users-service/src/main/java/com/kukusha/users_service/controller/UsersController.java`)
- User operations → User repository: queries and saves (evidence: `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 (evidence: `product-service/src/main/java/com/kukusha/product_service/controller/ProductsController.java`)
- Product endpoints → User operations: looks up buyer (evidence: `product-service/src/main/java/com/kukusha/product_service/controller/ProductsController.java`)
- Product endpoints → Payment client: requests payment (evidence: `product-service/src/main/java/com/kukusha/product_service/controller/ProductsController.java`)
- Product endpoints → Kafka message API: publishes product and order (evidence: `product-service/src/main/java/com/kukusha/product_service/controller/ProductsController.java`)
- Product operations → Product repository: queries and saves (evidence: `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 (evidence: `payment-service/src/main/java/com/kukusha/payment_service/controller/PaymentsController.java`)
- Payment workflow → Stripe integration: creates or retrieves intent (evidence: `payment-service/src/main/java/com/kukusha/payment_service/service/PaymentService.java`)
- Stripe integration → Stripe: uses Stripe API (evidence: `README.md`)
- Payment workflow → Payment records: reads payment record (evidence: `payment-service/src/main/java/com/kukusha/payment_service/service/PaymentService.java`)
- Payment workflow → Token processing: creates payment token (evidence: `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 (evidence: `orders-service/src/main/java/com/kukusha/orders_service/controller/OrdersController.java`)
- Order operations → Order repository: queries and saves (evidence: `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 (evidence: `README.md`)
- Email consumer → Mail delivery: sends email
- Email consumer → Email templates: renders email
