补充注释

SimpleAdmin.Application/Entity/Onboarding/ObTaskContract.cs

@@ -10,22 +10,80 @@
 
 namespace SimpleAdmin.Application;
 
+/// <summary>
+/// 入职任务合同实例，锁定模板版本并记录生成、阅读和签署状态。
+/// </summary>
 [SugarTable("ob_task_contract", TableDescription = "入职任务合同明细")]
 [Tenant(SqlSugarConst.DB_DEFAULT)]
 public class ObTaskContract : BaseEntity
 {
+    /// <summary>
+    /// 所属入职任务 Id。
+    /// </summary>
     public long TaskId { get; set; }
+
+    /// <summary>
+    /// 合同模板主档案 Id。
+    /// </summary>
     public long TemplateId { get; set; }
+
+    /// <summary>
+    /// 合同模板版本 Id。
+    /// </summary>
     public long TemplateVersionId { get; set; }
+
+    /// <summary>
+    /// 任务创建时冻结的合同名称。
+    /// </summary>
     public string ContractName { get; set; }
+
+    /// <summary>
+    /// 合同类型。
+    /// </summary>
     public string ContractType { get; set; }
+
+    /// <summary>
+    /// 是否为候选人必须阅读确认的合同。
+    /// </summary>
     public bool Required { get; set; }
+
+    /// <summary>
+    /// 任务合同当前状态。
+    /// </summary>
     public string ContractStatus { get; set; } = TaskContractStatus.PendingGenerate;
+
+    /// <summary>
+    /// 生成后的 DOCX 文件 Id。
+    /// </summary>
     public long? GeneratedDocxFileId { get; set; }
+
+    /// <summary>
+    /// 归档或打印使用的 PDF 文件 Id。
+    /// </summary>
     public long? GeneratedPdfFileId { get; set; }
+
+    /// <summary>
+    /// 合同文件生成时间。
+    /// </summary>
     public DateTime? GeneratedAt { get; set; }
+
+    /// <summary>
+    /// 候选人首次阅读时间。
+    /// </summary>
     public DateTime? ReadAt { get; set; }
+
+    /// <summary>
+    /// 候选人确认阅读时间。
+    /// </summary>
     public DateTime? ConfirmedAt { get; set; }
+
+    /// <summary>
+    /// 线下签署完成时间。
+    /// </summary>
     public DateTime? OfflineSignedAt { get; set; }
+
+    /// <summary>
+    /// 合同打印时间。
+    /// </summary>
     public DateTime? PrintedAt { get; set; }
 }