docs: include dto comments in openapi schemas

Tiku.Api/Contracts/TenantDtos.cs

@@ -6,17 +6,34 @@ using Tiku.Domain.Tenancy;
 
 namespace Tiku.Api.Contracts;
 
+/// <summary>
+/// 租户解析查询参数。
+/// </summary>
 public sealed class TenantResolveQueryDto
 {
+    /// <summary>
+    /// 要解析的访问域名，例如 student.example.com。本地开发也可以直接传 localhost。
+    /// </summary>
     [StringLength(253)]
     [Description("要解析的访问域名，例如 student.example.com。本地开发也可以直接传 localhost。")]
     public string? Host { get; set; }
 
+    /// <summary>
+    /// 租户编码；本地开发或无独立域名时使用，例如 master。
+    /// </summary>
     [StringLength(100)]
     [Description("租户编码；本地开发或无独立域名时使用，例如 master。")]
     public string? TenantCode { get; set; }
 }
 
+/// <summary>
+/// 租户解析响应。
+/// </summary>
+/// <param name="Tenant">公开租户基础信息。</param>
+/// <param name="Branding">公开品牌配置。</param>
+/// <param name="Features">面向前端公开的功能开关。</param>
+/// <param name="AdminFeatures">面向管理端公开的功能开关。</param>
+/// <param name="PublicConfig">可公开的租户配置，不包含密钥或内部配置。</param>
 public sealed record TenantResolveResponseDto(
     PublicTenantDto Tenant,
     PublicTenantBrandingDto Branding,
@@ -24,6 +41,15 @@ public sealed record TenantResolveResponseDto(
     JsonElement AdminFeatures,
     JsonElement PublicConfig);
 
+/// <summary>
+/// 可公开给客户端的租户基础信息。
+/// </summary>
+/// <param name="Id">租户 ID。</param>
+/// <param name="Slug">租户编码。</param>
+/// <param name="Name">租户名称。</param>
+/// <param name="Status">租户状态。</param>
+/// <param name="Mode">租户模式。</param>
+/// <param name="Host">当前匹配到的访问域名。</param>
 public sealed record PublicTenantDto(
     Guid Id,
     string Slug,
@@ -32,6 +58,18 @@ public sealed record PublicTenantDto(
     TenantMode Mode,
     string? Host);
 
+/// <summary>
+/// 可公开给客户端的租户品牌信息。
+/// </summary>
+/// <param name="BrandName">品牌名称。</param>
+/// <param name="ShortName">品牌短名称。</param>
+/// <param name="Slogan">品牌标语。</param>
+/// <param name="LogoUrl">Logo 地址。</param>
+/// <param name="FaviconUrl">Favicon 地址。</param>
+/// <param name="ServiceWechat">客服微信。</param>
+/// <param name="ServiceAccountName">公众号或服务号名称。</param>
+/// <param name="Theme">公开主题配置。</param>
+/// <param name="PublicAssets">公开资源配置。</param>
 public sealed record PublicTenantBrandingDto(
     string? BrandName,
     string? ShortName,