Clean Architecture Manga 项目教程

1. 项目介绍

Clean Architecture Manga 是一个基于 .NET Core 的示例项目，旨在展示如何使用 Clean Architecture 原则构建模块化、可测试且与框架解耦的应用程序。该项目通过虚拟钱包解决方案（Manga）来演示如何将用例作为核心组织结构，并完全解耦于框架和技术细节。

项目的主要特点包括：

• 使用 .NET Core 和 React+Redux 构建。
• 用例作为中央组织结构。
• 完全可测试，与框架解耦。
• 支持 .NET 6、.NET 5 和 .NET Core 3.1 版本。

2. 项目快速启动

2.1 环境准备

确保你已经安装了以下工具：

• Docker
• .NET Core SDK
• Node.js

2.2 克隆项目

首先，克隆项目到本地：

git clone https://github.com/ivanpaulovich/clean-architecture-manga.git
cd clean-architecture-manga

2.3 启动项目

在项目根目录下，执行以下命令启动项目：

Windows

cd docker
./setup.ps1

MacOS

cd docker
./setup.sh

启动后，以下容器将在 Docker 中运行：

• NGINX: https://wallet.local:8081
• Wallet SPA: https://wallet.local:8081
• Accounts API: https://wallet.local:8081/accounts-api
• Identity Server: https://wallet.local:8081/identity-server

2.4 访问应用

打开浏览器，访问 https://wallet.local:8081，然后点击“Log In”。如果提示信任自签名证书，请选择信任。

3. 应用案例和最佳实践

3.1 应用案例

Clean Architecture Manga 项目通过虚拟钱包解决方案展示了如何设计模块化应用程序。用户可以注册账户，并通过存款、取款和转账操作来管理余额。

3.2 最佳实践

• 模块化设计: 项目通过将用例作为核心组织结构，实现了模块化设计，使得每个组件都可以独立开发和测试。
• 解耦框架: 通过 Clean Architecture 原则，项目与框架和技术细节解耦，使得应用程序更加灵活和可维护。
• 测试驱动开发 (TDD): 项目鼓励使用 TDD 方法，确保每个组件在开发过程中都经过充分测试。

4. 典型生态项目

4.1 相关项目

• .NET Core: 作为项目的基础框架，提供了跨平台和可扩展的开发环境。
• React+Redux: 用于构建前端应用，提供了状态管理和组件化的解决方案。
• Docker: 用于容器化部署，确保应用程序在不同环境中的一致性。

4.2 生态项目

• Entity Framework Core: 用于数据访问层，提供了对象关系映射（ORM）功能。
• Swagger: 用于 API 文档生成，方便开发者理解和使用 API。
• Microsoft Extensions: 提供了日志记录、配置管理等功能，增强了应用程序的可扩展性。

通过以上模块，你可以快速了解并启动 Clean Architecture Manga 项目，并掌握其核心概念和最佳实践。