Mango.Nop.Libraries/Mango.Nop.Core

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/AyCode.Core/docs/LOGGING/README.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] attributes
• Microsoft.AspNetCore.Mvc.NewtonsoftJson — JSON serialization
• Binary serialization: AcBinarySerializer (see AyCode.Core/AyCode.Core/docs/BINARY/BINARY_FORMAT.md). SignalR transport: AcSignalR (see AyCode.Core/AyCode.Services/docs/SIGNALR/README.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.