# shopizer-ecommerce/shopizer architecture

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

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

## Overview

Shopizer is a Java headless-commerce backend exposing REST APIs for merchant storefronts and administration. Its documented capabilities cover catalog, shopping cart, checkout, orders, customers, merchants, and users; the available service interfaces also identify search, pricing, shipping, payments, content, and tax responsibilities. The graph shows the principal browse-to-purchase stages and the shared domain model. Some runtime wiring and checkout orchestration are not shown in the excerpts, so those connections are dashed and unverified rather than asserted as source-confirmed calls.

Main entry points: [`sm-shop/src/main/java/com/salesmanager/shop/store/api/DefaultController.java`](https://github.com/shopizer-ecommerce/shopizer/blob/3.2.7/sm-shop/src/main/java/com/salesmanager/shop/store/api/DefaultController.java) (REST API), [`sm-core/src/main/java/com/salesmanager/core/business/services/shoppingcart/ShoppingCartService.java`](https://github.com/shopizer-ecommerce/shopizer/blob/3.2.7/sm-core/src/main/java/com/salesmanager/core/business/services/shoppingcart/ShoppingCartService.java) (Shopping Cart), [`sm-core/src/main/java/com/salesmanager/core/business/services/order/OrderService.java`](https://github.com/shopizer-ecommerce/shopizer/blob/3.2.7/sm-core/src/main/java/com/salesmanager/core/business/services/order/OrderService.java) (Orders), [`sm-core/src/main/java/com/salesmanager/core/business/services/catalog/product/ProductService.java`](https://github.com/shopizer-ecommerce/shopizer/blob/3.2.7/sm-core/src/main/java/com/salesmanager/core/business/services/catalog/product/ProductService.java) (Catalog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront API"]
  node_rest["REST API"]
  node_images["Image Delivery"]
end

subgraph group_commerce["Commerce Services"]
  node_catalog["Catalog"]
  node_search["Product Search<br/>[SearchService.java]"]
  node_cart["Shopping Cart"]
  node_pricing["Pricing"]
  node_shipping["Shipping"]
  node_payments["Payments"]
  node_orders["Orders<br/>[OrderService.java]"]
  node_customers["Customers"]
  node_users["Users<br/>[UserService.java]"]
  node_merchant["Merchant Stores"]
end

subgraph group_domain["Commerce Domain"]
  node_productmodel["Product Model<br/>[Product.java]"]
  node_cartmodel["Cart Model<br/>[ShoppingCart.java]"]
  node_ordermodel["Order Model<br/>[Order.java]"]
  node_customermodel["Customer Model<br/>[Customer.java]"]
end

subgraph group_platform["Platform Services"]
  node_content["Content and Media"]
  node_entityservice["Entity Services"]
end

node_shopper(("Shopper"))

node_shopper -.->|"uses APIs"| node_rest
node_rest -.->|"routes catalog"| node_catalog
node_rest -.->|"routes search"| node_search
node_rest -.->|"routes cart"| node_cart
node_rest -.->|"routes customers"| node_customers
node_rest -.->|"routes orders"| node_orders
node_cart -.->|"uses pricing"| node_pricing
node_cart -.->|"requests quotes"| node_shipping
node_cart -.->|"checkout payment"| node_payments
node_cart -.->|"creates orders"| node_orders
node_catalog -.->|"manages products"| node_productmodel
node_cart -.->|"manages carts"| node_cartmodel
node_orders -.->|"manages orders"| node_ordermodel
node_customers -.->|"manages customers"| node_customermodel
node_rest -.->|"serves stores"| node_merchant
node_rest -.->|"serves users"| node_users
node_images -->|"loads content files"| node_content
node_entityservice -.->|"supports entities"| node_productmodel

click node_rest "https://github.com/shopizer-ecommerce/shopizer/blob/3.2.7/sm-shop/src/main/java/com/salesmanager/shop/store/api/DefaultController.java"
click node_catalog "https://github.com/shopizer-ecommerce/shopizer/blob/3.2.7/sm-core/src/main/java/com/salesmanager/core/business/services/catalog/product/ProductService.java"
click node_search "https://github.com/shopizer-ecommerce/shopizer/blob/3.2.7/sm-core/src/main/java/com/salesmanager/core/business/services/search/SearchService.java"
click node_cart "https://github.com/shopizer-ecommerce/shopizer/blob/3.2.7/sm-core/src/main/java/com/salesmanager/core/business/services/shoppingcart/ShoppingCartService.java"
click node_pricing "https://github.com/shopizer-ecommerce/shopizer/blob/3.2.7/sm-core/src/main/java/com/salesmanager/core/business/services/catalog/pricing/PricingService.java"
click node_shipping "https://github.com/shopizer-ecommerce/shopizer/blob/3.2.7/sm-core/src/main/java/com/salesmanager/core/business/services/shipping/ShippingService.java"
click node_payments "https://github.com/shopizer-ecommerce/shopizer/blob/3.2.7/sm-core/src/main/java/com/salesmanager/core/business/services/payments/PaymentService.java"
click node_orders "https://github.com/shopizer-ecommerce/shopizer/blob/3.2.7/sm-core/src/main/java/com/salesmanager/core/business/services/order/OrderService.java"
click node_customers "https://github.com/shopizer-ecommerce/shopizer/blob/3.2.7/sm-core/src/main/java/com/salesmanager/core/business/services/customer/CustomerService.java"
click node_users "https://github.com/shopizer-ecommerce/shopizer/blob/3.2.7/sm-core/src/main/java/com/salesmanager/core/business/services/user/UserService.java"
click node_merchant "https://github.com/shopizer-ecommerce/shopizer/blob/3.2.7/sm-core/src/main/java/com/salesmanager/core/business/services/merchant/MerchantStoreService.java"
click node_productmodel "https://github.com/shopizer-ecommerce/shopizer/blob/3.2.7/sm-core-model/src/main/java/com/salesmanager/core/model/catalog/product/Product.java"
click node_cartmodel "https://github.com/shopizer-ecommerce/shopizer/blob/3.2.7/sm-core-model/src/main/java/com/salesmanager/core/model/shoppingcart/ShoppingCart.java"
click node_ordermodel "https://github.com/shopizer-ecommerce/shopizer/blob/3.2.7/sm-core-model/src/main/java/com/salesmanager/core/model/order/Order.java"
click node_customermodel "https://github.com/shopizer-ecommerce/shopizer/blob/3.2.7/sm-core-model/src/main/java/com/salesmanager/core/model/customer/Customer.java"
click node_content "https://github.com/shopizer-ecommerce/shopizer/blob/3.2.7/sm-core/src/main/java/com/salesmanager/core/business/services/content/ContentService.java"
click node_images "https://github.com/shopizer-ecommerce/shopizer/blob/3.2.7/sm-shop/src/main/java/com/salesmanager/shop/controller/ImagesController.java"
click node_entityservice "https://github.com/shopizer-ecommerce/shopizer/blob/3.2.7/sm-core/src/main/java/com/salesmanager/core/business/services/common/generic/SalesManagerEntityService.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_rest,node_images toneBlue
class node_catalog,node_search,node_cart,node_pricing,node_shipping,node_payments,node_orders,node_customers,node_users,node_merchant toneAmber
class node_productmodel,node_cartmodel,node_ordermodel,node_customermodel toneMint
class node_content,node_entityservice toneRose
class node_shopper toneIndigo
```

## Components

### Storefront API

- [REST API](https://github.com/shopizer-ecommerce/shopizer/blob/3.2.7/sm-shop/src/main/java/com/salesmanager/shop/store/api/DefaultController.java): `sm-shop/src/main/java/com/salesmanager/shop/store/api/DefaultController.java`
- [Image Delivery](https://github.com/shopizer-ecommerce/shopizer/blob/3.2.7/sm-shop/src/main/java/com/salesmanager/shop/controller/ImagesController.java): `sm-shop/src/main/java/com/salesmanager/shop/controller/ImagesController.java`

### Commerce Services

- [Catalog](https://github.com/shopizer-ecommerce/shopizer/blob/3.2.7/sm-core/src/main/java/com/salesmanager/core/business/services/catalog/product/ProductService.java): `sm-core/src/main/java/com/salesmanager/core/business/services/catalog/product/ProductService.java`
- [Product Search](https://github.com/shopizer-ecommerce/shopizer/blob/3.2.7/sm-core/src/main/java/com/salesmanager/core/business/services/search/SearchService.java): `sm-core/src/main/java/com/salesmanager/core/business/services/search/SearchService.java`
- [Shopping Cart](https://github.com/shopizer-ecommerce/shopizer/blob/3.2.7/sm-core/src/main/java/com/salesmanager/core/business/services/shoppingcart/ShoppingCartService.java): `sm-core/src/main/java/com/salesmanager/core/business/services/shoppingcart/ShoppingCartService.java`
- [Pricing](https://github.com/shopizer-ecommerce/shopizer/blob/3.2.7/sm-core/src/main/java/com/salesmanager/core/business/services/catalog/pricing/PricingService.java): `sm-core/src/main/java/com/salesmanager/core/business/services/catalog/pricing/PricingService.java`
- [Shipping](https://github.com/shopizer-ecommerce/shopizer/blob/3.2.7/sm-core/src/main/java/com/salesmanager/core/business/services/shipping/ShippingService.java): `sm-core/src/main/java/com/salesmanager/core/business/services/shipping/ShippingService.java`
- [Payments](https://github.com/shopizer-ecommerce/shopizer/blob/3.2.7/sm-core/src/main/java/com/salesmanager/core/business/services/payments/PaymentService.java): `sm-core/src/main/java/com/salesmanager/core/business/services/payments/PaymentService.java`
- [Orders](https://github.com/shopizer-ecommerce/shopizer/blob/3.2.7/sm-core/src/main/java/com/salesmanager/core/business/services/order/OrderService.java): `sm-core/src/main/java/com/salesmanager/core/business/services/order/OrderService.java`
- [Customers](https://github.com/shopizer-ecommerce/shopizer/blob/3.2.7/sm-core/src/main/java/com/salesmanager/core/business/services/customer/CustomerService.java): `sm-core/src/main/java/com/salesmanager/core/business/services/customer/CustomerService.java`
- [Users](https://github.com/shopizer-ecommerce/shopizer/blob/3.2.7/sm-core/src/main/java/com/salesmanager/core/business/services/user/UserService.java): `sm-core/src/main/java/com/salesmanager/core/business/services/user/UserService.java`
- [Merchant Stores](https://github.com/shopizer-ecommerce/shopizer/blob/3.2.7/sm-core/src/main/java/com/salesmanager/core/business/services/merchant/MerchantStoreService.java): `sm-core/src/main/java/com/salesmanager/core/business/services/merchant/MerchantStoreService.java`

### Commerce Domain

- [Product Model](https://github.com/shopizer-ecommerce/shopizer/blob/3.2.7/sm-core-model/src/main/java/com/salesmanager/core/model/catalog/product/Product.java): `sm-core-model/src/main/java/com/salesmanager/core/model/catalog/product/Product.java`
- [Cart Model](https://github.com/shopizer-ecommerce/shopizer/blob/3.2.7/sm-core-model/src/main/java/com/salesmanager/core/model/shoppingcart/ShoppingCart.java): `sm-core-model/src/main/java/com/salesmanager/core/model/shoppingcart/ShoppingCart.java`
- [Order Model](https://github.com/shopizer-ecommerce/shopizer/blob/3.2.7/sm-core-model/src/main/java/com/salesmanager/core/model/order/Order.java): `sm-core-model/src/main/java/com/salesmanager/core/model/order/Order.java`
- [Customer Model](https://github.com/shopizer-ecommerce/shopizer/blob/3.2.7/sm-core-model/src/main/java/com/salesmanager/core/model/customer/Customer.java): `sm-core-model/src/main/java/com/salesmanager/core/model/customer/Customer.java`

### Platform Services

- [Content and Media](https://github.com/shopizer-ecommerce/shopizer/blob/3.2.7/sm-core/src/main/java/com/salesmanager/core/business/services/content/ContentService.java): `sm-core/src/main/java/com/salesmanager/core/business/services/content/ContentService.java`
- [Entity Services](https://github.com/shopizer-ecommerce/shopizer/blob/3.2.7/sm-core/src/main/java/com/salesmanager/core/business/services/common/generic/SalesManagerEntityService.java): `sm-core/src/main/java/com/salesmanager/core/business/services/common/generic/SalesManagerEntityService.java`

### Other components

- **Shopper**

## Connections

- Shopper → REST API: uses APIs
- REST API → Catalog: routes catalog
- REST API → Product Search: routes search
- REST API → Shopping Cart: routes cart
- REST API → Customers: routes customers
- REST API → Orders: routes orders
- Shopping Cart → Pricing: uses pricing
- Shopping Cart → Shipping: requests quotes
- Shopping Cart → Payments: checkout payment
- Shopping Cart → Orders: creates orders
- Catalog → Product Model: manages products
- Shopping Cart → Cart Model: manages carts (evidence: `sm-core/src/main/java/com/salesmanager/core/business/services/shoppingcart/ShoppingCartService.java`)
- Orders → Order Model: manages orders (evidence: `sm-core/src/main/java/com/salesmanager/core/business/services/order/OrderService.java`)
- Customers → Customer Model: manages customers
- REST API → Merchant Stores: serves stores
- REST API → Users: serves users
- Image Delivery → Content and Media: loads content files (evidence: `sm-shop/src/main/java/com/salesmanager/shop/controller/ImagesController.java`)
- Entity Services → Product Model: supports entities
