补充注释

SimpleAdmin.Application/Entity/Onboarding/OnboardingStatus.cs

@@ -15,13 +15,44 @@ namespace SimpleAdmin.Application;
 /// </summary>
 public static class OnboardingTaskStatus
 {
+    /// <summary>
+    /// 草稿，任务尚未生成员工填写链接。
+    /// </summary>
     public const string Draft = "draft";
+
+    /// <summary>
+    /// 待填写，候选人可以通过有效链接编辑资料。
+    /// </summary>
     public const string PendingFill = "pending_fill";
+
+    /// <summary>
+    /// 审核中，候选人已提交且资料暂时锁定。
+    /// </summary>
     public const string Reviewing = "reviewing";
+
+    /// <summary>
+    /// 已退回，候选人可根据意见补充后再次提交。
+    /// </summary>
     public const string Rejected = "rejected";
+
+    /// <summary>
+    /// 已通过，系统已经生成正式员工档案。
+    /// </summary>
     public const string Approved = "approved";
+
+    /// <summary>
+    /// 已归档，任务流程结束且历史数据只读。
+    /// </summary>
     public const string Archived = "archived";
+
+    /// <summary>
+    /// 已过期，任务或链接超过有效期。
+    /// </summary>
     public const string Expired = "expired";
+
+    /// <summary>
+    /// 已撤销，任务或链接被人事主动终止。
+    /// </summary>
     public const string Revoked = "revoked";
 }
 
@@ -30,9 +61,24 @@ public static class OnboardingTaskStatus
 /// </summary>
 public static class OnboardingLinkStatus
 {
+    /// <summary>
+    /// 有效，链接可以正常访问。
+    /// </summary>
     public const string Active = "active";
+
+    /// <summary>
+    /// 已过期，任务或链接超过有效期。
+    /// </summary>
     public const string Expired = "expired";
+
+    /// <summary>
+    /// 已撤销，任务或链接被人事主动终止。
+    /// </summary>
     public const string Revoked = "revoked";
+
+    /// <summary>
+    /// 已替换，旧链接已由新链接取代。
+    /// </summary>
     public const string Replaced = "replaced";
 }
 
@@ -41,8 +87,19 @@ public static class OnboardingLinkStatus
 /// </summary>
 public static class ContractTemplateVersionStatus
 {
+    /// <summary>
+    /// 草稿，任务尚未生成员工填写链接。
+    /// </summary>
     public const string Draft = "draft";
+
+    /// <summary>
+    /// 已启用，可用于创建新的入职任务。
+    /// </summary>
     public const string Enabled = "enabled";
+
+    /// <summary>
+    /// 已停用，不再用于新任务。
+    /// </summary>
     public const string Disabled = "disabled";
 }
 
@@ -51,10 +108,29 @@ public static class ContractTemplateVersionStatus
 /// </summary>
 public static class TaskContractStatus
 {
+    /// <summary>
+    /// 待生成，任务合同尚未生成文件。
+    /// </summary>
     public const string PendingGenerate = "pending_generate";
+
+    /// <summary>
+    /// 待确认，合同已生成并等待候选人阅读确认。
+    /// </summary>
     public const string PendingConfirm = "pending_confirm";
+
+    /// <summary>
+    /// 已确认，候选人已完成阅读确认。
+    /// </summary>
     public const string Confirmed = "confirmed";
+
+    /// <summary>
+    /// 待线下签署，首版暂不接入第三方电子签。
+    /// </summary>
     public const string OfflinePendingSign = "offline_pending_sign";
+
+    /// <summary>
+    /// 已归档，任务流程结束且历史数据只读。
+    /// </summary>
     public const string Archived = "archived";
 }
 
@@ -63,9 +139,24 @@ public static class TaskContractStatus
 /// </summary>
 public static class ContractVariableType
 {
+    /// <summary>
+    /// 值来源于候选人或正式员工信息。
+    /// </summary>
     public const string Employee = "employee";
+
+    /// <summary>
+    /// 值来源于公司档案。
+    /// </summary>
     public const string Company = "company";
+
+    /// <summary>
+    /// 值来源于合同业务参数。
+    /// </summary>
     public const string Contract = "contract";
+
+    /// <summary>
+    /// 值由系统自动生成。
+    /// </summary>
     public const string System = "system";
 }
 
@@ -74,9 +165,24 @@ public static class ContractVariableType
 /// </summary>
 public static class ContractVariableSourceType
 {
+    /// <summary>
+    /// 值来源于候选人或正式员工信息。
+    /// </summary>
     public const string Employee = "employee";
+
+    /// <summary>
+    /// 值来源于公司档案。
+    /// </summary>
     public const string Company = "company";
+
+    /// <summary>
+    /// 值由人事手工录入。
+    /// </summary>
     public const string HrInput = "hr_input";
+
+    /// <summary>
+    /// 值由系统自动生成。
+    /// </summary>
     public const string System = "system";
 }
 
@@ -85,8 +191,19 @@ public static class ContractVariableSourceType
 /// </summary>
 public static class TaskMaterialReviewStatus
 {
+    /// <summary>
+    /// 待审核。
+    /// </summary>
     public const string Pending = "pending";
+
+    /// <summary>
+    /// 审核通过。
+    /// </summary>
     public const string Passed = "passed";
+
+    /// <summary>
+    /// 需要补充或重新上传。
+    /// </summary>
     public const string NeedSupplement = "need_supplement";
 }
 
@@ -95,9 +212,28 @@ public static class TaskMaterialReviewStatus
 /// </summary>
 public static class OnboardingAuditAction
 {
+    /// <summary>
+    /// 候选人提交入职资料。
+    /// </summary>
     public const string Submit = "submit";
+
+    /// <summary>
+    /// 人事审核通过。
+    /// </summary>
     public const string Approve = "approve";
+
+    /// <summary>
+    /// 人事退回补充。
+    /// </summary>
     public const string Reject = "reject";
+
+    /// <summary>
+    /// 人事撤销任务。
+    /// </summary>
     public const string Revoke = "revoke";
+
+    /// <summary>
+    /// 人事归档任务。
+    /// </summary>
     public const string Archive = "archive";
 }