🚀 SSW净架构模板使用指南
本指南详细介绍了如何使用SSW净架构模板创建一个新的ASP.NET Core API项目。该模板提供了完整的基础设施和应用层结构，能帮助开发者快速上手项目开发。
🚀 快速开始
本指南将引导你使用SSW净架构模板创建一个新的ASP.NET Core API项目，助你快速开启项目开发之旅。
✨ 主要特性
- 提供完整的基础设施和应用层结构，加速开发进程。
- 支持快速添加查询和命令功能模块。
- 模板可自动发布到NuGet.org，便于版本管理和更新。
📦 安装指南
安装模板
- 安装SSW净架构模板：
dotnet new install HeroApi.Template
⚠️ 重要提示
模板只需安装一次，默认情况下会自动更新到最新版本。
- 创建新目录：
mkdir Northwind365
cd Northwind365
- 创建新解决方案：
dotnet new ssw-ca
⚠️ 重要提示
name参数是可选的，如果没有指定，默认使用目录名作为解决方案名称和项目命名空间。
💻 使用示例
添加功能模块
添加查询功能
cd src/Application/Features
mkdir {{FeatureName}}
cd {{FeatureName}}
dotnet new ssw-ca-query --name {{QueryName}} --entityName {{Entity}} --slnName {{SolutionName}}
添加命令功能
cd src/Application/Features
mkdir {{FeatureName}}
cd {{FeatureName}}
dotnet new ssw-ca-command --name {{CommandName}} --entityName {{Entity}} --slnName {{SolutionName}}
运行解决方案
-
切换目录到工具目录：
- Windows:
cd tools\AppHost\- Mac/Linux:
cd tools/AppHost/ -
运行项目：
dotnet run
⚠️ 重要提示
首次运行时，可能会花费几分钟时间下载Docker镜像、创建数据库并初始化数据。
- 打开浏览器访问： https://localhost:7255/scalar/v1
发布模板
发布流程
- 更新
CleanArchitecture.nuspec文件中的version属性。 - 合并代码提交。
- GitHub Actions会自动运行
package工作流并发布新版本到NuGet.org。 - 创建GitHub发行版以记录更新内容。
⚠️ 重要提示
我们采用CalVer版本号格式，如
YYYY.M.D（例如2024.2.12）。
📚 详细文档
学习资源
培训课程
如果你想深入了解SSW净架构，可以参加以下活动：
学习资料
推荐以下视频学习净架构知识：
此外，你还可以参考以下资源链接：
贡献与支持
如需贡献代码或提出问题，请访问我们的GitHub仓库。
📄 许可证
本项目遵循MIT License协议。