History

Loretta 599f8a6787 Refactor docs: topic folders, navigation, protocol sync - Restructured documentation: added `docs/README.md` to each sub-project, moved LOGGING and SIGNALR docs into dedicated subfolders with their own `README.md`. - Updated all cross-references to use new topic folder paths and canonical AyCode.Core doc locations. - Updated `.csproj` files to auto-include all Markdown docs and project-level `README.md` files. - Removed obsolete single-file docs, replaced with structured content in topic folders. - Enforced AI Agent Protocol: session setup, output prefix, no-re-read, and mandatory `docs-check` skill after code changes. - Added domain-critical reminders and navigation guidance to relevant `README.md` files.		2026-04-25 07:24:39 +02:00
..
Interfaces	Add Mango.Nop.Data project to solution	2025-11-04 15:57:09 +01:00
Repositories	StockQuantityHistoryExt, StockQuantityHistoryDto; improvements, fixes;	2025-11-13 19:58:39 +01:00
docs	Refactor docs: topic folders, navigation, protocol sync	2026-04-25 07:24:39 +02:00
Mango.Nop.Data.csproj	Refactor docs: topic folders, navigation, protocol sync	2026-04-25 07:24:39 +02:00
README.md	Comprehensive documentation overhaul and expansion	2026-03-30 10:26:35 +02:00

README.md

Mango.Nop.Data

@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)" ] }

Data access layer with repository base classes and DB context abstractions. net9.0.

Documentation

Document	Topic
`REPOSITORIES.md`	MgDbTableBase, MgDtoDbTableBase — CRUD hooks, timestamps, delete rules, event bridging
`TRANSACTIONS.md`	MgDbContextBase — 4 transaction methods, lock strategy, callback contract

Folder Structure

Folder	Purpose
`Interfaces/`	Repository interfaces: `IMgDalBase`, `IMgDbContextBase`, `IMgDbTableBase`
`Repositories/`	Repository base implementations: `MgDalBase`, `MgDbContextBase`, `MgDbTableBase`, `MgDtoDbTableBase`

Inheritance Chains

Repository hierarchy

nopCommerce EntityRepository<TEntity> (Nop.Data)
  +-- MgDbTableBase<TEntity>
        +-- MgDtoDbTableBase<TDtoEntity, TMainEntity>

Context hierarchy

MgDbContextBase (abstract, implements IMgDbContextBase)
  +-- [Consumer DbContexts in plugins]

DAL hierarchy

MgDalBase<TDbContext> (implements IMgDalBase<TDbContext>)
  +-- [Consumer DALs in plugins]

Interfaces

Interface	Purpose
`IMgDbTableBase`	Marker interface for repository classes
`IMgDbContextBase`	Contract: `Logger`, `DataProvider`, `Orders`, `Products`, 4 transaction methods
`IMgDalBase`	`Name` property
`IMgDalBase<TDbContext>`	`Context`, `MutextLock` — typed access to DB context

Dependencies

Mango.Nop.Core (ProjectReference)
Nop.Core, Nop.Data (nopCommerce ProjectReferences)
Microsoft.AspNetCore.Mvc.NewtonsoftJson