Mango.Nop.Libraries/README.md

Mango.Nop Libraries

For library domain rules see: .github/copilot-instructions.md For detailed docs see: docs/

Shared nopCommerce extension libraries providing domain entities, DTOs, data access, and service base classes. All target net9.0 (nopCommerce 4.80.9 requirement).

Projects

Project	Purpose	Key Types
Mango.Nop.Core	Domain entities, DTOs, interfaces, nopCommerce entity mirrors	MgOrderDto, MgProductDto, MgEntityBase, GenericAttribute, BaseEntity
Mango.Nop.Data	Data access layer — repository base classes, DB context	MgDalBase, MgDbContextBase, MgDbTableBase, MgDtoDbTableBase
Mango.Nop.Services	Service base classes — background services, session, events, locking	MgBackgroundServiceBase, MgSessionServiceBase, MgEventConsumerBase, NopLogWriter

Dependency Graph

See docs/ARCHITECTURE.md for full dependency graph and project roles.

Mango.Nop.Core has zero nopCommerce runtime dependency (uses mirror copies in NopDependencies/). Mango.Nop.Data and .Services depend on nopCommerce.

Reference Modes

• Full stack (ProjectReference, all 3 libraries) — for nopCommerce plugins that need entity access, data layer, and services.
• Types only (DLL reference, Mango.Nop.Core only) — for projects that only need DTOs, entities, and interfaces without the nopCommerce runtime dependency.