Codebase analysis · CoreStory V3

nopCommerce

An open-source e-commerce platform written in C# on ASP.NET Core. It covers catalog, pricing, discounts, shopping cart, checkout, orders, returns and customer accounts. Maintained by nopCommerce.

Maintained by
nopCommerce (Nop Solutions)
License
nopCommerce Public License v3
Commit analyzed
aeb686282007ed774b362e3cdff34b7c233f8933
Rules extracted
2026-11-15
Extracted by CoreStory V3
21858
accepted rules, each with a cited source quote
26
capabilities
4566
features
01 · Rules

Business rules, traced to source lines.

These 12 rules are a sample of the 21,858 CoreStory V3 extracted from nopCommerce. Each one links to the exact lines on GitHub at commit aeb6862. The statement is CoreStory V3’s wording; the code excerpt is the source it cites.

eligibility
src/Libraries/Nop.Services/Catalog/PriceCalculationService.cs

A price list is applicable only when it is active for customer roles and customer IDs (retrieved with isActive true), its StartDateUtc is null or not after the current UTC time, and its EndDateUtc is null or not before the current UTC time; otherwise it is skipped.

  • true — isActive filter passed to GetAllPriceListsAsync
var isApplicable = (priceList.StartDateUtc == null || priceList.StartDateUtc <= now) && (priceList.EndDateUtc == null || priceList.EndDateUtc >= now); if (!isApplicable) continue;

Also cited: L86

calculation
src/Libraries/Nop.Services/Orders/OrderProcessingService.cs

AwardRewardPointsAsync returns without awarding when points calculate to 0, and also returns when the order already has a RewardPointsHistoryEntryId; when points are awarded, if ActivationDelay is greater than zero an activating date is computed via the delay period and hours, and if PurchasesPointsValidity is greater than zero an end date is computed by adding that many days to the activating (or current) date.

  • 0 — points amount at which no award occurs
var points = totalForRewardPoints > decimal.Zero ? await _orderTotalCalculationService.CalculateRewardPointsAsync(customer, totalForRewardPoints) : 0; if (points == 0) return; //Ensure that reward points were not added (earned) before. We should not add reward points if they were already earned for this order if (order.RewardPointsHistoryEntryId.HasValue) return;

Also cited: L885–L895

calculation
src/Libraries/Nop.Services/Orders/ReturnRequestService.cs

For an order item, the available quantity for return is the order item Quantity minus the sum of quantities already requested for return when such requests exist, floored at 0; when no return requests exist for the order item, the available quantity is the full order item Quantity.

  • 0 — minimum available quantity for return
AvailableQuantityForReturn = aroi != null ? Math.Max(oi.Quantity - aroi.RequestedQuantityForReturn, 0) : oi.Quantity,

Also cited: L140

limit
src/Libraries/Nop.Services/Customers/CustomerRegistrationService.cs

When UnduplicatedPasswordsNumber is greater than 0, change password rejects a NewPassword matching any of the previous passwords returned with passwordsToReturn equal to UnduplicatedPasswordsNumber, with error `Account.ChangePassword.Errors.PasswordMatchesWithPrevious`.

  • 0 — threshold above which previous password duplication check runs
  • Account.ChangePassword.Errors.PasswordMatchesWithPrevious — error resource when new password matches a previous password
if (_customerSettings.UnduplicatedPasswordsNumber > 0) { //get some of previous passwords var previousPasswords = await _customerService.GetCustomerPasswordsAsync(customer.Id, passwordsToReturn: _customerSettings.UnduplicatedPasswordsNumber); var newPasswordMatchesWithPrevious = previousPasswords.Any(password => PasswordsMatch(password, request.NewPassword)); if (newPasswordMatchesWithPrevious) { result.AddError(await _localizationService.GetResourceAsync("Account.ChangePassword.Errors.PasswordMatchesWithPrevious")); return result; } }
limit
src/Libraries/Nop.Services/Discounts/DiscountService.cs

For DiscountLimitationType.NTimesPerCustomer, when the customer is registered, the discount is invalid if the total count of discount usage history records for the discount and customer (page index 0, page size 1) is greater than or equal to discount.LimitationTimes; the error resource key is ShoppingCart.Discount.CannotBeUsedAnymore.

  • NTimesPerCustomer — discount limitation type that activates this check
  • 0 — page index passed to GetAllDiscountUsageHistoryAsync
  • 1 — page size passed to GetAllDiscountUsageHistoryAsync
  • ShoppingCart.Discount.CannotBeUsedAnymore — localization resource key used as the error
case DiscountLimitationType.NTimesPerCustomer: { if (await _customerService.IsRegisteredAsync(customer)) { var usedTimes = (await GetAllDiscountUsageHistoryAsync(discount.Id, customer.Id, null, false, 0, 1)).TotalCount; if (usedTimes >= discount.LimitationTimes) { result.Errors = new List<string> { await _localizationService.GetResourceAsync("ShoppingCart.Discount.CannotBeUsedAnymore") }; return result; } } }
policy
src/Libraries/Nop.Services/Orders/OrderProcessingService.cs

Refund from admin panel is not allowed when the order total equals zero or when RefundedAmount is greater than zero; refund is allowed only when payment status is Paid and the payment method supports refund.

  • 0 — order total that disallows refund
if (order.OrderTotal == decimal.Zero) return false; //refund cannot be made if previously a partial refund has been already done. only other partial refund can be made in this case if (order.RefundedAmount > decimal.Zero) return false;

Also cited: L2630–L2632

calculation
src/Libraries/Nop.Services/Orders/OrderProcessingService.cs

On a successful partial refund, the total refunded amount is order.RefundedAmount plus amountToRefund; if the order total equals the total refunded amount and the new payment status from the payment method is PartiallyRefunded, the payment status is upgraded to Refunded; otherwise the payment status is the payment method's new status.

  • PartiallyRefunded — payment method status triggering promotion
  • Refunded — resulting payment status when fully refunded
//total amount refunded var totalAmountRefunded = order.RefundedAmount + amountToRefund; //update order info order.RefundedAmount = totalAmountRefunded; //mark payment status as 'Refunded' if the order total amount is fully refunded order.PaymentStatus = order.OrderTotal == totalAmountRefunded && result.NewPaymentStatus == PaymentStatus.PartiallyRefunded ? PaymentStatus.Refunded : result.NewPaymentStatus;
calculation
src/Libraries/Nop.Services/Orders/OrderTotalCalculationService.cs

Calculating reward points returns 0 if reward points are disabled, if the points for purchases amount is zero or less, or if the customer is null or a guest; otherwise points equal the integer part of amount divided by the points for purchases amount, multiplied by the points for purchases.

  • 0 — returned point count and threshold for purchases amount
if (!_rewardPointsSettings.Enabled) return 0; if (_rewardPointsSettings.PointsForPurchases_Amount <= decimal.Zero) return 0; //ensure that reward points are applied only to registered users if (customer == null || await _customerService.IsGuestAsync(customer)) return 0; var points = (int)Math.Truncate(amount / _rewardPointsSettings.PointsForPurchases_Amount) * _rewardPointsSettings.PointsForPurchases_Points;
calculation
src/Libraries/Nop.Services/Orders/ShoppingCartService.cs

The quantity of a required product to add equals the required product's required quantity multiplied by the number of occurrences, minus the quantity already in the cart for that required product; if the resulting quantity is zero or less, the required product is skipped.

var quantityToAdd = requiredProductRequiredQuantity * requiredProduct.Count - (cart.FirstOrDefault(item => item.ProductId == requiredProduct.Product.Id)?.Quantity ?? 0); if (quantityToAdd <= 0) continue;
calculation
src/Libraries/Nop.Services/Catalog/PriceCalculationService.cs

When the catalog PriceListStrategy is MinimalPrice, the price for each applicable price list is its ManualPrice when present, otherwise the adjustment price computed from the base price and price list, and the minimum of those prices is returned; if there are none, null is returned.

case PriceListStrategy.MinimalPrice: { //calculate prices for all applicable price lists and get minimum var priceListPrices = new List<decimal>(); foreach (var priceList in applicablePriceLists) { var price = priceList.Value ?? _priceListService.ApplyAdjustmentPrice(basePrice, priceList.Key); priceListPrices.Add(price); } return priceListPrices.Any() ? priceListPrices.Min() : null; }
policy
src/Libraries/Nop.Services/Catalog/ProductReviewService.cs

Only orders with status OrderStatus.Complete count as completed for the purpose of determining whether a customer has purchased a product; the search is limited to one result.

  • 1 — page size limit for the completed-order search
return (await _orderService.SearchOrdersAsync(customerId: customer.Id, productId: product.Id, osIds: [(int)OrderStatus.Complete], pageSize: 1)).Any();
calculation
src/Libraries/Nop.Services/Catalog/PriceCalculationService.cs

For a Simple attribute value with PriceAdjustmentUsePercentage true, the adjustment is the product price multiplied by PriceAdjustment divided by 100; if no productPrice is supplied, the final price for the product, customer, store, and quantity is used.

  • 100 — divisor converting the percentage value
if (value.PriceAdjustmentUsePercentage) { if (!productPrice.HasValue) productPrice = (await GetFinalPriceAsync(product, customer, store, quantity: quantity)).finalPrice; adjustment = (decimal)((float)productPrice * (float)value.PriceAdjustment / 100f); }
02 · Capabilities

What the application does

26 capabilities identified, grouping 196 of the 4,399 distinct features extracted. Most extracted features are not grouped under a capability, so this list is a partial view of the application. These are descriptions, not the cited rules above.

Catalog and Merchandising

Managing, browsing, filtering, and merchandising the product catalog across categories, manufacturers, vendors, tags, attributes, and specifications.

  • Catalog Filtering: Enables narrowing catalog results by manufacturer, specification, and price range filters.
  • Category Management: Create and maintain hierarchical product categories with descriptive metadata, visibility, and scheduling settings.
  • Manufacturer Management: Create, read, update, and delete manufacturers through the manufacturer service.
  • Product Attribute Management: Create, read, update, and delete product attributes and their predefined values that define configurable product options.
  • Product Catalog Browsing: Users can browse products by category, manufacturer, vendor, tag, filter level values, new products, and view product combinations and details.
  • Product Catalog Management: Create and maintain product listings with names, descriptions, SKUs, media, and publication/store/ACL visibility.
  • Product Categorization: Associates products with categories so users can browse or filter products by category.
  • Product Categorization and Tagging: Organizes products into categories and tags for browsing and search.
  • Product Search: Users can search products with autocomplete, history autocomplete, and filtered searches by filter-level values.
  • Product Search & Filtering: Allows users to search and filter products by name, category, manufacturer, product type, store, and vendor.
  • Product Specification Attributes: Defines and displays product specification attributes organized into groups with selectable options and color swatches for a product sample.
  • Product Tag Management: Create, update, and delete product tags through the product tag service.

Order Management and Fulfillment

Order lifecycle management including status, notes, shipments, tracking, cancellation, refunds, and returns.

  • Order Cancellation: Allows a user to cancel an order.
  • Order Details Display: Present a complete order view including customer info, addresses, items, totals, tax breakdown, payment and shipping status, and associated discounts and gift cards.
  • Order Management: Create and manage customer orders with their totals, status, delivery details, and custom order numbering.
  • Order Management and Details: Customers can view order details, reorder, retry payment, cancel orders, print orders and download PDF invoices.
  • Order Note Management: Allows notes to be attached to an order and selectively displayed to the customer.
  • Order Refund: Emit a refund event representing a refunded order and its amount.
  • Order Status Tracking: A capability that represents and exposes the lifecycle states of an order to users or other systems.
  • Return Request Management: Create, retrieve, update, delete, and search return requests.
  • Shipment Management: Creation and handling of shipments, with a shipment-created event published for downstream consumers.
  • Shipment Tracking: Exposes shipment status and tracking information, including tracking number and key lifecycle dates, for an order shipment.

Payments

Payment method configuration and processing of authorizations, captures, refunds, voids, tokens, and vaulted instruments.

  • Card Payment Method Management: Capturing, storing, and representing a customer's card payment details, including card number, brand/type, expiry, security code, billing address, and network token references.
  • PayPal Commerce Payment Processing: Enables merchants to offer PayPal, Pay Later, Apple Pay, and Google Pay payments through PayPal Commerce, including order confirmation, token approval, and refund handling.
  • Payment Authorization: Represents and manages an authorization transaction for a payment, capturing its amount, status, payee, and processor response.
  • Payment Capture: Capability to capture a payment against an order via a payment capture request.
  • Payment Method Management: Administrators can view, restrict, and update the payment methods configured for a store.
  • Payment Processing: Authorize, capture, and refund payments for orders, tracking payment status and transaction references.
  • Payment Refund: Issue full or partial refunds for completed payments.
  • Payment Token Management: Provides a payment token model with expiration, title, type, and primary-method attributes that users rely on to store and manage payment tokens.
  • Payment Token and Saved Card Management: Capability to create setup tokens and list, save, or delete payment tokens and saved cards.
  • Payment Void: Void or cancel an authorized payment before it settles.

Access Control and Permissions

Permission checks, ACL records, customer roles, and authorization of users, admins, and store-scoped resources.

  • Access Control: Manages per-entity access control records and permission checks through a permission list, ACLs, and caching of ACL/permission lookups.
  • Access Control List Management: Lets users read, insert, update, and delete ACL records that map entities to customer roles for permission control.
  • Admin Access Control: Enforces that admin operations are performed by sufficiently privileged users.
  • Admin Authorization: Enforces that only users with administrative privileges can access protected operations, exposing an admin-only authorization requirement to callers.
  • Authorization Enforcement: Checks whether the current user is permitted to perform an operation on a given entity.
  • Customer Role Management: Define and manage customer roles, including system roles and password lifetime policies, that determine what customers can access.
  • Customer Role Permission Assignment: Assign and revoke permissions for customer roles by managing their permission mappings.
  • Permission Management: Create, update, and delete permission records and their mappings so administrators can configure access control.
  • Request Authorization Enforcement: Applies authorization checks to incoming requests, allowing controllers or actions to require that the caller is permitted before the request proceeds.

Checkout and Order Placement

Customers complete checkout with addresses, shipping and payment methods, applying coupons and gift cards, and place orders.

  • Billing and Shipping Address Management: Selection, entry, and editing of billing and shipping addresses during checkout, including pickup-in-store options.
  • Checkout: Configurable checkout flow including anonymous checkout, one-page checkout, billing address step, terms of service, and order placement locking.
  • Checkout Model Preparation: Prepares the view models that constitute the checkout experience, covering addresses, shipping, payment, pickup points, order confirmation, and the one-page checkout flow.
  • Coupon and Gift Card Application: Capability for customers to apply discount coupons and gift card codes during shopping or checkout.
  • Guest Checkout: Customers can complete purchases without creating an account.
  • One Page Checkout: Provides the single-page (OPC) checkout with billing, shipping, payment and confirm sections.
  • Order Placement: Creation and recording of customer orders, with an event emitted when an order is placed.
  • Payment Method Selection: Allows a user to choose and confirm a payment method type during a checkout or payment flow.
  • Shipping Method Selection: Customers select shipping methods at checkout, with sorting options and ability to bypass the step when only one method is available.

Customer Accounts and Authentication

Customer registration, login and logout, profile and address management, password recovery, and multi-factor authentication.

  • Address Book Management: Lets customers add, edit, and delete their saved shipping/billing addresses.
  • Customer Account Registration and Roles: Capability to register customers and assign them to roles such as registered, guests, administrators, and vendors.
  • Customer Login: Authenticates a customer and returns an outcome such as success, wrong password, not registered, not active, locked out, or MFA required.
  • Customer Profile Management: Maintenance of personal and contact profile data including phone, date of birth, gender, and admin notes.
  • Customer Registration: Registers a new customer account in the system and signals the registration event to interested parties.
  • Customer Sign Out: Terminates the authenticated customer session and clears authentication state.
  • External Authentication: Authenticate users via external identity providers and persist the resulting external authentication record.
  • Multi-Factor Authentication: Requires an additional authentication challenge during login when multi-factor authentication is needed.
  • Password Recovery: Allows customers to reset a forgotten password via a time-limited recovery link.

Notifications and Messaging

Email, SMS, and in-app notification delivery across account, order, shipment, and marketing lifecycles, plus private messaging.

  • Abandoned Cart Recovery: Detects and surfaces abandoned shopping carts for follow-up actions.
  • Email Sending: Send emails via SMTP, including support for MIME attachments and asynchronous delivery.
  • Message Template Management: Full CRUD lifecycle for message templates, allowing users to create, retrieve, list, update, and delete templates.
  • Newsletter Subscription: Enables newsletter signup and unsubscribe behaviour shown to store visitors.
  • Newsletter Subscription Management: Users can subscribe to and unsubscribe from a newsletter, with the system exposing the current set of subscriptions.
  • Notification Display: Displays user-facing notifications of varying severities such as success, warning, and error messages.
  • Order Lifecycle Notifications: Transactional notifications about order placement, payment, processing, completion, cancellation, and refunds delivered to customers, store owners, and vendors.
  • Private Messaging: Users can send, view, and reply to private messages through inbox and sent folders.
  • SMS Sending: Sends SMS messages through a pluggable SMS provider abstraction.

Plugins and Extensibility

Discovery, installation, configuration, and lifecycle management of plugins, themes, and widget zones that extend the system.

  • Plugin Discovery and Loading: Discovers and loads all plugins or individual plugins by system name or as the primary plugin.
  • Plugin Installation: Install plugins on a host application, optionally provisioning their sample data.
  • Plugin Installation and Uninstallation: Enables users to install and uninstall the Cloudflare Images plugin within the application.
  • Plugin Management: Tracks which plugins are disabled so the system can enable or disable plugin-provided capabilities.
  • Plugin Uninstallation: Remove installed plugins, including preparation steps before removal.
  • Theme Retrieval: Enables clients to query and fetch available themes and theme descriptors, including lookup by system name.
  • Widget Display: Renders configurable widgets by resolving a view component name and its arguments, with associated display configuration such as ordering, name, and logo.
  • Widget Rendering: Renders a widget's view component and resolves the zones in which the widget can be displayed.
  • Widget Zone Management: Defines and exposes named widget zones and their identifiers, including a configured active zone selection, so consumers can render widgets into designated areas.

Pricing and Discounts

Product pricing, tier prices, currency conversion, and the creation, application, and validation of discounts and coupons.

  • Coupon Code Application: Apply, remove, and parse discount and gift card coupon codes on orders.
  • Currency Conversion: Convert monetary amounts between currencies, including store and exchange-rate primary currencies.
  • Discount Application: Determines which discounts apply to a product, category, or manufacturer and computes the resulting discount amount.
  • Discount Management: Creation and configuration of discounts with percentage or fixed amounts, coupon codes, and usage limitations.
  • Price Calculation: Determines product, shipping, checkout attribute, and payment method prices and fees.
  • Price List Management: Create, update, delete, and retrieve price lists as first-class entities.
  • Product Price Calculation: Computes the final price of a product including cost, price list price, and price rounding for customers.
  • Product Price Display: Renders product pricing with extension points above and below.
  • Tier Pricing: Manage tier price levels and resolve preferred tier price for products.

Shipping and Delivery

Shipping method and rate configuration, cost estimation, warehouse and pickup handling, and delivery options.

  • Fixed Rate Shipping: Offers a shipping rate calculation method that returns a fixed shipping rate.
  • In-Store Pickup: Allows customers to choose pickup in store as a delivery option, with pickup point selection and map display.
  • Pickup Point Management: Provides a pickup point entity with its address, geographic coordinates, opening hours, and pickup fee metadata.
  • Shipping Cost Calculation: Determines shipping totals and discounts, including fixed shipping rates and tax handling, and whether shipping is free.
  • Shipping Cost Estimation: Customers can estimate shipping costs on product and cart pages, with configurable city name input and origin address.
  • Shipping Estimation: Lets users estimate shipping costs from product pages, cart, and a popup.
  • Shipping Method Management: Allows administrators to define and manage shipping methods with a name and display ordering for use in checkout and order fulfillment.
  • Shipping Rate Calculation: Computes available fixed shipping rates so users can see shipping costs for an order.
  • Warehouse Management: Create, read, update, and delete warehouse records along with listing all warehouses.

System Maintenance and Administration

Database backup and restore, maintenance operations, logging, cache clearing, system info, and application restart.

  • Application Logging: Writing log entries at multiple severity levels (error, warning, information) to the logging store.
  • Application Restart: Allows the running application domain to be restarted on demand.
  • Cache Management: Provides users with the ability to clear cached data or remove cached entries by key prefix.
  • Database Backup and Restore: Capability to back up and restore the database.
  • Database Maintenance: Capability to perform maintenance operations such as shrinking the database and reindexing tables.
  • Database Maintenance Operations: Supports database maintenance operations such as shrinking and reindexing tables.
  • Maintenance Housekeeping: Administrator can purge stale system data such as abandoned carts, queued emails, obsolete guests, and temporary files.
  • System Info Display: Exposes a diagnostic model of the running application's environment, including version, server time and time zone, operating system, memory usage, loaded assemblies, host, and debug/build state.
  • System Information Display: Shows administrators runtime system metrics such as used memory.

Analytics and Tracking

Tracking conversion and ecommerce events for analytics platforms such as Google Analytics, Facebook Pixel, and Omnisend.

  • Analytics Configuration and Endpoint Exposure: Provides the analytics system defaults, system name, endpoint URLs, and a configuration route for connecting to the analytics service.
  • Conversion Event Tracking: Captures and reports user conversion events (such as purchases or custom actions) with associated user data, timing, store, and source information for analytics attribution.
  • Ecommerce Conversion Event Tracking: Tracks standard ecommerce user actions such as add-to-cart, checkout, purchase, and other conversion events for advertising analytics.
  • Ecommerce Event Tracking: Send standard ecommerce events such as page views, purchases, add-to-cart, checkout, search, and view-content to Facebook.
  • Event Tracking: Captures and submits analytics or telemetry events described by a name, method, path, and properties.
  • Facebook Pixel Tracking: Renders a Facebook Pixel view component that uses the Facebook Pixel service to emit tracking events to Facebook.
  • Google Analytics Configuration: Allows administrators to configure Google Analytics tracking credentials and options such as Google ID, API secret, ecommerce tracking, sandbox mode, and customer ID inclusion.
  • Omnisend E-commerce Data Sync: Synchronizes store entities such as contacts, orders, carts, products, categories, and customer events with Omnisend via API endpoints.

Cache and Performance Optimization

Caching layers, cache invalidation, asset bundling and minification, and performance-oriented request handling.

  • Asset Bundling and Processing: Processes and bundles asset sources while honoring exclusion from bundling.
  • Cache Invalidation: Allows callers to clear or selectively remove cached entries, including bulk removal by key prefix, from a synchronized memory cache.
  • Cache Management: Provides users with the ability to clear cached data or remove cached entries by key prefix.
  • Distributed Cache Access: Store and retrieve cached values through a distributed cache with configurable options.
  • Distributed Caching: Configurable caching backed by in-memory, Redis, synchronized Redis, or SQL Server storage as selected by a cache type option.
  • HTML Output Minification: Compresses and minifies the generated HTML delivered to visitors.
  • Response Compression: Compresses outgoing responses delivered to clients.
  • Static Cache Management: A caching capability allowing callers to store, retrieve, and invalidate cached values by key or key prefix.

Content Management (CMS)

Authoring and publishing of blog posts, news, topics, menus, polls, and their comments with localization and SEO.

  • Blog Commenting: Users can submit comments on blog posts with associated body text, approval state, and authorship/timestamp metadata.
  • Blog Post Management: Create, update, delete, and retrieve blog posts including availability checks and tag parsing.
  • Menu Management: Create, read, update, and delete menus.
  • News Commenting: Users can leave comments on news items, with controls for approval, captcha, per-store visibility, and notifications.
  • News Management: Administrators can create, edit, list, delete, and publish or approve news items.
  • Poll Management: Creating and managing polls with names and system keywords.
  • SEO Meta Tag Generation: Generates page meta title, keywords, and description tags for SEO via the artificial intelligence controller.
  • Topic Management: Creates and maintains content topics with titles, body content, SEO metadata, scheduling, publishing, password protection, and store/ACL restrictions.

Installation and Setup

Guided installation wizard that configures the database, administrator account, store information, and sample data.

  • Admin Account Creation: Captures and validates the administrator email and password credentials during installation.
  • Administrator Account Creation: Captures and validates the administrator's email and password during installation, including password confirmation.
  • Application Installation: Setup flow that captures administrator credentials and language/region preferences to install the application, optionally seeding sample data.
  • Database Setup Wizard: A guided installation flow that collects database connection and credential details to configure the application's database.
  • Directory and File Permissions Check: Verifies and guides configuration of directory and file permissions required by the installed application.
  • Installation Progress Tracking: Displays progress stages while setup performs permission checks, database creation, initialization, sample data insertion, and plugin preparation.
  • Sample Data Creation: Optionally creates sample data for the store during installation.
  • Store Information Setup: Captures the store's regional and identification details during installation.

Reporting and Dashboards

Business intelligence reports and admin dashboards covering sales, customers, inventory, and order statistics.

  • Admin Dashboard Reporting: Administrators can view store performance reports such as bestsellers by amount or quantity, latest orders, order averages, incomplete orders, and popular search terms.
  • Best Customers Report: Generates a report identifying the best customers based on order activity.
  • Best Sellers Report: Generates a report of best-selling products, including total amounts, for a store.
  • Low Stock Product Report: Surfaces products whose stock quantity has fallen to or below a reporting threshold, with identifying attribute details.
  • Order Average Report: Displays summarized average metrics of orders, including their status, to the user.
  • Popular Search Terms Report: Administrator can view a report of the most popular search terms.
  • Registered Customers Report: Produces a report line of registered customers for a given period.
  • Sales Summary Report: Provides a summarized sales report broken down by date and type with per-line financial metrics such as orders, totals, profit, shipping, and tax.

Tax and VAT

Tax calculation, tax categories and rates, exemption management, and VAT number validation.

  • Avalara Tax Configuration: Exposes plugin configuration defaults and settings for the Avalara tax integration.
  • Avalara Tax Configuration Management: Exposes an HTTP-facing controller that orchestrates Avalara tax settings using tax manager, plugin manager, localization, notification, and permission services.
  • Tax Calculation: Compute and record order taxes, tax rates, VAT numbers, and customer tax display preferences.
  • Tax Category Management: Maintains a catalog of tax categories, each identified by a name and an ordering value, used to classify products for tax purposes.
  • Tax Provider Management: View available tax providers and mark one as the primary provider.
  • Tax Rate Management: Administrators can list, add, update, and delete tax rates organized by country, state, and zip code through a dedicated controller.
  • Tax Settings Configuration: Administrators can view and edit the store's tax configuration, including display, calculation basis, and shipping/payment tax handling.
  • VAT Number Validation: Validates a VAT number and reports its status as valid, invalid, empty, or unknown.

Background Tasks and Scheduling

Definition, scheduling, and execution of recurring background tasks such as cleanup, synchronization, and notifications.

  • Abandoned Cart Cleanup: Deletes abandoned shopping carts, optionally only those without an active cart.
  • Automatic Order Cancellation: A background task that automatically cancels orders that meet cancellation criteria, using customer, order, product, cart, store, and setting services.
  • Background Task Execution with Heartbeat: Runs a task while periodically emitting heartbeat signals so its liveness can be observed.
  • Exchange Rate Update: A scheduled task that retrieves and updates currency exchange rates for the system.
  • Guest Customer Data Cleanup: Removes guest records, supporting scheduled or administrative deletion of stale guest accounts.
  • Schedule Task Management: Administrators manage scheduled tasks, including creating/updating task definitions and triggering a task to run on demand.
  • Scheduled Task Execution: Runs scheduled background tasks with a configurable execution timeout.

GDPR and Privacy Compliance

Consent management, personal data export and erasure, cookie law notices, and privacy policy acceptance.

  • Customer Data Erasure: Permanently deletes a customer's data to fulfill data-erasure requests.
  • Customer GDPR Info Export: Export customer GDPR information to XLSX format.
  • EU Cookie Law Consent: Capability for customers to accept the EU cookie law consent notice.
  • GDPR Consent Management: Allows a user to agree to or withdraw consent under GDPR.
  • GDPR Data Subject Requests: Administrators can export and delete customer personal data for GDPR compliance and review the related log.
  • GDPR Tools: Offers customers tools to manage their personal data under GDPR.
  • Privacy Policy Consent: Presents and records the customer's acceptance of the privacy policy through a popup or checkbox.

Localization and Globalization

Multi-language content, locale resources, currency and measurement units, time zones, and localized formatting.

  • Currency Formatting: Localized display of monetary amounts including currency symbol placement and spacing.
  • Currency Management: Create, update, delete, and retrieve currencies available to the store.
  • Language Management: Create, read, update, and delete language records through a service that exposes CRUD operations and language name lookups.
  • Localization Resource Management: Create, update, retrieve, and delete locale string resources for localized content.
  • Localized Property Management: Create, read, update, and delete localized property values for entities through the localized entity service.
  • Measure Management: Provides CRUD and listing capabilities for measures, along with retrieval of associated dimensions and weights.
  • Time Zone Management: Enables retrieval of available system time zones and resolution of the current or customer-specific time zone for a store.

Marketing and Campaigns

Email campaigns, marketing automation, external marketing platform integration, and affiliate tracking.

  • Affiliate Management: Create, read, update, and delete affiliate records.
  • Blog RSS Feed: Users subscribe to the blog via an RSS feed of posts.
  • Campaign Management: Creation and scheduling of newsletter campaigns with subject, body, target customer role, store, and send-timing attributes.
  • Campaign Sending: Send a campaign to customers by email via the email sender and queued email service.
  • Email Marketing Contact Sync: Synchronize customer and order data with the external email marketing provider using configured provider settings and an HTTP client.
  • Marketing Automation Integration: Configuration of marketing automation keys, API keys, and subscription type mappings for external marketing platforms.
  • Newsletter Subscription Management: Create, update, delete, and retrieve newsletter subscriptions by id, email, or guid through a dedicated service contract.

Media and Asset Management

Uploading, storing, processing, and serving of images, videos, thumbnails, and 3D media for products and content.

  • 3D Object Upload: Allows uploading 3D object models subject to a configurable size limit.
  • Azure Blob Storage Integration: A plugin that integrates Azure Blob Storage into the application, supporting installation, uninstallation, and configuration setup.
  • Image Processing and Thumbnails: Resizes and auto-orients images to produce display-ready and thumbnail variants for users.
  • Picture Upload and Storage: Allows users or systems to upload image files, store the binary in the database or file system, and register the resulting picture record.
  • Product Media Management: Manage product pictures, videos, and 3D objects attached to products, including adding, updating, retrieving, and deleting each media type.
  • Product Picture Management: Adding, updating, and deleting product pictures.
  • Thumbnail Management: Create, store, retrieve, and delete image thumbnails exposed via local paths and public URLs.

SEO and URL Management

SEO-friendly URLs, slugs, meta tags, structured data, sitemaps, and robots.txt for search engine visibility.

  • JSON-LD Structured Data Generation: Generates JSON-LD structured data for product pages, category pages, and breadcrumbs so search engines can render rich results.
  • Robots.txt Generation: Generates a robots.txt file from settings that control sitemap references and which paths or languages disallow crawlers.
  • SEO Settings: Configuration of search-engine-optimization behavior including canonical URLs, meta tags, page titles, microdata, and URL handling.
  • SEO-Friendly Slug Management: Creation, validation, and retrieval of SEO-friendly URL slugs for entities, including proper character normalization and uniqueness checks.
  • SEO-Friendly URL Generation: Generates and routes human-readable, SEO-friendly URLs for catalog entities and localized content.
  • Sitemap Generation: Configurable generation of XML sitemaps with selective inclusion of content types and page sizing.
  • URL Record Management: Create, read, update, and delete URL records that map entities to their slug-based web addresses.

Search and Discovery

Site-wide search, autocomplete, search history, full-text indexing, and popular search term tracking.

  • Autocomplete Search: Provides a search box with autocomplete suggestions, including result thumbnails and product imagery, as the user types.
  • Full-Text Search: Enables full-text keyword search over products with support detection and enable/disable management.
  • Popular Search Terms: Surfaces a list of popular search terms for users to discover and select trending queries.
  • Product Search and Autocomplete: Enables customers to search the product catalog with configurable autocomplete suggestions, minimum term length, search box categories, and result page behavior.
  • Search History: Retains and surfaces the user's previous search terms for reuse.
  • Search Index Rebuild: Administrator can re-index the tables used for search to refresh indexed content.
  • Search Term Management: Captures and stores customer search terms with associated store, customer, and lifecycle metadata.

Shopping Cart and Wishlist

Shoppers add, update, and manage products in a cart or wishlist and estimated totals and shipping before checkout.

  • Add Product to Cart: Builds the add-to-cart model enabling a customer to add a product to the shopping cart.
  • Cart Pricing and Totals: Calculates unit prices and subtotals for items in the shopping cart.
  • Continue Shopping Redirect: Remembers the last page a customer was browsing so a 'Continue Shopping' action returns them to that page.
  • Mini Shopping Cart Display: Renders a compact mini shopping cart showing cart items, totals, and related action buttons for quick cart access.
  • Shopping Cart Management: Users can add products to a cart, edit cart items, share carts across stores, and see a mini shopping cart with product images and quantities.
  • Shopping Cart Total Calculation: Computes the full set of cart totals (subtotal, shipping, tax, payment fees, and grand total) that are displayed to the user during checkout.
  • Wishlist Management: Customers can maintain a personalized wishlist of products with attributes, quantities, and store association.

Store Configuration and Settings

Administration of store-wide settings across all functional areas, multi-store scope, and store identity and branding.

  • Admin Settings Management: Administrators can view and edit the full catalog of store-wide configuration settings across all functional areas via prepared settings models.
  • Setting Management: Create, update, and delete settings, with support for inserting, saving, and overriding values per store.
  • Store Configuration Management: Management of per-store configuration settings including currency, language, country, product picture size, and overrides scoped to individual stores.
  • Store Information Configuration: Entry of store details including title, country, and newsletter subscription preferences during setup.
  • Store Management: Create, read, update, and delete store records through a store service backed by a store repository.
  • Store Scope Configuration: Administrators can switch the configuration scope between stores when managing settings.
  • Store Settings Management: Administrators can view, add, update, and delete application and store settings through the settings administration UI.
03 · Size

What was analyzed

  • C# · 3,661 files · 227,985 lines
  • JavaScript · 460 files · 88,006 lines
  • Razor · 975 files · 82,116 lines
  • JSON · 73 files · 68,074 lines
  • SQL · 31 files · 53,134 lines
  • XML · 60 files · 44,402 lines
  • CSS · 69 files · 25,831 lines
  • C# Generated · 4 files · 4,729 lines
  • SVG · 27 files · 3,221 lines
  • MSBuild script · 41 files · 2,487 lines
  • Text · 23 files · 2,163 lines
  • Other (7 languages) · 18 files · 1,144 lines

Whole repository: 6,746 files. cloc 2.06 counts 603,292 lines of code in 5,442 of them (803,983 lines with comments and blanks).

04 · Source

Where this came from

Extracted by CoreStory V3 (build 4470 with two small engine fixes) using DeepSeek-V4.1-Flash from the public repository at commit aeb6862 on 2026-11-15. Capability descriptions are from the same run.

Code excerpts are from the upstream repository and remain under its nopCommerce Public License v3 license. CoreStory is not affiliated with or endorsed by nopCommerce (Nop Solutions).

Want this for your own codebase?

Talk to us about mapping the business rules in your repositories.

Talk to an expert