Go to file

Loretta f47701af59 Add architecture docs for Mango.Nop & update dev DB config Added detailed documentation: ARCHITECTURE.md, CONVENTIONS.md, GLOSSARY.md, and copilot-instructions.md for Mango.Nop.Core, Data, and Services. Updated/added README.md files for all Mango.Nop libraries and the FruitBank nopCommerce plugin, clarifying structure, key types, and usage. Switched appsettings.json connection string from production to development database. These changes improve developer onboarding and enforce architectural consistency.		2026-03-29 10:44:03 +02:00
.github	Add architecture docs for Mango.Nop & update dev DB config	2026-03-29 10:44:03 +02:00
Mango.Nop.Core	Add architecture docs for Mango.Nop & update dev DB config	2026-03-29 10:44:03 +02:00
Mango.Nop.Data	Add architecture docs for Mango.Nop & update dev DB config	2026-03-29 10:44:03 +02:00
Mango.Nop.Services	Add architecture docs for Mango.Nop & update dev DB config	2026-03-29 10:44:03 +02:00
docs	Add architecture docs for Mango.Nop & update dev DB config	2026-03-29 10:44:03 +02:00
.gitignore	merge	2024-11-11 13:50:52 +01:00
README.md	Add architecture docs for Mango.Nop & update dev DB config	2026-03-29 10:44:03 +02:00

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.