feat(saas): implement marketplace and tenant onboarding

Tiku.Api/Contracts/LearningDtos.cs

@@ -7,14 +7,26 @@ using Tiku.Domain.Content;
 
 namespace Tiku.Api.Contracts;
 
+/// <summary>
+/// 学习Limit查询参数。
+/// </summary>
 public sealed class LearningLimitQueryDto
 {
+    /// <summary>
+    /// 返回数量上限。
+    /// </summary>
     [Range(1, 500)]
     public int? Limit { get; set; }
 
+    /// <summary>
+    /// 状态。
+    /// </summary>
     [StringLength(50)]
     public string? Status { get; set; }
 
+    /// <summary>
+    /// 单元 ID。
+    /// </summary>
     public Guid? UnitId { get; set; }
 
     public LearningLimitFilter ToFilter()
@@ -23,18 +35,36 @@ public sealed class LearningLimitQueryDto
     }
 }
 
+/// <summary>
+/// 练习会话查询参数。
+/// </summary>
 public sealed class PracticeSessionQueryDto
 {
+    /// <summary>
+    /// 练习会话 ID。
+    /// </summary>
     public Guid? PracticeSessionId { get; set; }
 
+    /// <summary>
+    /// 练习蓝图 ID。
+    /// </summary>
     public Guid? BlueprintId { get; set; }
 
+    /// <summary>
+    /// 模式。
+    /// </summary>
     [StringLength(50)]
     public string? Mode { get; set; }
 
+    /// <summary>
+    /// 状态。
+    /// </summary>
     [StringLength(50)]
     public string? Status { get; set; }
 
+    /// <summary>
+    /// 返回数量上限。
+    /// </summary>
     [Range(1, 200)]
     public int? Limit { get; set; }
 
@@ -49,33 +79,69 @@ public sealed class PracticeSessionQueryDto
     }
 }
 
+/// <summary>
+/// 创建练习会话请求 DTO。
+/// </summary>
 public sealed class CreatePracticeSessionDto
 {
+    /// <summary>
+    /// 模式。
+    /// </summary>
     [StringLength(50)]
     public string? Mode { get; set; }
 
+    /// <summary>
+    /// 目标类型。
+    /// </summary>
     [StringLength(50)]
     public string? TargetType { get; set; }
 
+    /// <summary>
+    /// 目标 ID。
+    /// </summary>
     public Guid? TargetId { get; set; }
 
+    /// <summary>
+    /// 练习蓝图 ID。
+    /// </summary>
     public Guid? BlueprintId { get; set; }
 
+    /// <summary>
+    /// 题集 ID。
+    /// </summary>
     public Guid? CollectionId { get; set; }
 
+    /// <summary>
+    /// 内容入口 ID。
+    /// </summary>
     public Guid? EntryId { get; set; }
 
+    /// <summary>
+    /// 内容节点 ID。
+    /// </summary>
     public Guid? ContentNodeId { get; set; }
 
+    /// <summary>
+    /// 题目数量上限。
+    /// </summary>
     [Range(1, 500)]
     public int? QuestionLimit { get; set; }
 
+    /// <summary>
+    /// 时长，单位为分钟。
+    /// </summary>
     [Range(1, 1440)]
     public int? DurationMinutes { get; set; }
 
+    /// <summary>
+    /// 总分。
+    /// </summary>
     [Range(typeof(decimal), "0", "99999")]
     public decimal? TotalScore { get; set; }
 
+    /// <summary>
+    /// 扩展元数据。
+    /// </summary>
     public JsonElement Metadata { get; set; } = JsonDefaults.Object();
 
     public PracticeSessionCommand ToCommand()
@@ -95,8 +161,14 @@ public sealed class CreatePracticeSessionDto
     }
 }
 
+/// <summary>
+/// 提交练习会话请求 DTO。
+/// </summary>
 public sealed class SubmitPracticeSessionDto
 {
+    /// <summary>
+    /// 练习会话 ID。
+    /// </summary>
     [Required]
     public Guid PracticeSessionId { get; set; }
 
@@ -106,16 +178,31 @@ public sealed class SubmitPracticeSessionDto
     }
 }
 
+/// <summary>
+/// 提交答案请求 DTO。
+/// </summary>
 public sealed class SubmitAnswerDto
 {
+    /// <summary>
+    /// 会话题目 ID。
+    /// </summary>
     [Required]
     public Guid SessionQuestionId { get; set; }
 
+    /// <summary>
+    /// 已选选项。
+    /// </summary>
     public IReadOnlyCollection<string>? SelectedOptions { get; set; }
 
+    /// <summary>
+    /// 文字答案。
+    /// </summary>
     [StringLength(10000)]
     public string? AnswerText { get; set; }
 
+    /// <summary>
+    /// 主观题自评是否正确。
+    /// </summary>
     public bool? SelfJudgedCorrect { get; set; }
 
     public SubmitAnswerCommand ToCommand()
@@ -128,14 +215,26 @@ public sealed class SubmitAnswerDto
     }
 }
 
+/// <summary>
+/// 题目Action请求 DTO。
+/// </summary>
 public sealed class QuestionActionDto
 {
+    /// <summary>
+    /// 题目 ID。
+    /// </summary>
     [Required]
     public Guid QuestionId { get; set; }
 
+    /// <summary>
+    /// 来源。
+    /// </summary>
     [Required]
     public QuestionSource Source { get; set; } = QuestionSource.Tenant;
 
+    /// <summary>
+    /// 是否收藏。
+    /// </summary>
     public bool? Favorite { get; set; }
 
     public QuestionActionCommand ToCommand()
@@ -144,20 +243,38 @@ public sealed class QuestionActionDto
     }
 }
 
+/// <summary>
+/// 单词Progress请求 DTO。
+/// </summary>
 public sealed class WordProgressDto
 {
+    /// <summary>
+    /// 单词 ID。
+    /// </summary>
     [Required]
     public Guid WordId { get; set; }
 
+    /// <summary>
+    /// 状态。
+    /// </summary>
     [StringLength(50)]
     public string? Status { get; set; }
 
+    /// <summary>
+    /// 答对数量变化。
+    /// </summary>
     [Range(0, 100)]
     public int? CorrectDelta { get; set; }
 
+    /// <summary>
+    /// 答错数量变化。
+    /// </summary>
     [Range(0, 100)]
     public int? WrongDelta { get; set; }
 
+    /// <summary>
+    /// 下次复习时间。
+    /// </summary>
     public DateTimeOffset? NextReviewAt { get; set; }
 
     public WordProgressCommand ToCommand()
@@ -171,13 +288,25 @@ public sealed class WordProgressDto
     }
 }
 
+/// <summary>
+/// 收藏单词请求 DTO。
+/// </summary>
 public sealed class FavoriteWordDto
 {
+    /// <summary>
+    /// 单词 ID。
+    /// </summary>
     [Required]
     public Guid WordId { get; set; }
 
+    /// <summary>
+    /// 是否收藏。
+    /// </summary>
     public bool? Favorite { get; set; }
 
+    /// <summary>
+    /// 备注。
+    /// </summary>
     [StringLength(1000)]
     public string? Note { get; set; }
 
@@ -187,14 +316,26 @@ public sealed class FavoriteWordDto
     }
 }
 
+/// <summary>
+/// 单词Review请求 DTO。
+/// </summary>
 public sealed class WordReviewDto
 {
+    /// <summary>
+    /// 单词 ID。
+    /// </summary>
     [Required]
     public Guid WordId { get; set; }
 
+    /// <summary>
+    /// 结果。
+    /// </summary>
     [StringLength(50)]
     public string? Result { get; set; }
 
+    /// <summary>
+    /// 下次复习时间。
+    /// </summary>
     public DateTimeOffset? NextReviewAt { get; set; }
 
     public WordReviewCommand ToCommand()