docs: include dto comments in openapi schemas

This commit is contained in:
xiong
2026-07-26 13:51:24 +08:00
parent 015c9b5582
commit 41a8a5ff81
10 changed files with 240 additions and 5 deletions

View File

@@ -53,6 +53,14 @@ public sealed class MeController(
}
}
/// <summary>
/// 当前用户基础信息和租户成员摘要。
/// </summary>
/// <param name="UserId">用户 ID。</param>
/// <param name="Phone">手机号。</param>
/// <param name="Email">邮箱。</param>
/// <param name="Name">用户显示名称。</param>
/// <param name="Tenants">当前用户拥有的活跃租户成员列表。</param>
public sealed record MeResponse(
Guid UserId,
string? Phone,
@@ -60,6 +68,14 @@ public sealed record MeResponse(
string? Name,
IReadOnlyCollection<TenantMembershipResponse> Tenants);
/// <summary>
/// 用户在某个租户内的成员摘要。
/// </summary>
/// <param name="TenantId">租户 ID。</param>
/// <param name="TenantName">租户名称。</param>
/// <param name="TenantSlug">租户编码。</param>
/// <param name="Role">当前用户在该租户内的角色。</param>
/// <param name="Status">租户成员状态。</param>
public sealed record TenantMembershipResponse(
Guid TenantId,
string TenantName,