diff --git a/.editorconfig b/.editorconfig
index 32193b8..6c8b717 100644
--- a/.editorconfig
+++ b/.editorconfig
@@ -4,3 +4,10 @@ root = true
[*.cs]
dotnet_diagnostic.SA1600.severity = error
dotnet_diagnostic.SA1601.severity = error
+dotnet_diagnostic.SA1615.severity = error
+dotnet_diagnostic.SA1629.severity = none
+dotnet_diagnostic.SA1202.severity = none
+dotnet_diagnostic.SA1200.severity = none
+dotnet_diagnostic.SA1623.severity = none
+dotnet_diagnostic.SA1111.severity = none
+dotnet_diagnostic.SA1101.severity = none
diff --git a/Directory.Build.props b/Directory.Build.props
index f83743e..6f0ab73 100644
--- a/Directory.Build.props
+++ b/Directory.Build.props
@@ -9,5 +9,8 @@
+
+
+
diff --git a/src/Api/TakeoutSaaS.AdminApi/Controllers/AuthController.cs b/src/Api/TakeoutSaaS.AdminApi/Controllers/AuthController.cs
index b38d018..32b4e5a 100644
--- a/src/Api/TakeoutSaaS.AdminApi/Controllers/AuthController.cs
+++ b/src/Api/TakeoutSaaS.AdminApi/Controllers/AuthController.cs
@@ -1,8 +1,4 @@
-using System;
-using System.Threading;
-using System.Threading.Tasks;
using Microsoft.AspNetCore.Authorization;
-using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Mvc;
using TakeoutSaaS.Application.Identity.Abstractions;
using TakeoutSaaS.Application.Identity.Contracts;
@@ -26,6 +22,9 @@ public sealed class AuthController(IAdminAuthService authService) : BaseApiContr
///
/// 登录获取 Token
///
+ /// 登录请求。
+ /// 取消标记。
+ /// 包含访问令牌与刷新令牌的响应。
[HttpPost("login")]
[AllowAnonymous]
[ProducesResponseType(typeof(ApiResponse), StatusCodes.Status200OK)]
@@ -38,6 +37,9 @@ public sealed class AuthController(IAdminAuthService authService) : BaseApiContr
///
/// 刷新 Token
///
+ /// 刷新令牌请求。
+ /// 取消标记。
+ /// 新的访问令牌与刷新令牌。
[HttpPost("refresh")]
[AllowAnonymous]
[ProducesResponseType(typeof(ApiResponse), StatusCodes.Status200OK)]
@@ -73,6 +75,8 @@ public sealed class AuthController(IAdminAuthService authService) : BaseApiContr
/// }
///
///
+ /// 取消标记。
+ /// 当前用户档案信息。
[HttpGet("profile")]
[PermissionAuthorize("identity:profile:read")]
[ProducesResponseType(typeof(ApiResponse), StatusCodes.Status200OK)]
@@ -116,6 +120,9 @@ public sealed class AuthController(IAdminAuthService authService) : BaseApiContr
/// }
///
///
+ /// 目标用户 ID。
+ /// 取消标记。
+ /// 用户权限概览,未找到则返回 404。
[HttpGet("permissions/{userId:long}")]
[PermissionAuthorize("identity:permission:read")]
[ProducesResponseType(typeof(ApiResponse), StatusCodes.Status200OK)]
diff --git a/src/Api/TakeoutSaaS.AdminApi/Controllers/DeliveriesController.cs b/src/Api/TakeoutSaaS.AdminApi/Controllers/DeliveriesController.cs
index ae7c092..6f0f953 100644
--- a/src/Api/TakeoutSaaS.AdminApi/Controllers/DeliveriesController.cs
+++ b/src/Api/TakeoutSaaS.AdminApi/Controllers/DeliveriesController.cs
@@ -1,6 +1,5 @@
using MediatR;
using Microsoft.AspNetCore.Authorization;
-using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Mvc;
using TakeoutSaaS.Application.App.Deliveries.Commands;
using TakeoutSaaS.Application.App.Deliveries.Dto;
@@ -24,6 +23,9 @@ public sealed class DeliveriesController(IMediator mediator) : BaseApiController
///
/// 创建配送单。
///
+ /// 创建命令。
+ /// 取消标记。
+ /// 创建后的配送单。
[HttpPost]
[PermissionAuthorize("delivery:create")]
[ProducesResponseType(typeof(ApiResponse), StatusCodes.Status200OK)]
@@ -39,6 +41,14 @@ public sealed class DeliveriesController(IMediator mediator) : BaseApiController
///
/// 查询配送单列表。
///
+ /// 订单 ID。
+ /// 配送状态。
+ /// 页码。
+ /// 每页大小。
+ /// 排序字段。
+ /// 是否倒序。
+ /// 取消标记。
+ /// 配送单分页列表。
[HttpGet]
[PermissionAuthorize("delivery:read")]
[ProducesResponseType(typeof(ApiResponse>), StatusCodes.Status200OK)]
@@ -69,6 +79,9 @@ public sealed class DeliveriesController(IMediator mediator) : BaseApiController
///
/// 获取配送单详情。
///
+ /// 配送单 ID。
+ /// 取消标记。
+ /// 配送单详情或未找到。
[HttpGet("{deliveryOrderId:long}")]
[PermissionAuthorize("delivery:read")]
[ProducesResponseType(typeof(ApiResponse), StatusCodes.Status200OK)]
@@ -87,6 +100,10 @@ public sealed class DeliveriesController(IMediator mediator) : BaseApiController
///
/// 更新配送单。
///
+ /// 配送单 ID。
+ /// 更新命令。
+ /// 取消标记。
+ /// 更新后的配送单或未找到。
[HttpPut("{deliveryOrderId:long}")]
[PermissionAuthorize("delivery:update")]
[ProducesResponseType(typeof(ApiResponse), StatusCodes.Status200OK)]
@@ -111,6 +128,9 @@ public sealed class DeliveriesController(IMediator mediator) : BaseApiController
///
/// 删除配送单。
///
+ /// 配送单 ID。
+ /// 取消标记。
+ /// 删除结果,未找到则返回错误。
[HttpDelete("{deliveryOrderId:long}")]
[PermissionAuthorize("delivery:delete")]
[ProducesResponseType(typeof(ApiResponse