# ironbats/shopizer architecture

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

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

## Overview

Shopizer is a Java headless-commerce backend exposing a REST API for storefront and administration clients. The documented user journey spans catalog discovery, cart, checkout, and order handling, with customer and merchant capabilities alongside it. The graph separates API entry, domain services, and commerce models; search, content/images, shipping, and payment are additional capabilities. The README and source index establish the product shape, while sampled excerpts confirm only selected service contracts and image/content calls; other internal links are left unverified.

Main entry points: [`sm-shop/src/main/java/com/salesmanager/shop/store/api`](https://github.com/ironbats/shopizer/tree/main/sm-shop/src/main/java/com/salesmanager/shop/store/api) (REST backend), [`sm-core/src/main/java/com/salesmanager/core/business/services/shoppingcart/ShoppingCartService.java`](https://github.com/ironbats/shopizer/blob/main/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/ironbats/shopizer/blob/main/sm-core/src/main/java/com/salesmanager/core/business/services/order/OrderService.java) (Order handling), [`sm-core/src/main/java/com/salesmanager/core/business/services/catalog/product/ProductService.java`](https://github.com/ironbats/shopizer/blob/main/sm-core/src/main/java/com/salesmanager/core/business/services/catalog/product/ProductService.java) (Product catalog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["API and access"]
  node_rest["REST backend"]
  node_security["API security"]
end

subgraph group_catalog["Catalog and content"]
  node_product_service["Product catalog"]
  node_category_service["Categories"]
  node_search_service["Product search<br/>[SearchService.java]"]
  node_content_service["Store content"]
  node_images["Image delivery"]
end

subgraph group_commerce["Commerce operations"]
  node_cart_service["Shopping cart"]
  node_shipping_service["Shipping quotes"]
  node_tax_service["Tax rates"]
  node_payment_service["Payments"]
  node_order_service["Order handling<br/>[OrderService.java]"]
end

subgraph group_domain["Commerce data"]
  node_product_model["Products and variants<br/>[Product.java]"]
  node_customer_model["Customers<br/>[Customer.java]"]
  node_cart_model["Cart and items<br/>[ShoppingCart.java]"]
  node_order_model["Order records<br/>[Order.java]"]
  node_merchant_model["Merchant stores<br/>[MerchantStore.java]"]
  node_language_model["Languages<br/>[Language.java]"]
end

subgraph group_foundation["Core services"]
  node_entity_service["Entity service layer"]
  node_entity_model["Persistent entities"]
  node_audit["Audit model"]
end

node_storefront(("Storefront client"))
node_admin(("Admin client"))

node_storefront -->|"uses API"| node_rest
node_admin -->|"uses API"| node_rest
node_rest -.->|"authenticates through"| node_security
node_rest -.->|"routes requests"| node_product_service
node_rest -.->|"routes requests"| node_cart_service
node_rest -.->|"routes requests"| node_order_service
node_rest -.->|"routes requests"| node_payment_service
node_search_service -->|"queries"| node_product_model
node_images -->|"gets content files"| node_content_service
node_cart_service -.->|"requests quotes"| node_shipping_service
node_cart_service -.->|"calculates tax"| node_tax_service
node_order_service -.->|"processes payment"| node_payment_service
node_product_service -.->|"manages products"| node_product_model
node_cart_service -.->|"manages cart"| node_cart_model
node_order_service -.->|"manages orders"| node_order_model
node_entity_service -->|"constrains entities"| node_entity_model

click node_rest "https://github.com/ironbats/shopizer/tree/main/sm-shop/src/main/java/com/salesmanager/shop/store/api"
click node_security "https://github.com/ironbats/shopizer/tree/main/sm-shop/src/main/java/com/salesmanager/shop/store/security"
click node_product_service "https://github.com/ironbats/shopizer/blob/main/sm-core/src/main/java/com/salesmanager/core/business/services/catalog/product/ProductService.java"
click node_category_service "https://github.com/ironbats/shopizer/blob/main/sm-core/src/main/java/com/salesmanager/core/business/services/catalog/category/CategoryService.java"
click node_search_service "https://github.com/ironbats/shopizer/blob/main/sm-core/src/main/java/com/salesmanager/core/business/services/search/SearchService.java"
click node_content_service "https://github.com/ironbats/shopizer/blob/main/sm-core/src/main/java/com/salesmanager/core/business/services/content/ContentService.java"
click node_images "https://github.com/ironbats/shopizer/blob/main/sm-shop/src/main/java/com/salesmanager/shop/controller/ImagesController.java"
click node_cart_service "https://github.com/ironbats/shopizer/blob/main/sm-core/src/main/java/com/salesmanager/core/business/services/shoppingcart/ShoppingCartService.java"
click node_shipping_service "https://github.com/ironbats/shopizer/blob/main/sm-core/src/main/java/com/salesmanager/core/business/services/shipping/ShippingService.java"
click node_tax_service "https://github.com/ironbats/shopizer/blob/main/sm-core/src/main/java/com/salesmanager/core/business/services/tax/TaxRateService.java"
click node_payment_service "https://github.com/ironbats/shopizer/blob/main/sm-core/src/main/java/com/salesmanager/core/business/services/payments/PaymentService.java"
click node_order_service "https://github.com/ironbats/shopizer/blob/main/sm-core/src/main/java/com/salesmanager/core/business/services/order/OrderService.java"
click node_product_model "https://github.com/ironbats/shopizer/blob/main/sm-core-model/src/main/java/com/salesmanager/core/model/catalog/product/Product.java"
click node_customer_model "https://github.com/ironbats/shopizer/blob/main/sm-core-model/src/main/java/com/salesmanager/core/model/customer/Customer.java"
click node_cart_model "https://github.com/ironbats/shopizer/blob/main/sm-core-model/src/main/java/com/salesmanager/core/model/shoppingcart/ShoppingCart.java"
click node_order_model "https://github.com/ironbats/shopizer/blob/main/sm-core-model/src/main/java/com/salesmanager/core/model/order/Order.java"
click node_merchant_model "https://github.com/ironbats/shopizer/blob/main/sm-core-model/src/main/java/com/salesmanager/core/model/merchant/MerchantStore.java"
click node_language_model "https://github.com/ironbats/shopizer/blob/main/sm-core-model/src/main/java/com/salesmanager/core/model/reference/language/Language.java"
click node_entity_service "https://github.com/ironbats/shopizer/blob/main/sm-core/src/main/java/com/salesmanager/core/business/services/common/generic/SalesManagerEntityService.java"
click node_entity_model "https://github.com/ironbats/shopizer/blob/main/sm-core-model/src/main/java/com/salesmanager/core/model/generic/SalesManagerEntity.java"
click node_audit "https://github.com/ironbats/shopizer/tree/main/sm-core-model/src/main/java/com/salesmanager/core/model/common/audit"

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_security,node_storefront,node_admin toneBlue
class node_product_service,node_category_service,node_search_service,node_content_service,node_images toneAmber
class node_cart_service,node_shipping_service,node_tax_service,node_payment_service,node_order_service toneMint
class node_product_model,node_customer_model,node_cart_model,node_order_model,node_merchant_model,node_language_model toneRose
class node_entity_service,node_entity_model,node_audit toneIndigo
```

## Components

### API and access

- [REST backend](https://github.com/ironbats/shopizer/tree/main/sm-shop/src/main/java/com/salesmanager/shop/store/api): `sm-shop/src/main/java/com/salesmanager/shop/store/api`
- [API security](https://github.com/ironbats/shopizer/tree/main/sm-shop/src/main/java/com/salesmanager/shop/store/security): `sm-shop/src/main/java/com/salesmanager/shop/store/security`

### Catalog and content

- [Product catalog](https://github.com/ironbats/shopizer/blob/main/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`
- [Categories](https://github.com/ironbats/shopizer/blob/main/sm-core/src/main/java/com/salesmanager/core/business/services/catalog/category/CategoryService.java): `sm-core/src/main/java/com/salesmanager/core/business/services/catalog/category/CategoryService.java`
- [Product search](https://github.com/ironbats/shopizer/blob/main/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`
- [Store content](https://github.com/ironbats/shopizer/blob/main/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`
- [Image delivery](https://github.com/ironbats/shopizer/blob/main/sm-shop/src/main/java/com/salesmanager/shop/controller/ImagesController.java): `sm-shop/src/main/java/com/salesmanager/shop/controller/ImagesController.java`

### Commerce operations

- [Shopping cart](https://github.com/ironbats/shopizer/blob/main/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`
- [Shipping quotes](https://github.com/ironbats/shopizer/blob/main/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`
- [Tax rates](https://github.com/ironbats/shopizer/blob/main/sm-core/src/main/java/com/salesmanager/core/business/services/tax/TaxRateService.java): `sm-core/src/main/java/com/salesmanager/core/business/services/tax/TaxRateService.java`
- [Payments](https://github.com/ironbats/shopizer/blob/main/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`
- [Order handling](https://github.com/ironbats/shopizer/blob/main/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`

### Commerce data

- [Products and variants](https://github.com/ironbats/shopizer/blob/main/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`
- [Customers](https://github.com/ironbats/shopizer/blob/main/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`
- [Cart and items](https://github.com/ironbats/shopizer/blob/main/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 records](https://github.com/ironbats/shopizer/blob/main/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`
- [Merchant stores](https://github.com/ironbats/shopizer/blob/main/sm-core-model/src/main/java/com/salesmanager/core/model/merchant/MerchantStore.java): `sm-core-model/src/main/java/com/salesmanager/core/model/merchant/MerchantStore.java`
- [Languages](https://github.com/ironbats/shopizer/blob/main/sm-core-model/src/main/java/com/salesmanager/core/model/reference/language/Language.java): `sm-core-model/src/main/java/com/salesmanager/core/model/reference/language/Language.java`

### Core services

- [Entity service layer](https://github.com/ironbats/shopizer/blob/main/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`
- [Persistent entities](https://github.com/ironbats/shopizer/blob/main/sm-core-model/src/main/java/com/salesmanager/core/model/generic/SalesManagerEntity.java): `sm-core-model/src/main/java/com/salesmanager/core/model/generic/SalesManagerEntity.java`
- [Audit model](https://github.com/ironbats/shopizer/tree/main/sm-core-model/src/main/java/com/salesmanager/core/model/common/audit): `sm-core-model/src/main/java/com/salesmanager/core/model/common/audit`

### Other components

- **Storefront client**
- **Admin client**

## Connections

- Storefront client → REST backend: uses API
- Admin client → REST backend: uses API
- REST backend → API security: authenticates through
- REST backend → Product catalog: routes requests
- REST backend → Shopping cart: routes requests
- REST backend → Order handling: routes requests
- REST backend → Payments: routes requests
- Product search → Products and variants: queries (evidence: `sm-core/src/main/java/com/salesmanager/core/business/services/search/SearchService.java`)
- Image delivery → Store content: gets content files (evidence: `sm-shop/src/main/java/com/salesmanager/shop/controller/ImagesController.java`)
- Shopping cart → Shipping quotes: requests quotes
- Shopping cart → Tax rates: calculates tax
- Order handling → Payments: processes payment
- Product catalog → Products and variants: manages products
- Shopping cart → Cart and items: manages cart (evidence: `sm-core/src/main/java/com/salesmanager/core/business/services/shoppingcart/ShoppingCartService.java`)
- Order handling → Order records: manages orders (evidence: `sm-core/src/main/java/com/salesmanager/core/business/services/order/OrderService.java`)
- Entity service layer → Persistent entities: constrains entities (evidence: `sm-core/src/main/java/com/salesmanager/core/business/services/common/generic/SalesManagerEntityService.java`)
