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

AyCode.Core (net9.0, DLL references: AyCode.Interfaces, AyCode.Entities, AyCode.Core, AyCode.Utils, + .Server variants)
    ↑
Mango.Nop.Core (net9.0, no nopCommerce dependency)
    ↑
Mango.Nop.Data (net9.0) → references Nop.Core, Nop.Data
    ↑
Mango.Nop.Services (net9.0) → references Nop.Core, Nop.Data, Nop.Services, Nop.Web.Framework

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.