VerticalSliceArchitecture

项目介绍：Vertical Slice Architecture 在 .NET 8 中的应用

项目背景

Vertical Slice Architecture 项目是一种尝试，它旨在创建一个使用垂直切片架构风格的 API 解决方案模板。垂直切片架构强调按功能模块而非技术类别组织代码，这意味着相关业务功能的代码被放置在一起。这种架构风格可以作为一个应用程序的起点，当应用程序变得更复杂时，还可以进一步演化。

垂直切片架构的理念是从简单开始，然后根据业务逻辑中出现的代码臭味来重构出适合的模式。在这种方式下，开发者可以从全局的水平层结构转向专注于功能的垂直切割，以便更轻松地管理和修改代码。

技术栈与模式

该项目是基于 Jason Taylor 的 Clean Architecture 解决方案模板建立的，并采用了其中的技术选择和应用业务逻辑。具体的技术和工具包括：

• ASP.NET API (.NET 8)
• CQRS 模式与 MediatR
• FluentValidation
• Entity Framework Core 8
• 测试框架和工具包括 xUnit、FluentAssertions 和 Moq

在项目的后期，结构被调整为更符合垂直切片架构风格。

项目的目的

大多数应用程序都是从简单开始，然后逐渐演变和复杂化。因此，本项目旨在创建一个更简单的 API 解决方案模板，专注于垂直切片架构风格。

项目的目标是停止从水平层的视角思考，而是转向垂直切片，按特性组织代码。这样做的好处是与功能相关的代码会被放置得更接近，从而减少项目间、文件夹间、文件间的跳转。

项目结构

这个解决方案模板被分成两个项目：

Api

ASP.NET Web API 项目是应用的入口点，但没有控制器，所有的控制器动作都被移到 Application 项目的特性中。

Application

该项目包含了所有应用程序逻辑和共享关注点，如领域实体、基础设施及其他通用关注点。所有的业务逻辑都被放在 Feature 文件夹中，而不是为控制器、命令/查询、验证器、处理程序、模型分别创建文件。

如何开始

1. 安装最新的 [.NET 8 SDK]
2. 导航到 src/Api 并运行 dotnet run 来启动后端（ASP.NET Core Web API）

本地测试与设置

要在本地运行 API，可以使用 VS Code 进行调试（按 F5）或其他 IDE (如 Visual Studio, Rider)。默认情况下，项目使用内存数据库，若需使用 SQL Server，需要更新 Api/appsettings.json 对应的配置。

数据库配置

默认情况下，项目配置使用内存数据库，因此你可以不依赖额外的基础设施直接运行项目。如需使用 SQL Server，请确保 appsettings.json 中的 DefaultConnection 指向有效的 SQL Server 实例。关于 Azure SQL Edge 和 SQL Server 的配置和迁移，也在项目中进行了详细说明。

代码分析与格式化

开发者应遵循微软的 C# 编码规范。本项目使用 .editorconfig 文件来强制统一的编码风格。代码分析和格式化可以通过 CLI 命令执行，确保代码整洁和一致。

受到的启发

• Clean Architecture solution template by Jason Taylor
• Vertical slice architecture by Jimmy Bogard
• Organize code by Feature using Vertical Slices by Derek Comartin

许可证

该项目依据 MIT 许可证授权。