.NET Web API 起步项目下载与安装教程

1. 项目介绍

本项目是一个基于 .NET 8 的 Web API 起步项目，包含多租户支持以及清洁/模块化架构。它提供了开箱即用的多种必要功能和包，能够为您的团队节省大约200小时以上的开发时间。该项目目前处于开发阶段，但已经具备了许多实用的功能。

2. 项目下载位置

您可以在 GitHub 上找到该项目的源代码，项目地址为：https://github.com/fullstackhero/dotnet-webapi-starter-kit.git

3. 项目安装环境配置

在开始安装之前，请确保您的开发环境满足以下要求：

• 已安装 .NET 9 SDK
• Visual Studio IDE
• Docker Desktop
• PostgreSQL 数据库（可以是本地安装或 Docker 容器）

以下是环境配置的图片示例：

（此处应有图片，但由于环境限制，将以文字描述代替）

• Visual Studio 安装界面：打开 Visual Studio 安装程序，确保安装了 .NET 9 开发工具。
• Docker Desktop：确保 Docker Desktop 运行正常。
• PostgreSQL 数据库安装：如果本地未安装 PostgreSQL，可以通过 Docker 运行一个 PostgreSQL 容器。

# Visual Studio 安装界面
![Visual Studio 安装界面](image_path)

# Docker Desktop 运行中
![Docker Desktop 运行中](image_path)

# PostgreSQL 数据库配置
![PostgreSQL 数据库配置](image_path)

4. 项目安装方式

以下是项目的安装步骤：

1. 克隆项目到本地：

   git clone https://github.com/fullstackhero/dotnet-webapi-starter-kit.git
   

2. 打开 Visual Studio，加载项目中的 .sln 文件。

3. 设置数据库连接字符串。打开 /src/api/server/appsettings.Development.json 文件，并修改 DatabaseOptions 下的 ConnectionString。

4. 运行项目。在 Visual Studio 中以默认项目（Aspire Dashboard）启动，项目将自动打开浏览器窗口。

5. 项目处理脚本

在项目初始化或更新数据库结构时，您可能需要运行 Entity Framework Core 的迁移脚本。以下是一些常用的迁移命令：

# 添加迁移
dotnet ef migrations add "Add Identity Schema" --project /migrations/postgresql/ --context IdentityDbContext -o Identity
dotnet ef migrations add "Add Tenant Schema" --project /migrations/postgresql/ --context TenantDbContext -o Tenant
dotnet ef migrations add "Add Todo Schema" --project /migrations/postgresql/ --context TodoDbContext -o Todo
dotnet ef migrations add "Add Catalog Schema" --project /migrations/postgresql/ --context CatalogDbContext -o Catalog

# 更新数据库
dotnet ef database update

按照以上步骤，您应该能够成功下载并安装这个 .NET Web API 起步项目，开始您的新项目开发。