Superhero Team Management

🚀 SSW淨架構模板使用指南

本指南詳細介紹瞭如何使用SSW淨架構模板創建一個新的ASP.NET Core API項目。該模板提供了完整的基礎設施和應用層結構，能幫助開發者快速上手項目開發。

🚀 快速開始

本指南將引導你使用SSW淨架構模板創建一個新的ASP.NET Core API項目，助你快速開啟項目開發之旅。

✨ 主要特性

• 提供完整的基礎設施和應用層結構，加速開發進程。
• 支持快速添加查詢和命令功能模塊。
• 模板可自動發佈到NuGet.org，便於版本管理和更新。

📦 安裝指南

安裝模板

1. 安裝SSW淨架構模板：

dotnet new install HeroApi.Template

⚠️ 重要提示

模板只需安裝一次，默認情況下會自動更新到最新版本。

2. 創建新目錄：

mkdir Northwind365
cd Northwind365

3. 創建新解決方案：

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}}

運行解決方案

1. 切換目錄到工具目錄：

   • Windows:

   cd tools\AppHost\
   

   • Mac/Linux:

   cd tools/AppHost/
   

2. 運行項目：

dotnet run

⚠️ 重要提示

首次運行時，可能會花費幾分鐘時間下載Docker鏡像、創建數據庫並初始化數據。

3. 打開瀏覽器訪問： https://localhost:7255/scalar/v1

發佈模板

發佈流程

1. 更新CleanArchitecture.nuspec文件中的version屬性。
2. 合併代碼提交。
3. GitHub Actions會自動運行package工作流併發布新版本到NuGet.org。
4. 創建GitHub發行版以記錄更新內容。

⚠️ 重要提示

我們採用CalVer版本號格式，如YYYY.M.D（例如2024.2.12）。

📚 詳細文檔

學習資源

培訓課程

如果你想深入瞭解SSW淨架構，可以參加以下活動：

• SSW 一日淨架構超級能力巡講
• SSW 兩日淨架構工作坊

學習資料

推薦以下視頻學習淨架構知識：

• Clean Architecture with ASP.NET Core and MAUI

此外，你還可以參考以下資源鏈接：

• .NET 開發文檔
• SSW官方文檔

貢獻與支持

如需貢獻代碼或提出問題，請訪問我們的GitHub倉庫。

📄 許可證

本項目遵循MIT License協議。