chore: add documentation comments and stylecop rules

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

@@ -13,21 +13,16 @@ using TakeoutSaaS.Shared.Web.Api;
 using TakeoutSaaS.Shared.Web.Security;
 
 namespace TakeoutSaaS.AdminApi.Controllers;
-
 /// <summary>
 /// 管理后台认证接口
 /// </summary>
-/// <remarks>
-/// 
-/// </remarks>
-/// <param name="authService"></param>
+/// <remarks>提供登录、刷新 Token 以及用户权限查询能力。</remarks>
+/// <param name="authService">认证服务</param>
 [ApiVersion("1.0")]
 [Authorize]
 [Route("api/admin/v{version:apiVersion}/auth")]
 public sealed class AuthController(IAdminAuthService authService) : BaseApiController
 {
-
-
     /// <summary>
     /// 登录获取 Token
     /// </summary>
@@ -84,12 +79,14 @@ public sealed class AuthController(IAdminAuthService authService) : BaseApiContr
     [ProducesResponseType(typeof(ApiResponse<CurrentUserProfile>), StatusCodes.Status401Unauthorized)]
     public async Task<ApiResponse<CurrentUserProfile>> GetProfile(CancellationToken cancellationToken)
     {
+        // 1. 从 JWT 中获取当前用户标识
         var userId = User.GetUserId();
         if (userId == 0)
         {
             return ApiResponse<CurrentUserProfile>.Error(ErrorCodes.Unauthorized, "Token 缺少有效的用户标识");
         }
 
+        // 2. 读取用户档案并返回
         var profile = await authService.GetProfileAsync(userId, cancellationToken);
         return ApiResponse<CurrentUserProfile>.Ok(profile);
     }