# seyrit16/marketplace architecture

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

- Interactive diagram: https://gitdiagram.com/seyrit16/marketplace
- Repository: https://github.com/seyrit16/marketplace

## Overview

Marketplace is a five-service Spring Boot marketplace. Buyers authenticate, browse and search products, add items to a Redis-backed cart, then place orders; sellers manage profiles and listings, while pickup-point operators process orders. The README documents PostgreSQL per service, Elasticsearch search, Redis caching, and HTTP/Feign and Kafka communication. The source excerpts are unavailable, so service-to-service call directions and specific message flows are not asserted; broad capability links reflect README documentation.

Main entry points: [`redis_service/src/main/java/com/example/redis_service/service/impl/RedisServiceImpl.java`](https://github.com/seyrit16/marketplace/blob/master/redis_service/src/main/java/com/example/redis_service/service/impl/RedisServiceImpl.java) (Redis Service), [`user_service/src/main/java/com/example/user_service`](https://github.com/seyrit16/marketplace/tree/master/user_service/src/main/java/com/example/user_service) (User Service), [`seller_service/src/main/java/com/example/seller_service/service/impl/SellerServiceImpl.java`](https://github.com/seyrit16/marketplace/blob/master/seller_service/src/main/java/com/example/seller_service/service/impl/SellerServiceImpl.java) (Seller Profiles), [`product_service/src/main/java/com/example/product_service/service/impl/ProductServiceImpl.java`](https://github.com/seyrit16/marketplace/blob/master/product_service/src/main/java/com/example/product_service/service/impl/ProductServiceImpl.java) (Product Catalog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and Roles"]
  node_user_api["User API"]
  node_user_service["User Service"]
  node_seller_api["Seller API"]
  node_seller_service["Seller Profiles"]
end

subgraph group_catalog["Seller and Catalog"]
  node_product_api["Product API"]
  node_category_api["Category API"]
  node_product_service["Product Catalog"]
  node_search_api["Search API"]
  node_search_service["Product Search"]
  node_image_api["Image API"]
  node_file_api["File API"]
  node_file_storage["Image Storage"]
end

subgraph group_commerce["Orders and Fulfillment"]
  node_cart_api["Cart API"]
  node_cart_service["Cart Service"]
  node_order_api["Order API"]
  node_order_service["Order Service"]
  node_item_api["Order Item API"]
  node_pickup_api["Pickup API"]
  node_pickup_service["Pickup Points"]
  node_payment_api["Payment API"]
  node_payment_service["Payment Service"]
end

subgraph group_platform["Shared Infrastructure"]
  node_redis_service["Redis Service"]
  node_redis_store[("Redis")]
  node_elasticsearch[("Elasticsearch")]
  node_postgres[("PostgreSQL Databases")]
  node_kafka["Kafka"]
end

node_buyer(("Buyer"))
node_seller(("Seller"))
node_operator(("Pickup Operator"))

node_buyer -->|"registers / authenticates"| node_user_api
node_buyer -->|"searches products"| node_search_api
node_seller -->|"manages profile"| node_seller_api
node_seller -->|"manages listings"| node_product_api
node_buyer -->|"manages cart"| node_cart_api
node_buyer -->|"places orders"| node_order_api
node_operator -->|"processes orders"| node_item_api
node_operator -->|"manages pickup"| node_pickup_api
node_search_service -->|"searches and filters"| node_elasticsearch
node_cart_service -->|"caches cart"| node_redis_store
node_redis_service -->|"stores temporary state"| node_redis_store
node_user_service -->|"uses own database"| node_postgres
node_seller_service -->|"uses own database"| node_postgres
node_product_service -->|"uses own database"| node_postgres
node_order_service -->|"uses own database"| node_postgres
node_redis_service -->|"uses own database"| node_postgres
node_image_api -->|"stores images"| node_file_storage
node_file_api -->|"serves local files"| node_file_storage
node_user_service -.->|"communicates asynchronously"| node_kafka
node_seller_service -.->|"communicates asynchronously"| node_kafka
node_product_service -.->|"communicates asynchronously"| node_kafka
node_order_service -.->|"communicates asynchronously"| node_kafka
node_redis_service -.->|"communicates asynchronously"| node_kafka

click node_user_api "https://github.com/seyrit16/marketplace/tree/master/user_service/src/main/java/com/example/user_service/controller"
click node_user_service "https://github.com/seyrit16/marketplace/tree/master/user_service/src/main/java/com/example/user_service"
click node_seller_api "https://github.com/seyrit16/marketplace/blob/master/seller_service/src/main/java/com/example/seller_service/controller/SellerController.java"
click node_seller_service "https://github.com/seyrit16/marketplace/blob/master/seller_service/src/main/java/com/example/seller_service/service/impl/SellerServiceImpl.java"
click node_product_api "https://github.com/seyrit16/marketplace/blob/master/product_service/src/main/java/com/example/product_service/controller/ProductController.java"
click node_category_api "https://github.com/seyrit16/marketplace/blob/master/product_service/src/main/java/com/example/product_service/controller/CategoryController.java"
click node_product_service "https://github.com/seyrit16/marketplace/blob/master/product_service/src/main/java/com/example/product_service/service/impl/ProductServiceImpl.java"
click node_search_api "https://github.com/seyrit16/marketplace/blob/master/product_service/src/main/java/com/example/product_service/controller/SearchController.java"
click node_search_service "https://github.com/seyrit16/marketplace/blob/master/product_service/src/main/java/com/example/product_service/service/impl/ProductSearchServiceImpl.java"
click node_image_api "https://github.com/seyrit16/marketplace/blob/master/product_service/src/main/java/com/example/product_service/controller/ProductImageController.java"
click node_file_api "https://github.com/seyrit16/marketplace/blob/master/product_service/src/main/java/com/example/product_service/controller/FileController.java"
click node_file_storage "https://github.com/seyrit16/marketplace/blob/master/product_service/src/main/java/com/example/product_service/service/impl/LocalFileStorageServiceImpl.java"
click node_cart_api "https://github.com/seyrit16/marketplace/blob/master/order_service/src/main/java/com/example/order_service/controller/CartController.java"
click node_cart_service "https://github.com/seyrit16/marketplace/blob/master/order_service/src/main/java/com/example/order_service/service/impl/CartServiceImpl.java"
click node_order_api "https://github.com/seyrit16/marketplace/blob/master/order_service/src/main/java/com/example/order_service/controller/OrderController.java"
click node_order_service "https://github.com/seyrit16/marketplace/blob/master/order_service/src/main/java/com/example/order_service/service/impl/OrderServiceImpl.java"
click node_item_api "https://github.com/seyrit16/marketplace/blob/master/order_service/src/main/java/com/example/order_service/controller/OrderItemController.java"
click node_pickup_api "https://github.com/seyrit16/marketplace/blob/master/order_service/src/main/java/com/example/order_service/controller/PickupPointController.java"
click node_pickup_service "https://github.com/seyrit16/marketplace/blob/master/order_service/src/main/java/com/example/order_service/service/impl/PickupPointServiceImpl.java"
click node_payment_api "https://github.com/seyrit16/marketplace/blob/master/order_service/src/main/java/com/example/order_service/controller/PaymentController.java"
click node_payment_service "https://github.com/seyrit16/marketplace/blob/master/order_service/src/main/java/com/example/order_service/service/impl/PaymentServiceImpl.java"
click node_redis_service "https://github.com/seyrit16/marketplace/blob/master/redis_service/src/main/java/com/example/redis_service/service/impl/RedisServiceImpl.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_user_api,node_user_service,node_seller_api,node_seller_service toneBlue
class node_product_api,node_category_api,node_product_service,node_search_api,node_search_service,node_image_api,node_file_api,node_file_storage toneAmber
class node_cart_api,node_cart_service,node_order_api,node_order_service,node_item_api,node_pickup_api,node_pickup_service,node_payment_api,node_payment_service toneMint
class node_redis_service,node_redis_store,node_elasticsearch,node_postgres,node_kafka toneRose
class node_buyer,node_seller,node_operator toneIndigo
```

## Components

### Identity and Roles

- [User API](https://github.com/seyrit16/marketplace/tree/master/user_service/src/main/java/com/example/user_service/controller): `user_service/src/main/java/com/example/user_service/controller`
- [User Service](https://github.com/seyrit16/marketplace/tree/master/user_service/src/main/java/com/example/user_service): `user_service/src/main/java/com/example/user_service`
- [Seller API](https://github.com/seyrit16/marketplace/blob/master/seller_service/src/main/java/com/example/seller_service/controller/SellerController.java): `seller_service/src/main/java/com/example/seller_service/controller/SellerController.java`
- [Seller Profiles](https://github.com/seyrit16/marketplace/blob/master/seller_service/src/main/java/com/example/seller_service/service/impl/SellerServiceImpl.java): `seller_service/src/main/java/com/example/seller_service/service/impl/SellerServiceImpl.java`

### Seller and Catalog

- [Product API](https://github.com/seyrit16/marketplace/blob/master/product_service/src/main/java/com/example/product_service/controller/ProductController.java): `product_service/src/main/java/com/example/product_service/controller/ProductController.java`
- [Category API](https://github.com/seyrit16/marketplace/blob/master/product_service/src/main/java/com/example/product_service/controller/CategoryController.java): `product_service/src/main/java/com/example/product_service/controller/CategoryController.java`
- [Product Catalog](https://github.com/seyrit16/marketplace/blob/master/product_service/src/main/java/com/example/product_service/service/impl/ProductServiceImpl.java): `product_service/src/main/java/com/example/product_service/service/impl/ProductServiceImpl.java`
- [Search API](https://github.com/seyrit16/marketplace/blob/master/product_service/src/main/java/com/example/product_service/controller/SearchController.java): `product_service/src/main/java/com/example/product_service/controller/SearchController.java`
- [Product Search](https://github.com/seyrit16/marketplace/blob/master/product_service/src/main/java/com/example/product_service/service/impl/ProductSearchServiceImpl.java): `product_service/src/main/java/com/example/product_service/service/impl/ProductSearchServiceImpl.java`
- [Image API](https://github.com/seyrit16/marketplace/blob/master/product_service/src/main/java/com/example/product_service/controller/ProductImageController.java): `product_service/src/main/java/com/example/product_service/controller/ProductImageController.java`
- [File API](https://github.com/seyrit16/marketplace/blob/master/product_service/src/main/java/com/example/product_service/controller/FileController.java): `product_service/src/main/java/com/example/product_service/controller/FileController.java`
- [Image Storage](https://github.com/seyrit16/marketplace/blob/master/product_service/src/main/java/com/example/product_service/service/impl/LocalFileStorageServiceImpl.java): `product_service/src/main/java/com/example/product_service/service/impl/LocalFileStorageServiceImpl.java`

### Orders and Fulfillment

- [Cart API](https://github.com/seyrit16/marketplace/blob/master/order_service/src/main/java/com/example/order_service/controller/CartController.java): `order_service/src/main/java/com/example/order_service/controller/CartController.java`
- [Cart Service](https://github.com/seyrit16/marketplace/blob/master/order_service/src/main/java/com/example/order_service/service/impl/CartServiceImpl.java): `order_service/src/main/java/com/example/order_service/service/impl/CartServiceImpl.java`
- [Order API](https://github.com/seyrit16/marketplace/blob/master/order_service/src/main/java/com/example/order_service/controller/OrderController.java): `order_service/src/main/java/com/example/order_service/controller/OrderController.java`
- [Order Service](https://github.com/seyrit16/marketplace/blob/master/order_service/src/main/java/com/example/order_service/service/impl/OrderServiceImpl.java): `order_service/src/main/java/com/example/order_service/service/impl/OrderServiceImpl.java`
- [Order Item API](https://github.com/seyrit16/marketplace/blob/master/order_service/src/main/java/com/example/order_service/controller/OrderItemController.java): `order_service/src/main/java/com/example/order_service/controller/OrderItemController.java`
- [Pickup API](https://github.com/seyrit16/marketplace/blob/master/order_service/src/main/java/com/example/order_service/controller/PickupPointController.java): `order_service/src/main/java/com/example/order_service/controller/PickupPointController.java`
- [Pickup Points](https://github.com/seyrit16/marketplace/blob/master/order_service/src/main/java/com/example/order_service/service/impl/PickupPointServiceImpl.java): `order_service/src/main/java/com/example/order_service/service/impl/PickupPointServiceImpl.java`
- [Payment API](https://github.com/seyrit16/marketplace/blob/master/order_service/src/main/java/com/example/order_service/controller/PaymentController.java): `order_service/src/main/java/com/example/order_service/controller/PaymentController.java`
- [Payment Service](https://github.com/seyrit16/marketplace/blob/master/order_service/src/main/java/com/example/order_service/service/impl/PaymentServiceImpl.java): `order_service/src/main/java/com/example/order_service/service/impl/PaymentServiceImpl.java`

### Shared Infrastructure

- [Redis Service](https://github.com/seyrit16/marketplace/blob/master/redis_service/src/main/java/com/example/redis_service/service/impl/RedisServiceImpl.java): `redis_service/src/main/java/com/example/redis_service/service/impl/RedisServiceImpl.java`
- **Redis**
- **Elasticsearch**
- **PostgreSQL Databases**
- **Kafka**

### Other components

- **Buyer**
- **Seller**
- **Pickup Operator**

## Connections

- Buyer → User API: registers / authenticates (evidence: `README.md`)
- Buyer → Search API: searches products (evidence: `README.md`)
- Seller → Seller API: manages profile (evidence: `README.md`)
- Seller → Product API: manages listings (evidence: `README.md`)
- Buyer → Cart API: manages cart (evidence: `README.md`)
- Buyer → Order API: places orders (evidence: `README.md`)
- Pickup Operator → Order Item API: processes orders (evidence: `README.md`)
- Pickup Operator → Pickup API: manages pickup (evidence: `README.md`)
- Product Search → Elasticsearch: searches and filters (evidence: `README.md`)
- Cart Service → Redis: caches cart (evidence: `README.md`)
- Redis Service → Redis: stores temporary state (evidence: `README.md`)
- User Service → PostgreSQL Databases: uses own database (evidence: `README.md`)
- Seller Profiles → PostgreSQL Databases: uses own database (evidence: `README.md`)
- Product Catalog → PostgreSQL Databases: uses own database (evidence: `README.md`)
- Order Service → PostgreSQL Databases: uses own database (evidence: `README.md`)
- Redis Service → PostgreSQL Databases: uses own database (evidence: `README.md`)
- Image API → Image Storage: stores images (evidence: `README.md`)
- File API → Image Storage: serves local files (evidence: `README.md`)
- User Service → Kafka: communicates asynchronously (evidence: `README.md`)
- Seller Profiles → Kafka: communicates asynchronously (evidence: `README.md`)
- Product Catalog → Kafka: communicates asynchronously (evidence: `README.md`)
- Order Service → Kafka: communicates asynchronously (evidence: `README.md`)
- Redis Service → Kafka: communicates asynchronously (evidence: `README.md`)
