feat(saas): implement marketplace and tenant onboarding

Tiku.Api/Contracts/PointDtos.cs

@@ -3,14 +3,26 @@ using Tiku.Application.Points;
 
 namespace Tiku.Api.Contracts;
 
+/// <summary>
+/// 积分查询参数。
+/// </summary>
 public sealed class PointQueryDto
 {
+    /// <summary>
+    /// 返回数量上限。
+    /// </summary>
     [Range(1, 200)]
     public int? Limit { get; set; }
 
+    /// <summary>
+    /// 状态。
+    /// </summary>
     [StringLength(32)]
     public string? Status { get; set; }
 
+    /// <summary>
+    /// 地区 ID。
+    /// </summary>
     public Guid? RegionId { get; set; }
 
     public PointLimitQuery ToQuery()
@@ -19,15 +31,27 @@ public sealed class PointQueryDto
     }
 }
 
+/// <summary>
+/// 领取积分任务请求 DTO。
+/// </summary>
 public sealed class ClaimPointTaskDto
 {
+    /// <summary>
+    /// 任务键。
+    /// </summary>
     [Required]
     [StringLength(100)]
     public string TaskKey { get; set; } = string.Empty;
 
+    /// <summary>
+    /// 来源类型。
+    /// </summary>
     [StringLength(100)]
     public string? SourceType { get; set; }
 
+    /// <summary>
+    /// 来源 ID。
+    /// </summary>
     public Guid? SourceId { get; set; }
 
     public ClaimPointTaskCommand ToCommand()
@@ -36,8 +60,14 @@ public sealed class ClaimPointTaskDto
     }
 }
 
+/// <summary>
+/// 创建积分兑换订单请求 DTO。
+/// </summary>
 public sealed class CreatePointExchangeOrderDto
 {
+    /// <summary>
+    /// 兑换项 ID。
+    /// </summary>
     [Required]
     public Guid ItemId { get; set; }