docs: 完善AdminApi控制器注释和代码规范

src/Api/TakeoutSaaS.AdminApi/Controllers/ProductsController.cs

@@ -23,6 +23,7 @@ public sealed class ProductsController(IMediator mediator) : BaseApiController
     /// <summary>
     /// 创建商品。
     /// </summary>
+    /// <returns>创建的商品信息。</returns>
     [HttpPost]
     [PermissionAuthorize("product:create")]
     [ProducesResponseType(typeof(ApiResponse<ProductDto>), StatusCodes.Status200OK)]
@@ -38,6 +39,7 @@ public sealed class ProductsController(IMediator mediator) : BaseApiController
     /// <summary>
     /// 查询商品列表。
     /// </summary>
+    /// <returns>商品分页列表。</returns>
     [HttpGet]
     [PermissionAuthorize("product:read")]
     [ProducesResponseType(typeof(ApiResponse<PagedResult<ProductDto>>), StatusCodes.Status200OK)]
@@ -70,6 +72,7 @@ public sealed class ProductsController(IMediator mediator) : BaseApiController
     /// <summary>
     /// 获取商品详情。
     /// </summary>
+    /// <returns>商品详情。</returns>
     [HttpGet("{productId:long}")]
     [PermissionAuthorize("product:read")]
     [ProducesResponseType(typeof(ApiResponse<ProductDto>), StatusCodes.Status200OK)]
@@ -88,6 +91,7 @@ public sealed class ProductsController(IMediator mediator) : BaseApiController
     /// <summary>
     /// 更新商品。
     /// </summary>
+    /// <returns>更新后的商品信息。</returns>
     [HttpPut("{productId:long}")]
     [PermissionAuthorize("product:update")]
     [ProducesResponseType(typeof(ApiResponse<ProductDto>), StatusCodes.Status200OK)]
@@ -112,6 +116,7 @@ public sealed class ProductsController(IMediator mediator) : BaseApiController
     /// <summary>
     /// 删除商品。
     /// </summary>
+    /// <returns>删除结果。</returns>
     [HttpDelete("{productId:long}")]
     [PermissionAuthorize("product:delete")]
     [ProducesResponseType(typeof(ApiResponse<object>), StatusCodes.Status200OK)]