Mango.Nop.Core
@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)"
]
}
Shared domain library containing entities, DTOs, interfaces, and nopCommerce entity mirrors. net9.0. Zero nopCommerce runtime dependency.
Documentation
| Document |
Topic |
DTOS.md |
DTO system — two mapping strategies, all DTO types, GenericAttribute typed access |
NOP_DEPENDENCIES.md |
NopDependencies pattern — mirror copies, namespace rules, file list |
Folder Structure
| Folder |
Purpose |
Dtos/ |
DTO classes shared across consumers |
Entities/ |
Custom domain entities |
Extensions/ |
Extension methods for BaseEntity collections and GenericAttribute |
Interfaces/ |
DTO interfaces, soft-delete, foreign key markers |
Loggers/ |
ILogger / Logger — logging abstraction wrapping AyCode logger |
Models/ |
Login request/response models |
NopDependencies/ |
Mirror copies of nopCommerce entity classes (same namespaces as originals) |
Services/ |
IMgLockService interface |
Utils/ |
CommonHelper2 — email validation, type conversion utilities |
Entity Hierarchy
Nop.Core.BaseEntity (NopDependencies/, implements IBaseEntity)
+-- MgEntityBase (Entities/, implements IEntityInt from AyCode)
+-- MgOrderDto<TOrderItemDto, TProductDto>
+-- MgOrderItemDto<TProductDto>
+-- MgProductDto
+-- MgStockQuantityHistoryDto<TProductDto>
+-- MgStockTaking<TStockTakingItem>
+-- MgStockTakingItem<TStockTaking, TProduct>
Key Types (not in docs/)
Entities
| Type |
Key features |
MgEntityBase |
Inherits BaseEntity, implements IEntityInt. ToString() -> "{TypeName}; Id: {Id}" |
MgStockTaking<TStockTakingItem> |
StartDateTime, IsClosed, List<TStockTakingItem> navigation. Implements ITimeStampInfo |
MgStockTakingItem<TStockTaking, TProduct> |
StockTakingId, ProductId, IsMeasured, stock quantities. Navigations to parent and product |
Extensions
| Method |
Purpose |
UpdateBaseEntityCollection |
Add/update/remove entities in a list by Id match |
Loggers
Extends AyCode logging infrastructure — for base types see AyCode.Core/docs/LOGGING.md.
| Type |
Inherits |
Purpose |
ILogger |
IAcLoggerBase |
Mango-level logger interface |
ILogger<TCategory> |
ILogger |
Generic category logger interface |
Logger |
AcLoggerBase |
Logger implementation with IAcLogWriterBase[] writers |
Logger<TCategory> |
Logger |
Typed logger — category name from typeof(TCategory).Name |
Models
| Type |
Purpose |
MgLoginModelRequest |
Email + Password for SignalR/API login |
MgLoginModelResponse |
CustomerDto? + ErrorMessage. Computed IsSuccesLogin |
Other
| Type |
Purpose |
NopCommonConst |
Abstract const class inheriting AcConst (placeholder) |
CommonHelper2 |
Email validation, IP validation, type conversion (To<T>), string utilities |
Dependencies
linq2db — data access, [Association] / [Table] attributesMicrosoft.AspNetCore.Mvc.NewtonsoftJson — JSON serialization- Binary serialization:
AcBinarySerializer (see AyCode.Core/docs/BINARY_FORMAT.md). SignalR transport: AcSignalR (see AyCode.Core/AyCode.Services/docs/SIGNALR.md).
AyCode.Core.Serializers.SourceGenerator (ProjectReference, OutputItemType="Analyzer") — compile-time binary serializer. See AyCode.Core/docs/BINARY_SOURCE_GEN.md- AyCode DLL references:
AyCode.Interfaces, AyCode.Core, AyCode.Utils, AyCode.Entities (types only, no runtime nopCommerce dependency)
AcBinary Source Generator (SGen)
9 types annotated with [AcBinarySerializable]. For general SGen docs see AyCode.Core/docs/BINARY_SOURCE_GEN.md.
Requires InternalsVisibleTo("Mango.Nop.Core") in AyCode.Core/Properties/AssemblyInfo.cs.
Excluded types
| Type |
Reason |
DiscountProductMapping |
Base DiscountMapping hides BaseEntity.Id with readonly new int Id { get; } → CS0200. Uses compiled-expression fallback. |
Loretta
3725b4c2fd