- Added detailed .md docs for Core, Data, and Services projects: DTOs, NopDependencies, repositories, transactions, services, and logging bridge - Updated all project README.md files with metadata, documentation tables, inheritance diagrams, and clearer dependency/reference explanations - Root README.md now includes a documentation map and improved project/type tables - Expanded and clarified `.github/copilot-instructions.md` as the single source of truth for domain rules, patterns, and conventions - Updated ARCHITECTURE.md, CONVENTIONS.md, and GLOSSARY.md to document DTO strategies, transaction and logging patterns, project boundaries, and AyCode integration - Added CLAUDE.md for Claude-specific code authoring guidance - All .csproj files now include new docs as non-compilable content - Ensured clear separation of concerns and improved AI/tooling discoverability across the codebase |
||
|---|---|---|
| .. | ||
| Loggers | ||
| docs | ||
| IMgBackgroundService.cs | ||
| IMgSessionItem.cs | ||
| IMgSessionService.cs | ||
| Mango.Nop.Services.csproj | ||
| MgBackgroundServiceBase.cs | ||
| MgEventConsumerBase.cs | ||
| MgLockServiceBase.cs | ||
| MgSessionItemBase.cs | ||
| MgSessionServiceBase.cs | ||
| README.md | ||
README.md
Mango.Nop.Services
@project { type = "framework" own-dep-projects = [ "AyCode.Core, AyCode.Core.Server, AyCode.Entities, AyCode.Entities.Server, AyCode.Interfaces, AyCode.Interfaces.Server, AyCode.Utils (in AyCode.Core repo)" ] }
Service base classes for nopCommerce plugin development — background tasks, session management, events, locking, logging. net9.0.
Documentation
| Document | Topic |
|---|---|
SERVICES.md |
MgBackgroundServiceBase, MgSessionServiceBase, MgEventConsumerBase, MgLockServiceBase |
LOGGING_BRIDGE.md |
NopLogWriter — AyCode-to-nopCommerce log bridge, TransactionScope(Suppress) |
Folder Structure
| Folder | Purpose |
|---|---|
Loggers/ |
NopLogWriter, NopLoggerMsSqlNopDataProvider — AyCode -> nopCommerce log bridge |
| (root) | MgBackgroundServiceBase, MgSessionServiceBase, MgEventConsumerBase, MgLockServiceBase, interfaces |
Dependencies
Mango.Nop.Core,Mango.Nop.Data(ProjectReferences)Nop.Core,Nop.Data,Nop.Services,Nop.Web.Framework(nopCommerce ProjectReferences)