# seiger/scommerce architecture

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

- Interactive diagram: https://gitdiagram.com/seiger/scommerce
- Repository: https://github.com/seiger/scommerce

## Overview

sCommerce turns Evolution CMS into an online store: shoppers browse and filter products, add items to a cart, and place orders through checkout; managers maintain the catalog and operate on orders. The graph also preserves documented capabilities for wishlist, reviews, delivery and payment methods, currency, and commerce integrations. Source-index references and excerpts support the principal component links; several less-sampled manager and integration branches are documented capabilities, so their internal wiring is not asserted.

Main entry points: [`src/Checkout/sCheckout.php`](https://github.com/seiger/scommerce/blob/1.x/src/Checkout/sCheckout.php) (Checkout), [`src/Http/routes.php`](https://github.com/seiger/scommerce/blob/1.x/src/Http/routes.php) (Storefront routes), [`src/Models/sOrder.php`](https://github.com/seiger/scommerce/blob/1.x/src/Models/sOrder.php) (Orders), [`src/Controllers/sCommerceController.php`](https://github.com/seiger/scommerce/blob/1.x/src/Controllers/sCommerceController.php) (Catalog controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront"]
  node_storefront_routes["Storefront routes<br/>[routes.php]"]
  node_catalog["Catalog controller"]
  node_products[("Products<br/>[sProduct.php]")]
  node_filters["Product filters<br/>[sFilter.php]"]
  node_reviews[("Reviews<br/>[sReview.php]")]
  node_wishlist["Wishlist<br/>[sWishlist.php]"]
end

subgraph group_commerce["Commerce workflow"]
  node_cart["Cart<br/>[sCart.php]"]
  node_checkout["Checkout<br/>[sCheckout.php]"]
  node_pricing["Price resolver<br/>[sPriceResolver.php]"]
  node_delivery["Delivery methods"]
  node_payments["Payment methods<br/>[PaymentFlow.php]"]
  node_orders[("Orders<br/>[sOrder.php]")]
end

subgraph group_management["Store management"]
  node_manager["Manager module"]
  node_order_repeat["Order repeat"]
  node_order_repeater["Order repeater<br/>[OrderRepeater.php]"]
  node_bulk_status["Bulk status"]
  node_status_updater["Status updater"]
  node_bulk_actions["Bulk order actions"]
end

subgraph group_integrations["Integrations"]
  node_csv["CSV import/export"]
  node_merchant_feed["Merchant feed"]
  node_listing_cache["Listing cache"]
  node_dashboard_metrics["Dashboard metrics"]
end

node_shopper(("Shopper"))

node_shopper -->|"submits requests"| node_storefront_routes
node_storefront_routes -->|"routes checkout"| node_checkout
node_storefront_routes -->|"routes cart"| node_cart
node_storefront_routes -->|"routes wishlist"| node_wishlist
node_catalog -->|"queries products"| node_products
node_catalog -->|"uses filters"| node_filters
node_catalog -->|"uses wishlist"| node_wishlist
node_checkout -->|"reads cart"| node_cart
node_checkout -->|"resolves prices"| node_pricing
node_checkout -->|"loads methods"| node_delivery
node_checkout -->|"loads methods"| node_payments
node_checkout -->|"creates orders"| node_orders
node_order_repeat -->|"loads source order"| node_orders
node_order_repeat -->|"saves repeat"| node_order_repeater
node_bulk_status -->|"loads and saves"| node_orders
node_bulk_status -->|"applies status"| node_status_updater
node_bulk_actions -->|"loads and updates"| node_orders
node_bulk_actions -->|"gets delivery data"| node_delivery
node_manager -->|"dispatches repeat"| node_order_repeat
node_shopper -.->|"rates products"| node_reviews
node_manager -.->|"manages imports"| node_csv
node_products -->|"supplies products"| node_merchant_feed
node_products -.->|"uses listing cache"| node_listing_cache
node_manager -.->|"views metrics"| node_dashboard_metrics

click node_storefront_routes "https://github.com/seiger/scommerce/blob/1.x/src/Http/routes.php"
click node_catalog "https://github.com/seiger/scommerce/blob/1.x/src/Controllers/sCommerceController.php"
click node_products "https://github.com/seiger/scommerce/blob/1.x/src/Models/sProduct.php"
click node_filters "https://github.com/seiger/scommerce/blob/1.x/src/Filter/sFilter.php"
click node_reviews "https://github.com/seiger/scommerce/blob/1.x/src/Models/sReview.php"
click node_wishlist "https://github.com/seiger/scommerce/blob/1.x/src/Wishlist/sWishlist.php"
click node_cart "https://github.com/seiger/scommerce/blob/1.x/src/Cart/sCart.php"
click node_checkout "https://github.com/seiger/scommerce/blob/1.x/src/Checkout/sCheckout.php"
click node_pricing "https://github.com/seiger/scommerce/blob/1.x/src/Services/sPriceResolver.php"
click node_delivery "https://github.com/seiger/scommerce/blob/1.x/src/Delivery/BaseDeliveryMethod.php"
click node_payments "https://github.com/seiger/scommerce/blob/1.x/src/Payment/PaymentFlow.php"
click node_orders "https://github.com/seiger/scommerce/blob/1.x/src/Models/sOrder.php"
click node_manager "https://github.com/seiger/scommerce/blob/1.x/module/sCommerceModule.php"
click node_order_repeat "https://github.com/seiger/scommerce/blob/1.x/src/Controllers/OrderRepeatController.php"
click node_order_repeater "https://github.com/seiger/scommerce/blob/1.x/src/Services/OrderRepeater.php"
click node_bulk_status "https://github.com/seiger/scommerce/blob/1.x/src/Controllers/OrderBulkStatusController.php"
click node_status_updater "https://github.com/seiger/scommerce/blob/1.x/src/Services/OrderStatusUpdater.php"
click node_bulk_actions "https://github.com/seiger/scommerce/blob/1.x/src/Controllers/OrderBulkMenuController.php"
click node_csv "https://github.com/seiger/scommerce/blob/1.x/src/Integration/ImportExportCSV.php"
click node_merchant_feed "https://github.com/seiger/scommerce/blob/1.x/src/Integration/GoogleMerchantFeed.php"
click node_listing_cache "https://github.com/seiger/scommerce/blob/1.x/src/Integration/ProductsListingCache.php"
click node_dashboard_metrics "https://github.com/seiger/scommerce/blob/1.x/src/Integration/DashboardMetrics.php"

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_routes,node_catalog,node_products,node_filters,node_reviews,node_wishlist toneBlue
class node_cart,node_checkout,node_pricing,node_delivery,node_payments,node_orders toneAmber
class node_manager,node_order_repeat,node_order_repeater,node_bulk_status,node_status_updater,node_bulk_actions toneMint
class node_csv,node_merchant_feed,node_listing_cache,node_dashboard_metrics toneRose
class node_shopper toneIndigo
```

## Components

### Storefront

- [Storefront routes](https://github.com/seiger/scommerce/blob/1.x/src/Http/routes.php): `src/Http/routes.php`
- [Catalog controller](https://github.com/seiger/scommerce/blob/1.x/src/Controllers/sCommerceController.php): `src/Controllers/sCommerceController.php`
- [Products](https://github.com/seiger/scommerce/blob/1.x/src/Models/sProduct.php): `src/Models/sProduct.php`
- [Product filters](https://github.com/seiger/scommerce/blob/1.x/src/Filter/sFilter.php): `src/Filter/sFilter.php`
- [Reviews](https://github.com/seiger/scommerce/blob/1.x/src/Models/sReview.php): `src/Models/sReview.php`
- [Wishlist](https://github.com/seiger/scommerce/blob/1.x/src/Wishlist/sWishlist.php): `src/Wishlist/sWishlist.php`

### Commerce workflow

- [Cart](https://github.com/seiger/scommerce/blob/1.x/src/Cart/sCart.php): `src/Cart/sCart.php`
- [Checkout](https://github.com/seiger/scommerce/blob/1.x/src/Checkout/sCheckout.php): `src/Checkout/sCheckout.php`
- [Price resolver](https://github.com/seiger/scommerce/blob/1.x/src/Services/sPriceResolver.php): `src/Services/sPriceResolver.php`
- [Delivery methods](https://github.com/seiger/scommerce/blob/1.x/src/Delivery/BaseDeliveryMethod.php): `src/Delivery/BaseDeliveryMethod.php`
- [Payment methods](https://github.com/seiger/scommerce/blob/1.x/src/Payment/PaymentFlow.php): `src/Payment/PaymentFlow.php`
- [Orders](https://github.com/seiger/scommerce/blob/1.x/src/Models/sOrder.php): `src/Models/sOrder.php`

### Store management

- [Manager module](https://github.com/seiger/scommerce/blob/1.x/module/sCommerceModule.php): `module/sCommerceModule.php`
- [Order repeat](https://github.com/seiger/scommerce/blob/1.x/src/Controllers/OrderRepeatController.php): `src/Controllers/OrderRepeatController.php`
- [Order repeater](https://github.com/seiger/scommerce/blob/1.x/src/Services/OrderRepeater.php): `src/Services/OrderRepeater.php`
- [Bulk status](https://github.com/seiger/scommerce/blob/1.x/src/Controllers/OrderBulkStatusController.php): `src/Controllers/OrderBulkStatusController.php`
- [Status updater](https://github.com/seiger/scommerce/blob/1.x/src/Services/OrderStatusUpdater.php): `src/Services/OrderStatusUpdater.php`
- [Bulk order actions](https://github.com/seiger/scommerce/blob/1.x/src/Controllers/OrderBulkMenuController.php): `src/Controllers/OrderBulkMenuController.php`

### Integrations

- [CSV import/export](https://github.com/seiger/scommerce/blob/1.x/src/Integration/ImportExportCSV.php): `src/Integration/ImportExportCSV.php`
- [Merchant feed](https://github.com/seiger/scommerce/blob/1.x/src/Integration/GoogleMerchantFeed.php): `src/Integration/GoogleMerchantFeed.php`
- [Listing cache](https://github.com/seiger/scommerce/blob/1.x/src/Integration/ProductsListingCache.php): `src/Integration/ProductsListingCache.php`
- [Dashboard metrics](https://github.com/seiger/scommerce/blob/1.x/src/Integration/DashboardMetrics.php): `src/Integration/DashboardMetrics.php`

### Other components

- **Shopper**

## Connections

- Shopper → Storefront routes: submits requests (evidence: `src/Http/routes.php`)
- Storefront routes → Checkout: routes checkout (evidence: `src/Http/routes.php`)
- Storefront routes → Cart: routes cart (evidence: `src/Http/routes.php`)
- Storefront routes → Wishlist: routes wishlist (evidence: `src/Http/routes.php`)
- Catalog controller → Products: queries products (evidence: `src/Controllers/sCommerceController.php`)
- Catalog controller → Product filters: uses filters (evidence: `src/Controllers/sCommerceController.php`)
- Catalog controller → Wishlist: uses wishlist (evidence: `src/Controllers/sCommerceController.php`)
- Checkout → Cart: reads cart (evidence: `src/Checkout/sCheckout.php`)
- Checkout → Price resolver: resolves prices (evidence: `src/Checkout/sCheckout.php`)
- Checkout → Delivery methods: loads methods (evidence: `src/Checkout/sCheckout.php`)
- Checkout → Payment methods: loads methods (evidence: `src/Checkout/sCheckout.php`)
- Checkout → Orders: creates orders (evidence: `src/Checkout/sCheckout.php`)
- Order repeat → Orders: loads source order (evidence: `src/Controllers/OrderRepeatController.php`)
- Order repeat → Order repeater: saves repeat (evidence: `src/Controllers/OrderRepeatController.php`)
- Bulk status → Orders: loads and saves (evidence: `src/Controllers/OrderBulkStatusController.php`)
- Bulk status → Status updater: applies status (evidence: `src/Controllers/OrderBulkStatusController.php`)
- Bulk order actions → Orders: loads and updates (evidence: `src/Controllers/OrderBulkMenuController.php`)
- Bulk order actions → Delivery methods: gets delivery data (evidence: `src/Controllers/OrderBulkMenuController.php`)
- Manager module → Order repeat: dispatches repeat (evidence: `module/sCommerceModule.php`)
- Shopper → Reviews: rates products (evidence: `README.md`)
- Manager module → CSV import/export: manages imports (evidence: `README.md`)
- Products → Merchant feed: supplies products (evidence: `src/Integration/GoogleMerchantFeed.php`)
- Products → Listing cache: uses listing cache
- Manager module → Dashboard metrics: views metrics (evidence: `README.md`)
