feat(saas): implement marketplace and tenant onboarding

Tiku.Api/Contracts/ReferralDtos.cs

@@ -5,17 +5,32 @@ using Tiku.Application.Growth;
 
 namespace Tiku.Api.Contracts;
 
+/// <summary>
+/// 推荐租户查询参数。
+/// </summary>
 public sealed class ReferralTenantQueryDto
 {
+    /// <summary>
+    /// 租户编码。
+    /// </summary>
     [StringLength(100)]
     public string? TenantCode { get; set; }
 }
 
+/// <summary>
+/// 推荐邀请码请求 DTO。
+/// </summary>
 public sealed class ReferralInviteDto
 {
+    /// <summary>
+    /// 渠道。
+    /// </summary>
     [StringLength(100)]
     public string? Channel { get; set; }
 
+    /// <summary>
+    /// 落地页路径。
+    /// </summary>
     [StringLength(2048)]
     public string? LandingPath { get; set; }
 
@@ -25,11 +40,20 @@ public sealed class ReferralInviteDto
     }
 }
 
+/// <summary>
+/// 解析推荐请求 DTO。
+/// </summary>
 public sealed class ResolveReferralDto
 {
+    /// <summary>
+    /// 编码。
+    /// </summary>
     [StringLength(100)]
     public string? Code { get; set; }
 
+    /// <summary>
+    /// 租户编码。
+    /// </summary>
     [StringLength(100)]
     public string? TenantCode { get; set; }
 
@@ -39,22 +63,43 @@ public sealed class ResolveReferralDto
     }
 }
 
+/// <summary>
+/// 记录推荐事件请求 DTO。
+/// </summary>
 public sealed class TrackReferralEventDto
 {
+    /// <summary>
+    /// 推荐码。
+    /// </summary>
     [Required]
     [StringLength(100)]
     public string RefCode { get; set; } = string.Empty;
 
+    /// <summary>
+    /// 事件类型。
+    /// </summary>
     [StringLength(100)]
     public string? EventType { get; set; }
 
+    /// <summary>
+    /// 来源。
+    /// </summary>
     [StringLength(100)]
     public string? Source { get; set; }
 
+    /// <summary>
+    /// 目标用户 ID。
+    /// </summary>
     public Guid? TargetUserId { get; set; }
 
+    /// <summary>
+    /// 扩展元数据。
+    /// </summary>
     public JsonElement? Metadata { get; set; }
 
+    /// <summary>
+    /// 租户编码。
+    /// </summary>
     [StringLength(100)]
     public string? TenantCode { get; set; }
 
@@ -64,15 +109,27 @@ public sealed class TrackReferralEventDto
     }
 }
 
+/// <summary>
+/// 绑定推荐请求 DTO。
+/// </summary>
 public sealed class BindReferralDto
 {
+    /// <summary>
+    /// 推荐码。
+    /// </summary>
     [Required]
     [StringLength(100)]
     public string RefCode { get; set; } = string.Empty;
 
+    /// <summary>
+    /// 来源。
+    /// </summary>
     [StringLength(100)]
     public string? Source { get; set; }
 
+    /// <summary>
+    /// 扩展元数据。
+    /// </summary>
     public JsonElement? Metadata { get; set; }
 
     public BindReferralCommand ToCommand()
@@ -81,20 +138,38 @@ public sealed class BindReferralDto
     }
 }
 
+/// <summary>
+/// 推荐二维码请求 DTO。
+/// </summary>
 public sealed class ReferralQrcodeDto
 {
+    /// <summary>
+    /// 页码。
+    /// </summary>
     [StringLength(500)]
     public string? Page { get; set; }
 
+    /// <summary>
+    /// 场景参数。
+    /// </summary>
     [StringLength(128)]
     public string? Scene { get; set; }
 
+    /// <summary>
+    /// 服务提供方。
+    /// </summary>
     [StringLength(100)]
     public string? Provider { get; set; }
 
+    /// <summary>
+    /// 二维码地址。
+    /// </summary>
     [StringLength(2048)]
     public string? QrcodeUrl { get; set; }
 
+    /// <summary>
+    /// 扩展元数据。
+    /// </summary>
     public JsonElement? Metadata { get; set; }
 
     public ReferralQrcodeCommand ToCommand()
@@ -103,10 +178,19 @@ public sealed class ReferralQrcodeDto
     }
 }
 
+/// <summary>
+/// 推荐统计查询参数。
+/// </summary>
 public sealed class ReferralStatsQueryDto
 {
+    /// <summary>
+    /// 推荐人用户 ID。
+    /// </summary>
     public Guid? ReferrerUserId { get; set; }
 
+    /// <summary>
+    /// 返回数量上限。
+    /// </summary>
     [Range(1, 500)]
     public int? Limit { get; set; }
 
@@ -116,19 +200,37 @@ public sealed class ReferralStatsQueryDto
     }
 }
 
+/// <summary>
+/// 推荐Conversion查询参数。
+/// </summary>
 public sealed class ReferralConversionQueryDto
 {
+    /// <summary>
+    /// 推荐人用户 ID。
+    /// </summary>
     public Guid? ReferrerUserId { get; set; }
 
+    /// <summary>
+    /// 开始日期，格式为 yyyy-MM-dd。
+    /// </summary>
     [RegularExpression("^\\d{4}-\\d{2}-\\d{2}$")]
     public string? StartDate { get; set; }
 
+    /// <summary>
+    /// 结束日期，格式为 yyyy-MM-dd。
+    /// </summary>
     [RegularExpression("^\\d{4}-\\d{2}-\\d{2}$")]
     public string? EndDate { get; set; }
 
+    /// <summary>
+    /// 天数。
+    /// </summary>
     [Range(1, 365)]
     public int? Days { get; set; }
 
+    /// <summary>
+    /// 返回数量上限。
+    /// </summary>
     [Range(1, 100)]
     public int? Limit { get; set; }
 
@@ -150,19 +252,37 @@ public sealed class ReferralConversionQueryDto
     }
 }
 
+/// <summary>
+/// 人工绑定推荐请求 DTO。
+/// </summary>
 public sealed class ManualBindReferralDto
 {
+    /// <summary>
+    /// 学生用户 ID。
+    /// </summary>
     [Required]
     public Guid StudentUserId { get; set; }
 
+    /// <summary>
+    /// 推荐人用户 ID。
+    /// </summary>
     [Required]
     public Guid ReferrerUserId { get; set; }
 
+    /// <summary>
+    /// 来源。
+    /// </summary>
     [StringLength(100)]
     public string? Source { get; set; }
 
+    /// <summary>
+    /// 是否强制执行。
+    /// </summary>
     public bool Force { get; set; }
 
+    /// <summary>
+    /// 扩展元数据。
+    /// </summary>
     public JsonElement? Metadata { get; set; }
 
     public ManualBindReferralCommand ToCommand()
@@ -171,8 +291,14 @@ public sealed class ManualBindReferralDto
     }
 }
 
+/// <summary>
+/// 推荐团队查询参数。
+/// </summary>
 public sealed class ReferralTeamQueryDto
 {
+    /// <summary>
+    /// 上级成员用户 ID。
+    /// </summary>
     public Guid? LeaderUserId { get; set; }
 
     public ReferralTeamQuery ToQuery()
@@ -181,19 +307,37 @@ public sealed class ReferralTeamQueryDto
     }
 }
 
+/// <summary>
+/// 新增或更新推荐团队请求 DTO。
+/// </summary>
 public sealed class UpsertReferralTeamDto
 {
+    /// <summary>
+    /// 成员用户 ID。
+    /// </summary>
     [Required]
     public Guid MemberUserId { get; set; }
 
+    /// <summary>
+    /// 上级成员用户 ID。
+    /// </summary>
     public Guid? LeaderUserId { get; set; }
 
+    /// <summary>
+    /// 关系类型。
+    /// </summary>
     [StringLength(50)]
     public string? RelationType { get; set; }
 
+    /// <summary>
+    /// 状态。
+    /// </summary>
     [StringLength(50)]
     public string? Status { get; set; }
 
+    /// <summary>
+    /// 扩展元数据。
+    /// </summary>
     public JsonElement? Metadata { get; set; }
 
     public UpsertReferralTeamCommand ToCommand()