# zia6688/ecommerce-spring architecture

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

- Interactive diagram: https://gitdiagram.com/zia6688/ecommerce-spring
- Repository: https://github.com/zia6688/ecommerce-spring

## Overview

This is a Spring Boot marketplace API for users, shops, and products. API clients create users and shops, submit shops for review, and manage or browse products; controllers use Spring Data repositories to retrieve and save domain entities. Shop approval and product stock changes are represented as domain state transitions. The source shows repository interfaces but not their database configuration, so the graph does not assert a particular backing store. Relationships are based on the provided source excerpts; unsampled wiring is omitted.

Main entry points: [`src/main/java/com/ecommerce/platform/repositories/ShopRepository.java`](https://github.com/zia6688/ecommerce-spring/blob/main/src/main/java/com/ecommerce/platform/repositories/ShopRepository.java) (Shop Repository), [`src/main/java/com/ecommerce/platform/controllers/ShopController.java`](https://github.com/zia6688/ecommerce-spring/blob/main/src/main/java/com/ecommerce/platform/controllers/ShopController.java) (Shop API), [`src/main/java/com/ecommerce/platform/controllers/ProductController.java`](https://github.com/zia6688/ecommerce-spring/blob/main/src/main/java/com/ecommerce/platform/controllers/ProductController.java) (Product API), [`src/main/java/com/ecommerce/platform/models/Shop.java`](https://github.com/zia6688/ecommerce-spring/blob/main/src/main/java/com/ecommerce/platform/models/Shop.java) (Shop Entity)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_application["Spring Boot App"]
  node_home["Home Endpoint"]
  node_users_api["User API"]
  node_shops_api["Shop API"]
  node_admin_api["Admin API"]
  node_products_api["Product API"]
end

subgraph group_domain["Marketplace Domain"]
  node_user["User Entity<br/>[User.java]"]
  node_shop["Shop Entity<br/>[Shop.java]"]
  node_product["Product Entity<br/>[Product.java]"]
end

subgraph group_persistence["Data Access"]
  node_users_repo["User Repository"]
  node_shops_repo["Shop Repository"]
  node_products_repo["Product Repository"]
end

node_client(("API Client"))

node_client -->|"requests"| node_home
node_client -->|"requests"| node_users_api
node_client -->|"requests"| node_shops_api
node_client -->|"requests"| node_admin_api
node_client -->|"requests"| node_products_api
node_users_api -->|"reads and saves"| node_users_repo
node_shops_api -->|"loads owner"| node_users_repo
node_shops_api -->|"reads and saves"| node_shops_repo
node_admin_api -->|"queries pending"| node_shops_repo
node_products_api -->|"loads shop"| node_shops_repo
node_products_api -->|"reads and saves"| node_products_repo
node_users_repo -->|"persists"| node_user
node_shops_repo -->|"persists"| node_shop
node_products_repo -->|"persists"| node_product
node_shop -->|"references owner"| node_user
node_product -->|"belongs to"| node_shop

click node_application "https://github.com/zia6688/ecommerce-spring/blob/main/src/main/java/com/ecommerce/platform/PlatformApplication.java"
click node_home "https://github.com/zia6688/ecommerce-spring/blob/main/src/main/java/com/ecommerce/platform/controllers/HomeController.java"
click node_users_api "https://github.com/zia6688/ecommerce-spring/blob/main/src/main/java/com/ecommerce/platform/controllers/UserController.java"
click node_shops_api "https://github.com/zia6688/ecommerce-spring/blob/main/src/main/java/com/ecommerce/platform/controllers/ShopController.java"
click node_admin_api "https://github.com/zia6688/ecommerce-spring/blob/main/src/main/java/com/ecommerce/platform/controllers/AdminController.java"
click node_products_api "https://github.com/zia6688/ecommerce-spring/blob/main/src/main/java/com/ecommerce/platform/controllers/ProductController.java"
click node_user "https://github.com/zia6688/ecommerce-spring/blob/main/src/main/java/com/ecommerce/platform/models/User.java"
click node_shop "https://github.com/zia6688/ecommerce-spring/blob/main/src/main/java/com/ecommerce/platform/models/Shop.java"
click node_product "https://github.com/zia6688/ecommerce-spring/blob/main/src/main/java/com/ecommerce/platform/models/Product.java"
click node_users_repo "https://github.com/zia6688/ecommerce-spring/blob/main/src/main/java/com/ecommerce/platform/repositories/UserRepository.java"
click node_shops_repo "https://github.com/zia6688/ecommerce-spring/blob/main/src/main/java/com/ecommerce/platform/repositories/ShopRepository.java"
click node_products_repo "https://github.com/zia6688/ecommerce-spring/blob/main/src/main/java/com/ecommerce/platform/repositories/ProductRepository.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_application,node_home,node_users_api,node_shops_api,node_admin_api,node_products_api,node_client toneBlue
class node_user,node_shop,node_product toneAmber
class node_users_repo,node_shops_repo,node_products_repo toneMint
```

## Components

### REST API

- [Spring Boot App](https://github.com/zia6688/ecommerce-spring/blob/main/src/main/java/com/ecommerce/platform/PlatformApplication.java): `src/main/java/com/ecommerce/platform/PlatformApplication.java`
- [Home Endpoint](https://github.com/zia6688/ecommerce-spring/blob/main/src/main/java/com/ecommerce/platform/controllers/HomeController.java): `src/main/java/com/ecommerce/platform/controllers/HomeController.java`
- [User API](https://github.com/zia6688/ecommerce-spring/blob/main/src/main/java/com/ecommerce/platform/controllers/UserController.java): `src/main/java/com/ecommerce/platform/controllers/UserController.java`
- [Shop API](https://github.com/zia6688/ecommerce-spring/blob/main/src/main/java/com/ecommerce/platform/controllers/ShopController.java): `src/main/java/com/ecommerce/platform/controllers/ShopController.java`
- [Admin API](https://github.com/zia6688/ecommerce-spring/blob/main/src/main/java/com/ecommerce/platform/controllers/AdminController.java): `src/main/java/com/ecommerce/platform/controllers/AdminController.java`
- [Product API](https://github.com/zia6688/ecommerce-spring/blob/main/src/main/java/com/ecommerce/platform/controllers/ProductController.java): `src/main/java/com/ecommerce/platform/controllers/ProductController.java`

### Marketplace Domain

- [User Entity](https://github.com/zia6688/ecommerce-spring/blob/main/src/main/java/com/ecommerce/platform/models/User.java): `src/main/java/com/ecommerce/platform/models/User.java`
- [Shop Entity](https://github.com/zia6688/ecommerce-spring/blob/main/src/main/java/com/ecommerce/platform/models/Shop.java): `src/main/java/com/ecommerce/platform/models/Shop.java`
- [Product Entity](https://github.com/zia6688/ecommerce-spring/blob/main/src/main/java/com/ecommerce/platform/models/Product.java): `src/main/java/com/ecommerce/platform/models/Product.java`

### Data Access

- [User Repository](https://github.com/zia6688/ecommerce-spring/blob/main/src/main/java/com/ecommerce/platform/repositories/UserRepository.java): `src/main/java/com/ecommerce/platform/repositories/UserRepository.java`
- [Shop Repository](https://github.com/zia6688/ecommerce-spring/blob/main/src/main/java/com/ecommerce/platform/repositories/ShopRepository.java): `src/main/java/com/ecommerce/platform/repositories/ShopRepository.java`
- [Product Repository](https://github.com/zia6688/ecommerce-spring/blob/main/src/main/java/com/ecommerce/platform/repositories/ProductRepository.java): `src/main/java/com/ecommerce/platform/repositories/ProductRepository.java`

### Other components

- **API Client**

## Connections

- API Client → Home Endpoint: requests (evidence: `src/main/java/com/ecommerce/platform/controllers/HomeController.java`)
- API Client → User API: requests (evidence: `src/main/java/com/ecommerce/platform/controllers/UserController.java`)
- API Client → Shop API: requests (evidence: `src/main/java/com/ecommerce/platform/controllers/ShopController.java`)
- API Client → Admin API: requests (evidence: `src/main/java/com/ecommerce/platform/controllers/AdminController.java`)
- API Client → Product API: requests (evidence: `src/main/java/com/ecommerce/platform/controllers/ProductController.java`)
- User API → User Repository: reads and saves (evidence: `src/main/java/com/ecommerce/platform/controllers/UserController.java`)
- Shop API → User Repository: loads owner (evidence: `src/main/java/com/ecommerce/platform/controllers/ShopController.java`)
- Shop API → Shop Repository: reads and saves (evidence: `src/main/java/com/ecommerce/platform/controllers/ShopController.java`)
- Admin API → Shop Repository: queries pending (evidence: `src/main/java/com/ecommerce/platform/controllers/AdminController.java`)
- Product API → Shop Repository: loads shop (evidence: `src/main/java/com/ecommerce/platform/controllers/ProductController.java`)
- Product API → Product Repository: reads and saves (evidence: `src/main/java/com/ecommerce/platform/controllers/ProductController.java`)
- User Repository → User Entity: persists (evidence: `src/main/java/com/ecommerce/platform/repositories/UserRepository.java`)
- Shop Repository → Shop Entity: persists (evidence: `src/main/java/com/ecommerce/platform/repositories/ShopRepository.java`)
- Product Repository → Product Entity: persists (evidence: `src/main/java/com/ecommerce/platform/repositories/ProductRepository.java`)
- Shop Entity → User Entity: references owner (evidence: `src/main/java/com/ecommerce/platform/models/Shop.java`)
- Product Entity → Shop Entity: belongs to (evidence: `src/main/java/com/ecommerce/platform/models/Product.java`)
