feat(org): add Chinese verbose_name and help_text to all org fields (Phase 4.1 part 4/9)

Sync DATA_MODEL_ORG.md field-level Chinese annotations to Django models across 11 org tables (OrgUnit, Staff, StaffPersonalInfo, StaffTransferLog, StaffRewardPunish, StaffAccount, StaffWorkExperience, StaffEducation, StaffTraining, StaffFamilyMember, StaffRemark).
2026-04-30 09:25:17 +08:00
parent a3800bf09d
commit f185127335
3 changed files with 570 additions and 99 deletions
--- a/apps/org/models/staff_logs.py
+++ b/apps/org/models/staff_logs.py
@@ -9,18 +9,48 @@ class StaffTransferLog(TimeStampedModel):
        "org.Staff",
        on_delete=models.RESTRICT,
        related_name="transfer_logs",
+        verbose_name="被操作员工",
+    )
+    transfer_type = models.CharField(
+        max_length=30,
+        choices=StaffTransferType.choices,
+        verbose_name="异动类型",
+        help_text="onboard=入职 / transfer=调动 / resign=离职 / rejoin=复职 / supervisor_change=上级变动 / role_change=角色变更 / freeze=账号冻结 / unfreeze=账号恢复",
+    )
+    old_value = models.JSONField(
+        null=True,
+        blank=True,
+        verbose_name="变动前值",
+        help_text='格式：{"field": "org_unit_id", "value": "...", "label": "门店A"}',
+    )
+    new_value = models.JSONField(
+        null=True,
+        blank=True,
+        verbose_name="变动后值",
+        help_text="结构同 old_value",
+    )
+    transfer_date = models.DateField(
+        verbose_name="异动生效日期",
+        help_text="可以是过去日期",
+    )
+    remarks = models.CharField(
+        max_length=50,
+        blank=True,
+        default="",
+        verbose_name="备注",
+        help_text="最多50字",
    )
-    transfer_type = models.CharField(max_length=30, choices=StaffTransferType.choices)
-    old_value = models.JSONField(null=True, blank=True)
-    new_value = models.JSONField(null=True, blank=True)
-    transfer_date = models.DateField()
-    remarks = models.CharField(max_length=50, blank=True, default="")
    operator = models.ForeignKey(
        "org.Staff",
        on_delete=models.RESTRICT,
        related_name="operated_transfers",
+        verbose_name="操作人",
+        help_text="必填，异动审计必须记录",
+    )
+    operated_at = models.DateTimeField(
+        auto_now_add=True,
+        verbose_name="系统操作时间",
    )
-    operated_at = models.DateTimeField(auto_now_add=True)

    class Meta:
        db_table = "staff_transfer_logs"
@@ -38,20 +68,33 @@ class StaffRewardPunish(SoftDeleteModel):
        "org.Staff",
        on_delete=models.CASCADE,
        related_name="reward_punish_records",
+        verbose_name="被奖惩员工",
+    )
+    rp_date = models.DateField(
+        verbose_name="奖惩日期",
    )
-    rp_date = models.DateField()
    category = models.CharField(
        max_length=50,
-        help_text="Configurable lookup_items domain: org.reward_punish_category.",
+        verbose_name="奖惩类别",
+        help_text="枚举由 lookup_items 维护：org.reward_punish_category",
+    )
+    name = models.CharField(
+        max_length=100,
+        verbose_name="奖惩名称",
+        help_text="与类别联动",
+    )
+    remarks = models.TextField(
+        blank=True,
+        default="",
+        verbose_name="备注",
    )
-    name = models.CharField(max_length=100)
-    remarks = models.TextField(blank=True, default="")
    created_by = models.ForeignKey(
        "org.Staff",
        null=True,
        blank=True,
        on_delete=models.SET_NULL,
        related_name="created_reward_punish",
+        verbose_name="录入人",
    )

    class Meta:
@@ -65,12 +108,36 @@ class StaffAccount(TimeStampedModel):
        "org.Staff",
        on_delete=models.CASCADE,
        related_name="external_accounts",
+        verbose_name="所属员工",
+        help_text="证件信息随员工关联",
+    )
+    platform = models.CharField(
+        max_length=30,
+        choices=StaffAccountPlatform.choices,
+        verbose_name="平台",
+        help_text="fonrey=主账号 / 58anjuke=58安居客 / cnreic=中国网络经纪人 / wechat_mp=微信公众号",
+    )
+    account_no = models.CharField(
+        max_length=100,
+        blank=True,
+        default="",
+        verbose_name="账号/手机号",
+    )
+    is_real_name_match = models.BooleanField(
+        null=True,
+        blank=True,
+        verbose_name="实名信息一致",
+        help_text="中国网络经纪人专用",
+    )
+    is_bound = models.BooleanField(
+        default=False,
+        verbose_name="是否已绑定",
+    )
+    bound_at = models.DateTimeField(
+        null=True,
+        blank=True,
+        verbose_name="绑定时间",
    )
-    platform = models.CharField(max_length=30, choices=StaffAccountPlatform.choices)
-    account_no = models.CharField(max_length=100, blank=True, default="")
-    is_real_name_match = models.BooleanField(null=True, blank=True)
-    is_bound = models.BooleanField(default=False)
-    bound_at = models.DateTimeField(null=True, blank=True)

    class Meta:
        db_table = "staff_accounts"
@@ -89,14 +156,46 @@ class StaffWorkExperience(TimeStampedModel):
        "org.Staff",
        on_delete=models.CASCADE,
        related_name="work_experiences",
+        verbose_name="所属员工",
+    )
+    company = models.CharField(
+        max_length=200,
+        verbose_name="公司名称",
+    )
+    job_title = models.CharField(
+        max_length=100,
+        blank=True,
+        default="",
+        verbose_name="职位",
+    )
+    start_date = models.DateField(
+        null=True,
+        blank=True,
+        verbose_name="开始日期",
+    )
+    end_date = models.DateField(
+        null=True,
+        blank=True,
+        verbose_name="结束日期",
+    )
+    reason = models.CharField(
+        max_length=200,
+        blank=True,
+        default="",
+        verbose_name="离职原因",
+    )
+    reference_name = models.CharField(
+        max_length=50,
+        blank=True,
+        default="",
+        verbose_name="证明人姓名",
+    )
+    reference_phone = models.CharField(
+        max_length=30,
+        blank=True,
+        default="",
+        verbose_name="证明人电话",
    )
-    company = models.CharField(max_length=200)
-    job_title = models.CharField(max_length=100, blank=True, default="")
-    start_date = models.DateField(null=True, blank=True)
-    end_date = models.DateField(null=True, blank=True)
-    reason = models.CharField(max_length=200, blank=True, default="")
-    reference_name = models.CharField(max_length=50, blank=True, default="")
-    reference_phone = models.CharField(max_length=30, blank=True, default="")

    class Meta:
        db_table = "staff_work_experiences"
@@ -109,14 +208,46 @@ class StaffEducation(TimeStampedModel):
        "org.Staff",
        on_delete=models.CASCADE,
        related_name="educations",
+        verbose_name="所属员工",
+    )
+    stage = models.CharField(
+        max_length=30,
+        blank=True,
+        default="",
+        verbose_name="教育阶段",
+    )
+    school = models.CharField(
+        max_length=200,
+        verbose_name="学校",
+    )
+    major = models.CharField(
+        max_length=100,
+        blank=True,
+        default="",
+        verbose_name="专业",
+    )
+    start_date = models.DateField(
+        null=True,
+        blank=True,
+        verbose_name="开始日期",
+    )
+    end_date = models.DateField(
+        null=True,
+        blank=True,
+        verbose_name="结束日期",
+    )
+    enrollment_status = models.CharField(
+        max_length=30,
+        blank=True,
+        default="",
+        verbose_name="就读状态",
+    )
+    degree = models.CharField(
+        max_length=30,
+        blank=True,
+        default="",
+        verbose_name="学位",
    )
-    stage = models.CharField(max_length=30, blank=True, default="")
-    school = models.CharField(max_length=200)
-    major = models.CharField(max_length=100, blank=True, default="")
-    start_date = models.DateField(null=True, blank=True)
-    end_date = models.DateField(null=True, blank=True)
-    enrollment_status = models.CharField(max_length=30, blank=True, default="")
-    degree = models.CharField(max_length=30, blank=True, default="")

    class Meta:
        db_table = "staff_educations"
@@ -129,10 +260,23 @@ class StaffTraining(TimeStampedModel):
        "org.Staff",
        on_delete=models.CASCADE,
        related_name="trainings",
+        verbose_name="所属员工",
+    )
+    training_name = models.CharField(
+        max_length=200,
+        verbose_name="培训名称",
+    )
+    training_date = models.DateField(
+        null=True,
+        blank=True,
+        verbose_name="培训日期",
+    )
+    certificate = models.CharField(
+        max_length=200,
+        blank=True,
+        default="",
+        verbose_name="证书",
    )
-    training_name = models.CharField(max_length=200)
-    training_date = models.DateField(null=True, blank=True)
-    certificate = models.CharField(max_length=200, blank=True, default="")

    class Meta:
        db_table = "staff_trainings"
@@ -145,13 +289,39 @@ class StaffFamilyMember(TimeStampedModel):
        "org.Staff",
        on_delete=models.CASCADE,
        related_name="family_members",
+        verbose_name="所属员工",
+    )
+    relation = models.CharField(
+        max_length=30,
+        verbose_name="称谓",
+    )
+    name = models.CharField(
+        max_length=50,
+        verbose_name="姓名",
+    )
+    birthdate = models.DateField(
+        null=True,
+        blank=True,
+        verbose_name="出生日期",
+    )
+    occupation = models.CharField(
+        max_length=100,
+        blank=True,
+        default="",
+        verbose_name="职业",
+    )
+    work_unit = models.CharField(
+        max_length=200,
+        blank=True,
+        default="",
+        verbose_name="工作单位",
+    )
+    phone_enc = models.BinaryField(
+        null=True,
+        blank=True,
+        verbose_name="电话(加密)",
+        help_text="AES-256-GCM 加密",
    )
-    relation = models.CharField(max_length=30)
-    name = models.CharField(max_length=50)
-    birthdate = models.DateField(null=True, blank=True)
-    occupation = models.CharField(max_length=100, blank=True, default="")
-    work_unit = models.CharField(max_length=200, blank=True, default="")
-    phone_enc = models.BinaryField(null=True, blank=True)

    class Meta:
        db_table = "staff_family_members"
@@ -164,14 +334,18 @@ class StaffRemark(SoftDeleteModel):
        "org.Staff",
        on_delete=models.CASCADE,
        related_name="remarks",
+        verbose_name="所属员工",
+    )
+    content = models.TextField(
+        verbose_name="备注内容",
    )
-    content = models.TextField()
    created_by = models.ForeignKey(
        "org.Staff",
        null=True,
        blank=True,
        on_delete=models.SET_NULL,
        related_name="created_remarks",
+        verbose_name="创建人",
    )

    class Meta: