# nopsolutions/nopcommerce architecture

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

- Interactive diagram: https://gitdiagram.com/nopsolutions/nopcommerce
- Repository: https://github.com/nopsolutions/nopcommerce

## Overview

nopCommerce is an ASP.NET Core e-commerce platform. A customer-facing request enters the web application, where customer/account and shopping-cart or checkout features lead to store capabilities such as catalog, orders, payment, tax, and shipping; administrators manage products and reviews separately. The repository also defines content, localization, security, and plugin extension capabilities. The excerpts show selected controller-to-service and framework-to-engine references, but not the complete checkout or persistence call chain, so those broader relationships are documented at capability level rather than asserted as exact calls.

Main entry points: [`src/Presentation/Nop.Web/Controllers`](https://github.com/nopsolutions/nopcommerce/tree/develop/src/Presentation/Nop.Web/Controllers) (Cart and checkout), [`src/Libraries/Nop.Services/Plugins/PluginManager.cs`](https://github.com/nopsolutions/nopcommerce/blob/develop/src/Libraries/Nop.Services/Plugins/PluginManager.cs) (Plugin framework), [`src/Presentation/Nop.Web/Controllers/CustomerController.cs`](https://github.com/nopsolutions/nopcommerce/blob/develop/src/Presentation/Nop.Web/Controllers/CustomerController.cs) (Customer accounts), [`src/Presentation/Nop.Web/Areas/Admin/Controllers/ProductController.cs`](https://github.com/nopsolutions/nopcommerce/blob/develop/src/Presentation/Nop.Web/Areas/Admin/Controllers/ProductController.cs) (Admin catalog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_webapp["Storefront<br/>[Controllers]"]
  node_customer["Customer accounts"]
  node_cart["Cart and checkout<br/>[Controllers]"]
  node_admin["Admin catalog"]
  node_reviews["Review management"]
  node_content["Content and widgets<br/>[Cms]"]
end

subgraph group_commerce["Commerce domains"]
  node_catalog["Product catalog<br/>[IProductService.cs]"]
  node_orders["Orders<br/>[IOrderService.cs]"]
  node_customers["Customer services"]
  node_domain["Domain models<br/>[Domain]"]
end

subgraph group_platform["Core platform"]
  node_localization["Localization"]
  node_security["Permissions"]
  node_framework["Web framework<br/>[BaseController.cs]"]
  node_engine["Dependency engine<br/>[EngineContext.cs]"]
  node_cache["Cache services<br/>[Caching]"]
  node_data[("Data access<br/>[Nop.Data]")]
end

subgraph group_extensions["Plugins and integrations"]
  node_payments["Payment plugins<br/>[Payments]"]
  node_shipping["Shipping plugins<br/>[Shipping]"]
  node_tax["Tax plugins<br/>[Tax]"]
  node_plugins["Plugin framework<br/>[PluginManager.cs]"]
  node_webapi["Web API plugin"]
end

subgraph group_operations["Store operations"]
end

node_shopper(("Shopper"))
node_external["External services"]
node_storeowner(("Store administrator"))

node_shopper -->|"browses store"| node_webapp
node_webapp -.->|"account requests"| node_customer
node_webapp -.->|"shopping requests"| node_cart
node_customer -->|"uses customer service"| node_customers
node_customer -->|"inherits controller"| node_framework
node_storeowner -.->|"manages catalog"| node_admin
node_admin -.->|"uses product service"| node_catalog
node_storeowner -.->|"manages reviews"| node_reviews
node_reviews -->|"uses review services"| node_catalog
node_cart -.->|"checkout orders"| node_orders
node_cart -.->|"payment integration"| node_payments
node_cart -.->|"shipping options"| node_shipping
node_cart -.->|"tax calculation"| node_tax
node_orders -->|"uses order models"| node_domain
node_catalog -->|"uses catalog models"| node_domain
node_webapp -.->|"presents store content"| node_content
node_framework -->|"resolves services"| node_engine
node_plugins -.->|"integrates services"| node_external
node_plugins -.->|"registers providers"| node_payments
node_plugins -.->|"registers providers"| node_shipping
node_plugins -.->|"registers providers"| node_tax
node_shopper -.->|"API integration"| node_webapi
node_webapi -->|"serves REST clients"| node_external
node_engine -.->|"configures services"| node_cache
node_engine -.->|"configures services"| node_data
node_framework -->|"uses localization"| node_localization
node_admin -->|"checks permissions"| node_security

click node_webapp "https://github.com/nopsolutions/nopcommerce/tree/develop/src/Presentation/Nop.Web/Controllers"
click node_customer "https://github.com/nopsolutions/nopcommerce/blob/develop/src/Presentation/Nop.Web/Controllers/CustomerController.cs"
click node_cart "https://github.com/nopsolutions/nopcommerce/tree/develop/src/Presentation/Nop.Web/Controllers"
click node_admin "https://github.com/nopsolutions/nopcommerce/blob/develop/src/Presentation/Nop.Web/Areas/Admin/Controllers/ProductController.cs"
click node_reviews "https://github.com/nopsolutions/nopcommerce/blob/develop/src/Presentation/Nop.Web/Areas/Admin/Controllers/ProductReviewController.cs"
click node_catalog "https://github.com/nopsolutions/nopcommerce/blob/develop/src/Libraries/Nop.Services/Catalog/IProductService.cs"
click node_orders "https://github.com/nopsolutions/nopcommerce/blob/develop/src/Libraries/Nop.Services/Orders/IOrderService.cs"
click node_customers "https://github.com/nopsolutions/nopcommerce/blob/develop/src/Libraries/Nop.Services/Customers/ICustomerService.cs"
click node_payments "https://github.com/nopsolutions/nopcommerce/tree/develop/src/Libraries/Nop.Services/Payments"
click node_shipping "https://github.com/nopsolutions/nopcommerce/tree/develop/src/Libraries/Nop.Services/Shipping"
click node_tax "https://github.com/nopsolutions/nopcommerce/tree/develop/src/Libraries/Nop.Services/Tax"
click node_content "https://github.com/nopsolutions/nopcommerce/tree/develop/src/Libraries/Nop.Core/Domain/Cms"
click node_localization "https://github.com/nopsolutions/nopcommerce/blob/develop/src/Libraries/Nop.Services/Localization/ILocalizationService.cs"
click node_security "https://github.com/nopsolutions/nopcommerce/blob/develop/src/Libraries/Nop.Services/Security/StandardPermission.cs"
click node_framework "https://github.com/nopsolutions/nopcommerce/blob/develop/src/Presentation/Nop.Web.Framework/Controllers/BaseController.cs"
click node_engine "https://github.com/nopsolutions/nopcommerce/blob/develop/src/Libraries/Nop.Core/Infrastructure/EngineContext.cs"
click node_cache "https://github.com/nopsolutions/nopcommerce/tree/develop/src/Libraries/Nop.Core/Caching"
click node_domain "https://github.com/nopsolutions/nopcommerce/tree/develop/src/Libraries/Nop.Core/Domain"
click node_data "https://github.com/nopsolutions/nopcommerce/tree/develop/src/Libraries/Nop.Data"
click node_plugins "https://github.com/nopsolutions/nopcommerce/blob/develop/src/Libraries/Nop.Services/Plugins/PluginManager.cs"
click node_webapi "https://github.com/nopsolutions/nopcommerce/tree/develop/src/Plugins"

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_webapp,node_customer,node_cart,node_admin,node_reviews,node_content toneBlue
class node_catalog,node_orders,node_customers,node_domain toneAmber
class node_localization,node_security,node_framework,node_engine,node_cache,node_data toneMint
class node_payments,node_shipping,node_tax,node_plugins,node_webapi toneRose
class node_shopper,node_external,node_storeowner toneIndigo
```

## Components

### Web experience

- [Storefront](https://github.com/nopsolutions/nopcommerce/tree/develop/src/Presentation/Nop.Web/Controllers): `src/Presentation/Nop.Web/Controllers`
- [Customer accounts](https://github.com/nopsolutions/nopcommerce/blob/develop/src/Presentation/Nop.Web/Controllers/CustomerController.cs): `src/Presentation/Nop.Web/Controllers/CustomerController.cs`
- [Cart and checkout](https://github.com/nopsolutions/nopcommerce/tree/develop/src/Presentation/Nop.Web/Controllers): `src/Presentation/Nop.Web/Controllers`
- [Admin catalog](https://github.com/nopsolutions/nopcommerce/blob/develop/src/Presentation/Nop.Web/Areas/Admin/Controllers/ProductController.cs): `src/Presentation/Nop.Web/Areas/Admin/Controllers/ProductController.cs`
- [Review management](https://github.com/nopsolutions/nopcommerce/blob/develop/src/Presentation/Nop.Web/Areas/Admin/Controllers/ProductReviewController.cs): `src/Presentation/Nop.Web/Areas/Admin/Controllers/ProductReviewController.cs`
- [Content and widgets](https://github.com/nopsolutions/nopcommerce/tree/develop/src/Libraries/Nop.Core/Domain/Cms): `src/Libraries/Nop.Core/Domain/Cms`

### Commerce domains

- [Product catalog](https://github.com/nopsolutions/nopcommerce/blob/develop/src/Libraries/Nop.Services/Catalog/IProductService.cs): `src/Libraries/Nop.Services/Catalog/IProductService.cs`
- [Orders](https://github.com/nopsolutions/nopcommerce/blob/develop/src/Libraries/Nop.Services/Orders/IOrderService.cs): `src/Libraries/Nop.Services/Orders/IOrderService.cs`
- [Customer services](https://github.com/nopsolutions/nopcommerce/blob/develop/src/Libraries/Nop.Services/Customers/ICustomerService.cs): `src/Libraries/Nop.Services/Customers/ICustomerService.cs`
- [Domain models](https://github.com/nopsolutions/nopcommerce/tree/develop/src/Libraries/Nop.Core/Domain): `src/Libraries/Nop.Core/Domain`

### Core platform

- [Localization](https://github.com/nopsolutions/nopcommerce/blob/develop/src/Libraries/Nop.Services/Localization/ILocalizationService.cs): `src/Libraries/Nop.Services/Localization/ILocalizationService.cs`
- [Permissions](https://github.com/nopsolutions/nopcommerce/blob/develop/src/Libraries/Nop.Services/Security/StandardPermission.cs): `src/Libraries/Nop.Services/Security/StandardPermission.cs`
- [Web framework](https://github.com/nopsolutions/nopcommerce/blob/develop/src/Presentation/Nop.Web.Framework/Controllers/BaseController.cs): `src/Presentation/Nop.Web.Framework/Controllers/BaseController.cs`
- [Dependency engine](https://github.com/nopsolutions/nopcommerce/blob/develop/src/Libraries/Nop.Core/Infrastructure/EngineContext.cs): `src/Libraries/Nop.Core/Infrastructure/EngineContext.cs`
- [Cache services](https://github.com/nopsolutions/nopcommerce/tree/develop/src/Libraries/Nop.Core/Caching): `src/Libraries/Nop.Core/Caching`
- [Data access](https://github.com/nopsolutions/nopcommerce/tree/develop/src/Libraries/Nop.Data): `src/Libraries/Nop.Data`

### Plugins and integrations

- [Payment plugins](https://github.com/nopsolutions/nopcommerce/tree/develop/src/Libraries/Nop.Services/Payments): `src/Libraries/Nop.Services/Payments`
- [Shipping plugins](https://github.com/nopsolutions/nopcommerce/tree/develop/src/Libraries/Nop.Services/Shipping): `src/Libraries/Nop.Services/Shipping`
- [Tax plugins](https://github.com/nopsolutions/nopcommerce/tree/develop/src/Libraries/Nop.Services/Tax): `src/Libraries/Nop.Services/Tax`
- [Plugin framework](https://github.com/nopsolutions/nopcommerce/blob/develop/src/Libraries/Nop.Services/Plugins/PluginManager.cs): `src/Libraries/Nop.Services/Plugins/PluginManager.cs`
- [Web API plugin](https://github.com/nopsolutions/nopcommerce/tree/develop/src/Plugins): `src/Plugins`

### Other components

- **Shopper**
- **External services**
- **Store administrator**

## Connections

- Shopper → Storefront: browses store (evidence: `README.md`)
- Storefront → Customer accounts: account requests (evidence: `src/Presentation/Nop.Web/Controllers/CustomerController.cs`)
- Storefront → Cart and checkout: shopping requests
- Customer accounts → Customer services: uses customer service (evidence: `src/Presentation/Nop.Web/Controllers/CustomerController.cs`)
- Customer accounts → Web framework: inherits controller (evidence: `src/Presentation/Nop.Web/Controllers/CustomerController.cs`)
- Store administrator → Admin catalog: manages catalog
- Admin catalog → Product catalog: uses product service
- Store administrator → Review management: manages reviews
- Review management → Product catalog: uses review services (evidence: `src/Presentation/Nop.Web/Areas/Admin/Controllers/ProductReviewController.cs`)
- Cart and checkout → Orders: checkout orders (evidence: `src/Presentation/Nop.Web/Controllers/CustomerController.cs`)
- Cart and checkout → Payment plugins: payment integration (evidence: `src/Presentation/Nop.Web/Controllers/CheckoutController.cs`)
- Cart and checkout → Shipping plugins: shipping options (evidence: `src/Presentation/Nop.Web/Controllers/CheckoutController.cs`)
- Cart and checkout → Tax plugins: tax calculation (evidence: `src/Presentation/Nop.Web/Controllers/CheckoutController.cs`)
- Orders → Domain models: uses order models (evidence: `src/Libraries/Nop.Services/Orders/IOrderService.cs`)
- Product catalog → Domain models: uses catalog models (evidence: `src/Libraries/Nop.Services/Catalog/IProductService.cs`)
- Storefront → Content and widgets: presents store content
- Web framework → Dependency engine: resolves services (evidence: `src/Presentation/Nop.Web.Framework/Controllers/BaseController.cs`)
- Plugin framework → External services: integrates services (evidence: `README.md`)
- Plugin framework → Payment plugins: registers providers
- Plugin framework → Shipping plugins: registers providers
- Plugin framework → Tax plugins: registers providers
- Shopper → Web API plugin: API integration (evidence: `README.md`)
- Web API plugin → External services: serves REST clients (evidence: `README.md`)
- Dependency engine → Cache services: configures services
- Dependency engine → Data access: configures services
- Web framework → Localization: uses localization (evidence: `src/Presentation/Nop.Web.Framework/Controllers/BaseController.cs`)
- Admin catalog → Permissions: checks permissions
