How leyen1403/shopchain works
Project type and purpose
• This is a layered ASP.NET Core 8.0 Web API called “ShopChain” for managing store, province, district, ward and user-client data.
• It applies CQRS (Commands/Queries) inside an Application layer, Domain entities and interfaces in Core, EF Core in Infrastructure, and exposes REST endpoints via the Api project.
File structure
• Top-level projects:
• ShopChain.Api – Web API controllers, HTTP launch settings, Swagger, Program.cs
• ShopChain.Application – Commands, Queries, DTOs, mapping profiles, DI setup
• ShopChain.Core – Domain entities, interfaces, common base classes, DI setup
• ShopChain.Infrastructure – EF Core DbContext, Migrations, Repositories, external VnAddress API integration
• ShopChain.UnitTest – MSTest unit tests for domain logic
README for additional insights
• Dependencies: .NET 8 SDK, SQL Server
• Run command: dotnet run –project ShopChain.Api
• Swagger is enabled in dev mode
• Vietnamese guides in docs/CauTrucDuAn.md and docs/HuongDanNguoiMoi.md
Elements
• From Client → API → Application → Core Interfaces → Infrastructure → Database
• From Application → Infrastructure → External VnAddress API → back to Application
• Blue for API layer
• Green for Application
• Yellow for Core
• Orange for Infrastructure
• Gray for Database & External services
• Rectangles for modules/projects