# yyursup/e-commerce architecture

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

- Interactive diagram: https://gitdiagram.com/yyursup/e-commerce
- Repository: https://github.com/yyursup/e-commerce

## Overview

This is a full-stack marketplace with separate customer, seller, and administration React applications backed by a Spring Boot API. The principal customer journey is browse products, manage a cart, checkout, pay, and track orders; sellers manage listings and fulfillment, while administrators oversee orders, escrow, wallets, reports, and platform operations. The graph combines documented README capabilities with sampled service and store relationships; unsampled domain wiring is represented only where documented, and omitted where evidence is insufficient.

Main entry points: [`ecommerce/src/main/java/com/marketplace/ecommerce/product/service/QueryProductService.java`](https://github.com/yyursup/e-commerce/blob/main/ecommerce/src/main/java/com/marketplace/ecommerce/product/service/QueryProductService.java) (Product catalog), [`ecommerce/src/main/java/com/marketplace/ecommerce/order/controller/QueryOrderController.java`](https://github.com/yyursup/e-commerce/blob/main/ecommerce/src/main/java/com/marketplace/ecommerce/order/controller/QueryOrderController.java) (Checkout and orders), [`ecommerce-fe/src/pages/checkout/Checkout.jsx`](https://github.com/yyursup/e-commerce/blob/main/ecommerce-fe/src/pages/checkout/Checkout.jsx) (Cart and checkout), [`ecommerce-seller-fe/src/pages/business/ShopOrders.jsx`](https://github.com/yyursup/e-commerce/blob/main/ecommerce-seller-fe/src/pages/business/ShopOrders.jsx) (Seller management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_customer["Customer storefront"]
  node_storefront["Shop and discovery<br/>[ShopProfile.jsx]"]
  node_cart_checkout["Cart and checkout<br/>[Checkout.jsx]"]
  node_orders_customer["Customer orders<br/>[MyOrders.jsx]"]
  node_profile["Profile and wallet<br/>[Profile.jsx]"]
end

subgraph group_seller["Seller operations"]
  node_seller_portal["Seller management<br/>[ShopOrders.jsx]"]
  node_seller_auth["Seller onboarding<br/>[SellerRegister.jsx]"]
end

subgraph group_admin["Administration"]
  node_admin_portal["Admin operations"]
  node_admin_chat["Admin live chat<br/>[AdminLiveChat.jsx]"]
end

subgraph group_backend["Marketplace backend"]
  node_auth_api["Authentication and accounts"]
  node_product_api["Product catalog"]
  node_cart_api["Cart service"]
  node_checkout_orders["Checkout and orders"]
  node_payment_escrow["Payment and escrow"]
  node_shipping["Shipping"]
  node_reviews["Reviews"]
  node_kyc["Identity verification"]
  node_chat["Chat and chatbot"]
end

subgraph group_integrations["External services"]
  node_postgres[("Marketplace database")]
  node_minio[("MinIO storage")]
  node_vnpay["VNPay"]
  node_ghn["GHN shipping"]
  node_vnpt["VNPT eKYC"]
  node_mail["Mail provider"]
  node_ollama["Ollama embeddings"]
end

node_buyer(("Customer"))
node_seller_actor(("Seller"))
node_admin_actor(("Administrator"))

node_buyer -->|"browses"| node_storefront
node_storefront -.->|"queries catalog"| node_product_api
node_buyer -->|"shops"| node_cart_checkout
node_cart_checkout -->|"updates cart"| node_cart_api
node_cart_checkout -->|"places order"| node_checkout_orders
node_buyer -->|"tracks orders"| node_orders_customer
node_orders_customer -->|"queries orders"| node_checkout_orders
node_buyer -.->|"manages account"| node_profile
node_seller_actor -.->|"registers"| node_seller_auth
node_seller_actor -.->|"operates shop"| node_seller_portal
node_seller_portal -.->|"manages listings"| node_product_api
node_seller_portal -.->|"manages fulfillment"| node_checkout_orders
node_admin_actor -->|"administers"| node_admin_portal
node_admin_portal -->|"oversees orders"| node_checkout_orders
node_admin_portal -->|"releases escrow"| node_payment_escrow
node_admin_actor -.->|"handles conversations"| node_admin_chat
node_auth_api -.->|"persists accounts"| node_postgres
node_product_api -.->|"reads catalog"| node_postgres
node_cart_api -.->|"persists cart"| node_postgres
node_checkout_orders -.->|"stores orders"| node_postgres
node_payment_escrow -->|"processes payment"| node_vnpay
node_shipping -->|"arranges shipping"| node_ghn
node_kyc -->|"verifies identity"| node_vnpt
node_auth_api -.->|"sends email"| node_mail
node_product_api -->|"stores images"| node_minio
node_chat -.->|"replies live"| node_buyer
node_chat -.->|"replies live"| node_seller_actor
node_product_api -.->|"creates embeddings"| node_ollama
node_buyer -->|"reviews purchase"| node_reviews

click node_storefront "https://github.com/yyursup/e-commerce/blob/main/ecommerce-fe/src/pages/ShopProfile.jsx"
click node_cart_checkout "https://github.com/yyursup/e-commerce/blob/main/ecommerce-fe/src/pages/checkout/Checkout.jsx"
click node_orders_customer "https://github.com/yyursup/e-commerce/blob/main/ecommerce-fe/src/pages/orders/MyOrders.jsx"
click node_profile "https://github.com/yyursup/e-commerce/blob/main/ecommerce-fe/src/pages/Profile.jsx"
click node_seller_portal "https://github.com/yyursup/e-commerce/blob/main/ecommerce-seller-fe/src/pages/business/ShopOrders.jsx"
click node_seller_auth "https://github.com/yyursup/e-commerce/blob/main/ecommerce-seller-fe/src/pages/SellerRegister.jsx"
click node_admin_portal "https://github.com/yyursup/e-commerce/blob/main/ecommerce-admin-fe/src/pages/admin/AdminCommissions.jsx"
click node_admin_chat "https://github.com/yyursup/e-commerce/blob/main/ecommerce-admin-fe/src/pages/admin/AdminLiveChat.jsx"
click node_auth_api "https://github.com/yyursup/e-commerce/blob/main/ecommerce/src/main/java/com/marketplace/ecommerce/auth/controller/AuthenticationController.java"
click node_product_api "https://github.com/yyursup/e-commerce/blob/main/ecommerce/src/main/java/com/marketplace/ecommerce/product/service/QueryProductService.java"
click node_cart_api "https://github.com/yyursup/e-commerce/blob/main/ecommerce/src/main/java/com/marketplace/ecommerce/cart/controller/CartController.java"
click node_checkout_orders "https://github.com/yyursup/e-commerce/blob/main/ecommerce/src/main/java/com/marketplace/ecommerce/order/controller/QueryOrderController.java"
click node_payment_escrow "https://github.com/yyursup/e-commerce/tree/main/ecommerce/src/main/java/com/marketplace/ecommerce"
click node_shipping "https://github.com/yyursup/e-commerce/tree/main/ecommerce/src/main/java/com/marketplace/ecommerce"
click node_reviews "https://github.com/yyursup/e-commerce/blob/main/ecommerce/src/main/java/com/marketplace/ecommerce/review/controller/ReviewController.java"
click node_kyc "https://github.com/yyursup/e-commerce/blob/main/ecommerce/src/main/java/com/marketplace/ecommerce/kyc/service/impl/KycOrchestratorService.java"
click node_chat "https://github.com/yyursup/e-commerce/blob/main/ecommerce/src/main/java/com/marketplace/ecommerce/chat/controller/ChatController.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_storefront,node_cart_checkout,node_orders_customer,node_profile toneBlue
class node_seller_portal,node_seller_auth toneAmber
class node_admin_portal,node_admin_chat toneMint
class node_auth_api,node_product_api,node_cart_api,node_checkout_orders,node_payment_escrow,node_shipping,node_reviews,node_kyc,node_chat toneRose
class node_postgres,node_minio,node_vnpay,node_ghn,node_vnpt,node_mail,node_ollama,node_buyer,node_seller_actor,node_admin_actor toneIndigo
```

## Components

### Customer storefront

- [Shop and discovery](https://github.com/yyursup/e-commerce/blob/main/ecommerce-fe/src/pages/ShopProfile.jsx): `ecommerce-fe/src/pages/ShopProfile.jsx`
- [Cart and checkout](https://github.com/yyursup/e-commerce/blob/main/ecommerce-fe/src/pages/checkout/Checkout.jsx): `ecommerce-fe/src/pages/checkout/Checkout.jsx`
- [Customer orders](https://github.com/yyursup/e-commerce/blob/main/ecommerce-fe/src/pages/orders/MyOrders.jsx): `ecommerce-fe/src/pages/orders/MyOrders.jsx`
- [Profile and wallet](https://github.com/yyursup/e-commerce/blob/main/ecommerce-fe/src/pages/Profile.jsx): `ecommerce-fe/src/pages/Profile.jsx`

### Seller operations

- [Seller management](https://github.com/yyursup/e-commerce/blob/main/ecommerce-seller-fe/src/pages/business/ShopOrders.jsx): `ecommerce-seller-fe/src/pages/business/ShopOrders.jsx`
- [Seller onboarding](https://github.com/yyursup/e-commerce/blob/main/ecommerce-seller-fe/src/pages/SellerRegister.jsx): `ecommerce-seller-fe/src/pages/SellerRegister.jsx`

### Administration

- [Admin operations](https://github.com/yyursup/e-commerce/blob/main/ecommerce-admin-fe/src/pages/admin/AdminCommissions.jsx): `ecommerce-admin-fe/src/pages/admin/AdminCommissions.jsx`
- [Admin live chat](https://github.com/yyursup/e-commerce/blob/main/ecommerce-admin-fe/src/pages/admin/AdminLiveChat.jsx): `ecommerce-admin-fe/src/pages/admin/AdminLiveChat.jsx`

### Marketplace backend

- [Authentication and accounts](https://github.com/yyursup/e-commerce/blob/main/ecommerce/src/main/java/com/marketplace/ecommerce/auth/controller/AuthenticationController.java): `ecommerce/src/main/java/com/marketplace/ecommerce/auth/controller/AuthenticationController.java`
- [Product catalog](https://github.com/yyursup/e-commerce/blob/main/ecommerce/src/main/java/com/marketplace/ecommerce/product/service/QueryProductService.java): `ecommerce/src/main/java/com/marketplace/ecommerce/product/service/QueryProductService.java`
- [Cart service](https://github.com/yyursup/e-commerce/blob/main/ecommerce/src/main/java/com/marketplace/ecommerce/cart/controller/CartController.java): `ecommerce/src/main/java/com/marketplace/ecommerce/cart/controller/CartController.java`
- [Checkout and orders](https://github.com/yyursup/e-commerce/blob/main/ecommerce/src/main/java/com/marketplace/ecommerce/order/controller/QueryOrderController.java): `ecommerce/src/main/java/com/marketplace/ecommerce/order/controller/QueryOrderController.java`
- [Payment and escrow](https://github.com/yyursup/e-commerce/tree/main/ecommerce/src/main/java/com/marketplace/ecommerce): `ecommerce/src/main/java/com/marketplace/ecommerce`
- [Shipping](https://github.com/yyursup/e-commerce/tree/main/ecommerce/src/main/java/com/marketplace/ecommerce): `ecommerce/src/main/java/com/marketplace/ecommerce`
- [Reviews](https://github.com/yyursup/e-commerce/blob/main/ecommerce/src/main/java/com/marketplace/ecommerce/review/controller/ReviewController.java): `ecommerce/src/main/java/com/marketplace/ecommerce/review/controller/ReviewController.java`
- [Identity verification](https://github.com/yyursup/e-commerce/blob/main/ecommerce/src/main/java/com/marketplace/ecommerce/kyc/service/impl/KycOrchestratorService.java): `ecommerce/src/main/java/com/marketplace/ecommerce/kyc/service/impl/KycOrchestratorService.java`
- [Chat and chatbot](https://github.com/yyursup/e-commerce/blob/main/ecommerce/src/main/java/com/marketplace/ecommerce/chat/controller/ChatController.java): `ecommerce/src/main/java/com/marketplace/ecommerce/chat/controller/ChatController.java`

### External services

- **Marketplace database**
- **MinIO storage**
- **VNPay**
- **GHN shipping**
- **VNPT eKYC**
- **Mail provider**
- **Ollama embeddings**

### Other components

- **Customer**
- **Seller**
- **Administrator**

## Connections

- Customer → Shop and discovery: browses (evidence: `README.md`)
- Shop and discovery → Product catalog: queries catalog (evidence: `README.md`)
- Customer → Cart and checkout: shops (evidence: `README.md`)
- Cart and checkout → Cart service: updates cart (evidence: `README.md`)
- Cart and checkout → Checkout and orders: places order (evidence: `README.md`)
- Customer → Customer orders: tracks orders (evidence: `README.md`)
- Customer orders → Checkout and orders: queries orders (evidence: `README.md`)
- Customer → Profile and wallet: manages account
- Seller → Seller onboarding: registers
- Seller → Seller management: operates shop
- Seller management → Product catalog: manages listings (evidence: `README.md`)
- Seller management → Checkout and orders: manages fulfillment (evidence: `README.md`)
- Administrator → Admin operations: administers
- Admin operations → Checkout and orders: oversees orders (evidence: `README.md`)
- Admin operations → Payment and escrow: releases escrow (evidence: `README.md`)
- Administrator → Admin live chat: handles conversations
- Authentication and accounts → Marketplace database: persists accounts (evidence: `README.md`)
- Product catalog → Marketplace database: reads catalog (evidence: `README.md`)
- Cart service → Marketplace database: persists cart (evidence: `README.md`)
- Checkout and orders → Marketplace database: stores orders (evidence: `README.md`)
- Payment and escrow → VNPay: processes payment (evidence: `README.md`)
- Shipping → GHN shipping: arranges shipping (evidence: `README.md`)
- Identity verification → VNPT eKYC: verifies identity (evidence: `ecommerce/src/main/java/com/marketplace/ecommerce/kyc/service/impl/KycOrchestratorService.java`)
- Authentication and accounts → Mail provider: sends email (evidence: `README.md`)
- Product catalog → MinIO storage: stores images (evidence: `README.md`)
- Chat and chatbot → Customer: replies live
- Chat and chatbot → Seller: replies live
- Product catalog → Ollama embeddings: creates embeddings (evidence: `README.md`)
- Customer → Reviews: reviews purchase (evidence: `README.md`)
