Day14: 搭建企业标准的DDD 简洁版四层架构

正式项目搭建：Admin.NET.API（项目名）

1. 项目说明

• 项目名称：Admin.NET.API
• 用途：企业级后台管理系统 API（求职最通用项目）
• 架构：DDD 四层架构（国内.NET 公司 90% 使用）
• 版本：.NET 6/7/8 均可

2. 项目结构（严格按照这个建）

Admin.NET.API（总解决方案）
├── Admin.NET.API              // 【API层】接口入口、控制器、中间件
├── Admin.NET.Application      // 【应用层】业务逻辑、服务、DTO
├── Admin.NET.Domain           // 【领域层】实体、枚举、接口、核心规则
├── Admin.NET.Infrastructure   // 【基础层】数据库、第三方服务、工具类

3. 手动创建步骤（直接照做）

3.1、通过命令行创建

1. 新建文件夹：Admin.NET.API

2. 打开 cmd / 终端，进入文件夹执行：

   1. 创建解决方案

   dotnet new sln -n Admin.NET.API

   2. 创建4个类库/API项目

   dotnet new webapi -n Admin.NET.API
   dotnet new classlib -n Admin.NET.Application
   dotnet new classlib -n Admin.NET.Domain
   dotnet new classlib -n Admin.NET.Infrastructure

   3. 所有项目添加到解决方案

   dotnet sln add Admin.NET.API/Admin.NET.API.csproj
   dotnet sln add Admin.NET.Application/Admin.NET.Application.csproj
   dotnet sln add Admin.NET.Domain/Admin.NET.Domain.csproj
   dotnet sln add Admin.NET.Infrastructure/Admin.NET.Infrastructure.csproj

   4. 项目依赖关系（核心！不能错）

   API层 依赖 应用层

   dotnet add Admin.NET.API reference Admin.NET.Application

   应用层 依赖 领域层

   dotnet add Admin.NET.Application reference Admin.NET.Domain

   基础层 依赖 领域层

   dotnet add Admin.NET.Infrastructure reference Admin.NET.Domain

   API层 依赖 基础层

   dotnet add Admin.NET.API reference Admin.NET.Infrastructure

3.2、纯 VS 图形化操作步骤

一、打开 Visual Studio 2022

选择：创建一个新项目

第一步：创建解决方案（空解决方案）

1. 搜索模板：空白解决方案
2. 项目名称：Admin.NET.API
3. 位置自己选（比如 D:\Projects\Admin.NET.API）
4. 点击 创建

现在你有了一个空的解决方案，接下来往里面添加 4 个项目

二、添加 4 个项目（严格按顺序）

1. 添加 API 层（Web API）

右键解决方案 → 添加 → 新建项目

• 模板：ASP.NET Core Web API
• 名称：Admin.NET.API
• 框架：.NET 6 / 7 / 8 任选
• 取消勾选 配置 HTTPS（学习阶段方便）
• 创建

2. 添加 Application 层（类库）

右键解决方案 → 添加 → 新建项目

• 模板：类库（C#）
• 名称：Admin.NET.Application
• 框架：和上面保持一致
• 创建

3. 添加 Domain 层

同上：

• 名称：Admin.NET.Domain

4. 添加 Infrastructure 层

同上：

• 名称：Admin.NET.Infrastructure

---

三、设置项目依赖（最关键！不能乱）

在 VS 里用鼠标操作：

依赖规则（必须严格）

• API 层 引用 → Application + Infrastructure
• Application 引用 → Domain
• Infrastructure 引用 → Domain
• Domain 不引用任何人

鼠标操作方法

1. 右键项目 → 项目依赖
2. 或右键 → 添加 → 项目引用
3. 勾选要依赖的项目 → 确定

最终依赖关系

Admin.NET.API
   ↓        ↓
Application Infrastructure
        ↓
      Domain

四、建好后你的解决方案结构长这样

Admin.NET.API (解决方案)
├─ Admin.NET.API          // WebAPI
├─ Admin.NET.Application   // 类库
├─ Admin.NET.Domain       // 类库
├─ Admin.NET.Infrastructure // 类库

4. 然后把之前的代码丢进去

• Domain → 放枚举、实体、仓储接口
  • Entities【文件夹】
  • Enums
  • Interfaces
• Application → 放服务、DTO(数据传输对象)、扩展方法
  • DTOs
  • Services
  • Extensions
• Infrastructure → 放过滤器、中间件、统一返回 R<T>（通用工具）
  • Filters
  • Commons
  • Middlewares
• API → 控制器、Program.cs
  • Controllers