chore: 优化代码注释

src/Infrastructure/TakeoutSaaS.Infrastructure/Identity/Options/AdminSeedOptions.cs

@@ -1,5 +1,3 @@
-using System;
-using System.Collections.Generic;
 using System.ComponentModel.DataAnnotations;
 
 namespace TakeoutSaaS.Infrastructure.Identity.Options;
@@ -9,22 +7,52 @@ namespace TakeoutSaaS.Infrastructure.Identity.Options;
 /// </summary>
 public sealed class AdminSeedOptions
 {
+    /// <summary>
+    /// 初始用户列表。
+    /// </summary>
     public List<SeedUserOptions> Users { get; set; } = new();
 }
 
+/// <summary>
+/// 种子用户配置：用于初始化管理后台账号。
+/// </summary>
 public sealed class SeedUserOptions
 {
+    /// <summary>
+    /// 登录账号。
+    /// </summary>
     [Required]
     public string Account { get; set; } = string.Empty;
 
+    /// <summary>
+    /// 登录密码（明文，将在初始化时进行哈希处理）。
+    /// </summary>
     [Required]
     public string Password { get; set; } = string.Empty;
 
+    /// <summary>
+    /// 展示名称。
+    /// </summary>
     [Required]
     public string DisplayName { get; set; } = string.Empty;
 
+    /// <summary>
+    /// 所属租户 ID。
+    /// </summary>
     public Guid TenantId { get; set; }
+
+    /// <summary>
+    /// 所属商户 ID（平台管理员为空）。
+    /// </summary>
     public Guid? MerchantId { get; set; }
+
+    /// <summary>
+    /// 角色集合。
+    /// </summary>
     public string[] Roles { get; set; } = Array.Empty<string>();
+
+    /// <summary>
+    /// 权限集合。
+    /// </summary>
     public string[] Permissions { get; set; } = Array.Empty<string>();
 }

src/Infrastructure/TakeoutSaaS.Infrastructure/Identity/Options/JwtOptions.cs

@@ -3,23 +3,38 @@ using System.ComponentModel.DataAnnotations;
 namespace TakeoutSaaS.Infrastructure.Identity.Options;
 
 /// <summary>
-/// JWT 配置。
+/// JWT 配置选项。
 /// </summary>
 public sealed class JwtOptions
 {
+    /// <summary>
+    /// 令牌颁发者（Issuer）。
+    /// </summary>
     [Required]
     public string Issuer { get; set; } = string.Empty;
 
+    /// <summary>
+    /// 令牌受众（Audience）。
+    /// </summary>
     [Required]
     public string Audience { get; set; } = string.Empty;
 
+    /// <summary>
+    /// JWT 签名密钥（至少 32 个字符）。
+    /// </summary>
     [Required]
     [MinLength(32)]
     public string Secret { get; set; } = string.Empty;
 
+    /// <summary>
+    /// 访问令牌过期时间（分钟），范围：5-1440。
+    /// </summary>
     [Range(5, 1440)]
     public int AccessTokenExpirationMinutes { get; set; } = 60;
 
+    /// <summary>
+    /// 刷新令牌过期时间（分钟），范围：60-20160（14天）。
+    /// </summary>
     [Range(60, 1440 * 14)]
     public int RefreshTokenExpirationMinutes { get; set; } = 60 * 24 * 7;
 }

src/Infrastructure/TakeoutSaaS.Infrastructure/Identity/Options/LoginRateLimitOptions.cs

@@ -3,13 +3,19 @@ using System.ComponentModel.DataAnnotations;
 namespace TakeoutSaaS.Infrastructure.Identity.Options;
 
 /// <summary>
-/// 登录限流配置。
+/// 登录限流配置选项。
 /// </summary>
 public sealed class LoginRateLimitOptions
 {
+    /// <summary>
+    /// 时间窗口（秒），范围：1-3600。
+    /// </summary>
     [Range(1, 3600)]
     public int WindowSeconds { get; set; } = 60;
 
+    /// <summary>
+    /// 时间窗口内允许的最大尝试次数，范围：1-100。
+    /// </summary>
     [Range(1, 100)]
     public int MaxAttempts { get; set; } = 5;
 }

src/Infrastructure/TakeoutSaaS.Infrastructure/Identity/Options/RefreshTokenStoreOptions.cs

@@ -1,9 +1,12 @@
 namespace TakeoutSaaS.Infrastructure.Identity.Options;
 
 /// <summary>
-/// 刷新令牌存储配置。
+/// 刷新令牌存储配置选项。
 /// </summary>
 public sealed class RefreshTokenStoreOptions
 {
+    /// <summary>
+    /// Redis 键前缀，用于存储刷新令牌。
+    /// </summary>
     public string Prefix { get; set; } = "identity:refresh:";
 }

src/Infrastructure/TakeoutSaaS.Infrastructure/Identity/Options/WeChatMiniOptions.cs

@@ -3,13 +3,19 @@ using System.ComponentModel.DataAnnotations;
 namespace TakeoutSaaS.Infrastructure.Identity.Options;
 
 /// <summary>
-/// 微信小程序配置。
+/// 微信小程序配置选项。
 /// </summary>
 public sealed class WeChatMiniOptions
 {
+    /// <summary>
+    /// 微信小程序 AppId。
+    /// </summary>
     [Required]
     public string AppId { get; set; } = string.Empty;
 
+    /// <summary>
+    /// 微信小程序 AppSecret。
+    /// </summary>
     [Required]
     public string Secret { get; set; } = string.Empty;
 }