# abdalrahmanehab/spring-commerce architecture

> Architecture diagram of the GitHub repository abdalrahmanehab/spring-commerce, 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/abdalrahmanehab/spring-commerce
- Repository: https://github.com/abdalrahmanehab/spring-commerce

## Overview

Spring Commerce is a package-by-feature e-commerce REST API. The principal workflow spans product catalog and inventory, cart management, and order checkout; account registration is a separate entry point. Controllers delegate through service boundaries, with repositories and product-store adapters providing persistence. The README documents atomic checkout, stock handling, order snapshots and status transitions, but the order implementation was not sampled, so its internal calls are shown only as unverified relationships. Product, cart, order, and user capabilities are represented without inferring unsampled implementation details.

Main entry points: [`src/main/java/com/abdalrahman/springcommerce/order/service/OrderServiceImpl.java`](https://github.com/abdalrahmanehab/spring-commerce/blob/main/src/main/java/com/abdalrahman/springcommerce/order/service/OrderServiceImpl.java) (Checkout and Status), [`src/main/java/com/abdalrahman/springcommerce/cart/service/CartServiceImpl.java`](https://github.com/abdalrahmanehab/spring-commerce/blob/main/src/main/java/com/abdalrahman/springcommerce/cart/service/CartServiceImpl.java) (Cart Management), [`src/main/java/com/abdalrahman/springcommerce/product/service/ProductServiceImpl.java`](https://github.com/abdalrahmanehab/spring-commerce/blob/main/src/main/java/com/abdalrahman/springcommerce/product/service/ProductServiceImpl.java) (Catalog and Stock), [`src/main/java/com/abdalrahman/springcommerce/product/controller/ProductController.java`](https://github.com/abdalrahmanehab/spring-commerce/blob/main/src/main/java/com/abdalrahman/springcommerce/product/controller/ProductController.java) (Product API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Catalog and Inventory"]
  node_product_api["Product API"]
  node_product_logic["Catalog and Stock"]
  node_product_store["Product Repository"]
  node_product_data["Product Store Adapters"]
  node_product_db[("Product Database<br/>[Product.java]")]
end

subgraph group_commerce["Cart and Orders"]
  node_cart_api["Cart API"]
  node_cart_logic["Cart Management"]
  node_cart_repo["Cart Repository"]
  node_cart_data[("Cart Store<br/>[Cart.java]")]
  node_order_api["Order API"]
  node_order_logic["Checkout and Status"]
  node_order_repo["Order Repository"]
  node_order_data[("Order Store<br/>[Order.java]")]
end

subgraph group_identity["Accounts and Security"]
  node_auth_api["Registration API"]
  node_user_logic["User Management"]
  node_user_repo["User Repository"]
  node_user_data[("User Store<br/>[User.java]")]
  node_security["Security Configuration"]
end

subgraph group_shared["Shared API Support"]
  node_error_handling["Error Responses"]
end

node_client(("API Client"))

node_client -->|"requests"| node_product_api
node_client -->|"requests"| node_cart_api
node_client -->|"requests"| node_order_api
node_client -->|"registers"| node_auth_api
node_product_api -->|"delegates to"| node_product_logic
node_product_logic -->|"uses"| node_product_store
node_product_store -.->|"delegates to"| node_product_data
node_product_data -.->|"stores products"| node_product_db
node_cart_api -->|"delegates to"| node_cart_logic
node_cart_logic -->|"uses"| node_cart_repo
node_cart_repo -->|"persists"| node_cart_data
node_cart_logic -->|"checks stock"| node_product_logic
node_order_api -->|"delegates to"| node_order_logic
node_order_logic -.->|"persists orders"| node_order_repo
node_order_repo -->|"stores orders"| node_order_data
node_order_logic -.->|"reads and clears cart"| node_cart_logic
node_order_logic -.->|"reserves stock"| node_product_logic
node_auth_api -->|"registers user"| node_user_logic
node_user_logic -.->|"uses"| node_user_repo
node_user_repo -->|"persists"| node_user_data
node_client -.->|"authenticated requests"| node_security
node_error_handling -.->|"returns errors"| node_client

click node_product_api "https://github.com/abdalrahmanehab/spring-commerce/blob/main/src/main/java/com/abdalrahman/springcommerce/product/controller/ProductController.java"
click node_product_logic "https://github.com/abdalrahmanehab/spring-commerce/blob/main/src/main/java/com/abdalrahman/springcommerce/product/service/ProductServiceImpl.java"
click node_product_store "https://github.com/abdalrahmanehab/spring-commerce/blob/main/src/main/java/com/abdalrahman/springcommerce/product/repository/ProductRepositoryImpl.java"
click node_product_data "https://github.com/abdalrahmanehab/spring-commerce/tree/main/src/main/java/com/abdalrahman/springcommerce/product/repository"
click node_product_db "https://github.com/abdalrahmanehab/spring-commerce/blob/main/src/main/java/com/abdalrahman/springcommerce/product/Product.java"
click node_cart_api "https://github.com/abdalrahmanehab/spring-commerce/blob/main/src/main/java/com/abdalrahman/springcommerce/cart/controller/CartController.java"
click node_cart_logic "https://github.com/abdalrahmanehab/spring-commerce/blob/main/src/main/java/com/abdalrahman/springcommerce/cart/service/CartServiceImpl.java"
click node_cart_repo "https://github.com/abdalrahmanehab/spring-commerce/blob/main/src/main/java/com/abdalrahman/springcommerce/cart/repository/CartRepository.java"
click node_cart_data "https://github.com/abdalrahmanehab/spring-commerce/blob/main/src/main/java/com/abdalrahman/springcommerce/cart/Cart.java"
click node_order_api "https://github.com/abdalrahmanehab/spring-commerce/blob/main/src/main/java/com/abdalrahman/springcommerce/order/controller/OrderController.java"
click node_order_logic "https://github.com/abdalrahmanehab/spring-commerce/blob/main/src/main/java/com/abdalrahman/springcommerce/order/service/OrderServiceImpl.java"
click node_order_repo "https://github.com/abdalrahmanehab/spring-commerce/blob/main/src/main/java/com/abdalrahman/springcommerce/order/repository/OrderRepository.java"
click node_order_data "https://github.com/abdalrahmanehab/spring-commerce/blob/main/src/main/java/com/abdalrahman/springcommerce/order/Order.java"
click node_auth_api "https://github.com/abdalrahmanehab/spring-commerce/blob/main/src/main/java/com/abdalrahman/springcommerce/auth/controller/AuthController.java"
click node_user_logic "https://github.com/abdalrahmanehab/spring-commerce/blob/main/src/main/java/com/abdalrahman/springcommerce/user/service/UserServiceImpl.java"
click node_user_repo "https://github.com/abdalrahmanehab/spring-commerce/blob/main/src/main/java/com/abdalrahman/springcommerce/user/repository/UserRepository.java"
click node_user_data "https://github.com/abdalrahmanehab/spring-commerce/blob/main/src/main/java/com/abdalrahman/springcommerce/user/User.java"
click node_security "https://github.com/abdalrahmanehab/spring-commerce/blob/main/src/main/java/com/abdalrahman/springcommerce/security/SecurityConfig.java"
click node_error_handling "https://github.com/abdalrahmanehab/spring-commerce/blob/main/src/main/java/com/abdalrahman/springcommerce/shared/errors/handlers/GlobalExceptionHandler.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_product_api,node_product_logic,node_product_store,node_product_data,node_product_db,node_client toneBlue
class node_cart_api,node_cart_logic,node_cart_repo,node_cart_data,node_order_api,node_order_logic,node_order_repo,node_order_data toneAmber
class node_auth_api,node_user_logic,node_user_repo,node_user_data,node_security toneMint
class node_error_handling toneRose
```

## Components

### Catalog and Inventory

- [Product API](https://github.com/abdalrahmanehab/spring-commerce/blob/main/src/main/java/com/abdalrahman/springcommerce/product/controller/ProductController.java): `src/main/java/com/abdalrahman/springcommerce/product/controller/ProductController.java`
- [Catalog and Stock](https://github.com/abdalrahmanehab/spring-commerce/blob/main/src/main/java/com/abdalrahman/springcommerce/product/service/ProductServiceImpl.java): `src/main/java/com/abdalrahman/springcommerce/product/service/ProductServiceImpl.java`
- [Product Repository](https://github.com/abdalrahmanehab/spring-commerce/blob/main/src/main/java/com/abdalrahman/springcommerce/product/repository/ProductRepositoryImpl.java): `src/main/java/com/abdalrahman/springcommerce/product/repository/ProductRepositoryImpl.java`
- [Product Store Adapters](https://github.com/abdalrahmanehab/spring-commerce/tree/main/src/main/java/com/abdalrahman/springcommerce/product/repository): `src/main/java/com/abdalrahman/springcommerce/product/repository`
- [Product Database](https://github.com/abdalrahmanehab/spring-commerce/blob/main/src/main/java/com/abdalrahman/springcommerce/product/Product.java): `src/main/java/com/abdalrahman/springcommerce/product/Product.java`

### Cart and Orders

- [Cart API](https://github.com/abdalrahmanehab/spring-commerce/blob/main/src/main/java/com/abdalrahman/springcommerce/cart/controller/CartController.java): `src/main/java/com/abdalrahman/springcommerce/cart/controller/CartController.java`
- [Cart Management](https://github.com/abdalrahmanehab/spring-commerce/blob/main/src/main/java/com/abdalrahman/springcommerce/cart/service/CartServiceImpl.java): `src/main/java/com/abdalrahman/springcommerce/cart/service/CartServiceImpl.java`
- [Cart Repository](https://github.com/abdalrahmanehab/spring-commerce/blob/main/src/main/java/com/abdalrahman/springcommerce/cart/repository/CartRepository.java): `src/main/java/com/abdalrahman/springcommerce/cart/repository/CartRepository.java`
- [Cart Store](https://github.com/abdalrahmanehab/spring-commerce/blob/main/src/main/java/com/abdalrahman/springcommerce/cart/Cart.java): `src/main/java/com/abdalrahman/springcommerce/cart/Cart.java`
- [Order API](https://github.com/abdalrahmanehab/spring-commerce/blob/main/src/main/java/com/abdalrahman/springcommerce/order/controller/OrderController.java): `src/main/java/com/abdalrahman/springcommerce/order/controller/OrderController.java`
- [Checkout and Status](https://github.com/abdalrahmanehab/spring-commerce/blob/main/src/main/java/com/abdalrahman/springcommerce/order/service/OrderServiceImpl.java): `src/main/java/com/abdalrahman/springcommerce/order/service/OrderServiceImpl.java`
- [Order Repository](https://github.com/abdalrahmanehab/spring-commerce/blob/main/src/main/java/com/abdalrahman/springcommerce/order/repository/OrderRepository.java): `src/main/java/com/abdalrahman/springcommerce/order/repository/OrderRepository.java`
- [Order Store](https://github.com/abdalrahmanehab/spring-commerce/blob/main/src/main/java/com/abdalrahman/springcommerce/order/Order.java): `src/main/java/com/abdalrahman/springcommerce/order/Order.java`

### Accounts and Security

- [Registration API](https://github.com/abdalrahmanehab/spring-commerce/blob/main/src/main/java/com/abdalrahman/springcommerce/auth/controller/AuthController.java): `src/main/java/com/abdalrahman/springcommerce/auth/controller/AuthController.java`
- [User Management](https://github.com/abdalrahmanehab/spring-commerce/blob/main/src/main/java/com/abdalrahman/springcommerce/user/service/UserServiceImpl.java): `src/main/java/com/abdalrahman/springcommerce/user/service/UserServiceImpl.java`
- [User Repository](https://github.com/abdalrahmanehab/spring-commerce/blob/main/src/main/java/com/abdalrahman/springcommerce/user/repository/UserRepository.java): `src/main/java/com/abdalrahman/springcommerce/user/repository/UserRepository.java`
- [User Store](https://github.com/abdalrahmanehab/spring-commerce/blob/main/src/main/java/com/abdalrahman/springcommerce/user/User.java): `src/main/java/com/abdalrahman/springcommerce/user/User.java`
- [Security Configuration](https://github.com/abdalrahmanehab/spring-commerce/blob/main/src/main/java/com/abdalrahman/springcommerce/security/SecurityConfig.java): `src/main/java/com/abdalrahman/springcommerce/security/SecurityConfig.java`

### Shared API Support

- [Error Responses](https://github.com/abdalrahmanehab/spring-commerce/blob/main/src/main/java/com/abdalrahman/springcommerce/shared/errors/handlers/GlobalExceptionHandler.java): `src/main/java/com/abdalrahman/springcommerce/shared/errors/handlers/GlobalExceptionHandler.java`

### Other components

- **API Client**

## Connections

- API Client → Product API: requests
- API Client → Cart API: requests
- API Client → Order API: requests
- API Client → Registration API: registers
- Product API → Catalog and Stock: delegates to (evidence: `src/main/java/com/abdalrahman/springcommerce/product/controller/ProductController.java`)
- Catalog and Stock → Product Repository: uses (evidence: `src/main/java/com/abdalrahman/springcommerce/product/service/ProductServiceImpl.java`)
- Product Repository → Product Store Adapters: delegates to (evidence: `src/main/java/com/abdalrahman/springcommerce/product/repository/ProductRepositoryImpl.java`)
- Product Store Adapters → Product Database: stores products (evidence: `src/main/java/com/abdalrahman/springcommerce/product/repository/DbService.java`)
- Cart API → Cart Management: delegates to (evidence: `src/main/java/com/abdalrahman/springcommerce/cart/controller/CartController.java`)
- Cart Management → Cart Repository: uses (evidence: `src/main/java/com/abdalrahman/springcommerce/cart/service/CartServiceImpl.java`)
- Cart Repository → Cart Store: persists (evidence: `src/main/java/com/abdalrahman/springcommerce/cart/repository/CartRepository.java`)
- Cart Management → Catalog and Stock: checks stock (evidence: `src/main/java/com/abdalrahman/springcommerce/cart/service/CartServiceImpl.java`)
- Order API → Checkout and Status: delegates to (evidence: `src/main/java/com/abdalrahman/springcommerce/order/controller/OrderController.java`)
- Checkout and Status → Order Repository: persists orders (evidence: `src/main/java/com/abdalrahman/springcommerce/order/service/OrderServiceImpl.java`)
- Order Repository → Order Store: stores orders (evidence: `src/main/java/com/abdalrahman/springcommerce/order/repository/OrderRepository.java`)
- Checkout and Status → Cart Management: reads and clears cart
- Checkout and Status → Catalog and Stock: reserves stock
- Registration API → User Management: registers user (evidence: `src/main/java/com/abdalrahman/springcommerce/auth/controller/AuthController.java`)
- User Management → User Repository: uses (evidence: `src/main/java/com/abdalrahman/springcommerce/user/service/UserServiceImpl.java`)
- User Repository → User Store: persists (evidence: `src/main/java/com/abdalrahman/springcommerce/user/repository/UserRepository.java`)
- API Client → Security Configuration: authenticated requests
- Error Responses → API Client: returns errors
