Updated documentation to clarify .md file update scope and add rules for documentation layering. Replaced inline dependency graph in README.md with a reference to ARCHITECTURE.md. Corrected timestamp interface references from ITimeStampUpdated to ITimeStampModified for consistency. Clarified nopCommerce dependency boundaries. |
||
|---|---|---|
| .github | ||
| Mango.Nop.Core | ||
| Mango.Nop.Data | ||
| Mango.Nop.Services | ||
| docs | ||
| .gitignore | ||
| README.md | ||
README.md
Mango.Nop Libraries
For library domain rules see:
.github/copilot-instructions.mdFor 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.Coreonly) — for projects that only need DTOs, entities, and interfaces without the nopCommerce runtime dependency.