chore: 优化代码注释

src/Api/TakeoutSaaS.MiniApi/Controllers/AuthController.cs

@@ -1,7 +1,4 @@
-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;
@@ -20,6 +17,10 @@ public sealed class AuthController : BaseApiController
 {
     private readonly IMiniAuthService _authService;
 
+    /// <summary>
+    /// 小程序登录认证
+    /// </summary>
+    /// <param name="authService"></param>
     public AuthController(IMiniAuthService authService)
     {
         _authService = authService;
@@ -31,10 +32,10 @@ public sealed class AuthController : BaseApiController
     [HttpPost("wechat/login")]
     [AllowAnonymous]
     [ProducesResponseType(typeof(ApiResponse<TokenResponse>), StatusCodes.Status200OK)]
-    public async Task<ActionResult<ApiResponse<TokenResponse>>> LoginWithWeChat([FromBody] WeChatLoginRequest request, CancellationToken cancellationToken)
+    public async Task<ApiResponse<TokenResponse>> LoginWithWeChat([FromBody] WeChatLoginRequest request, CancellationToken cancellationToken)
     {
         var response = await _authService.LoginWithWeChatAsync(request, cancellationToken);
-        return Ok(ApiResponse<TokenResponse>.Ok(response));
+        return ApiResponse<TokenResponse>.Ok(response);
     }
 
     /// <summary>
@@ -43,9 +44,9 @@ public sealed class AuthController : BaseApiController
     [HttpPost("refresh")]
     [AllowAnonymous]
     [ProducesResponseType(typeof(ApiResponse<TokenResponse>), StatusCodes.Status200OK)]
-    public async Task<ActionResult<ApiResponse<TokenResponse>>> RefreshToken([FromBody] RefreshTokenRequest request, CancellationToken cancellationToken)
+    public async Task<ApiResponse<TokenResponse>> RefreshToken([FromBody] RefreshTokenRequest request, CancellationToken cancellationToken)
     {
         var response = await _authService.RefreshTokenAsync(request, cancellationToken);
-        return Ok(ApiResponse<TokenResponse>.Ok(response));
+        return ApiResponse<TokenResponse>.Ok(response);
     }
 }

src/Api/TakeoutSaaS.MiniApi/Controllers/HealthController.cs

@@ -1,3 +1,4 @@
+using System;
 using Microsoft.AspNetCore.Authorization;
 using Microsoft.AspNetCore.Http;
 using Microsoft.AspNetCore.Mvc;
@@ -20,9 +21,9 @@ public class HealthController : BaseApiController
     /// <returns>健康状态</returns>
     [HttpGet]
     [ProducesResponseType(typeof(ApiResponse<object>), StatusCodes.Status200OK)]
-    public IActionResult Get()
+    public ApiResponse<object> Get()
     {
         var payload = new { status = "OK", service = "MiniApi", time = DateTime.UtcNow };
-        return Ok(ApiResponse<object>.Ok(payload));
+        return ApiResponse<object>.Ok(payload);
     }
 }

src/Api/TakeoutSaaS.MiniApi/Controllers/MeController.cs

@@ -37,15 +37,16 @@ public sealed class MeController : BaseApiController
     /// </summary>
     [HttpGet]
     [ProducesResponseType(typeof(ApiResponse<CurrentUserProfile>), StatusCodes.Status200OK)]
-    public async Task<ActionResult<ApiResponse<CurrentUserProfile>>> Get(CancellationToken cancellationToken)
+    [ProducesResponseType(typeof(ApiResponse<CurrentUserProfile>), StatusCodes.Status401Unauthorized)]
+    public async Task<ApiResponse<CurrentUserProfile>> Get(CancellationToken cancellationToken)
     {
         var userId = User.GetUserId();
         if (userId == Guid.Empty)
         {
-            return Unauthorized(ApiResponse<CurrentUserProfile>.Error(ErrorCodes.Unauthorized, "Token 缺少有效的用户标识"));
+            return ApiResponse<CurrentUserProfile>.Error(ErrorCodes.Unauthorized, "Token 缺少有效的用户标识");
         }
 
         var profile = await _authService.GetProfileAsync(userId, cancellationToken);
-        return Ok(ApiResponse<CurrentUserProfile>.Ok(profile));
+        return ApiResponse<CurrentUserProfile>.Ok(profile);
     }
 }

src/Api/TakeoutSaaS.MiniApi/Program.cs

@@ -1,13 +1,5 @@
-using System;
-using System.Linq;
-using Microsoft.AspNetCore.Builder;
 using Microsoft.AspNetCore.Cors.Infrastructure;
-using Microsoft.Extensions.Configuration;
-using Microsoft.Extensions.DependencyInjection;
-using Microsoft.Extensions.Hosting;
 using Serilog;
-using TakeoutSaaS.Application.Identity.Extensions;
-using TakeoutSaaS.Infrastructure.Identity.Extensions;
 using TakeoutSaaS.Module.Tenancy;
 using TakeoutSaaS.Shared.Abstractions.Tenancy;
 using TakeoutSaaS.Shared.Web.Extensions;
@@ -15,7 +7,7 @@ using TakeoutSaaS.Shared.Web.Swagger;
 
 var builder = WebApplication.CreateBuilder(args);
 
-builder.Host.UseSerilog((context, _, configuration) =>
+builder.Host.UseSerilog((_, _, configuration) =>
 {
     configuration
         .Enrich.FromLogContext()