feat(setting): add Chinese verbose_name/help_text to setting models (Phase 4.1 part 7/9)

apps/setting/models/lookup.py

@@ -4,13 +4,39 @@ from core.models.base import UUIDPrimaryKeyModel
 
 
 class LookupGroup(UUIDPrimaryKeyModel):
-    module = models.CharField(max_length=50)
-    key = models.CharField(max_length=100)
-    label_zh = models.CharField(max_length=50)
-    description = models.TextField(blank=True, default="")
-    sort_order = models.SmallIntegerField(default=0)
-    created_at = models.DateTimeField(auto_now_add=True)
-    updated_at = models.DateTimeField(auto_now=True)
+    module = models.CharField(
+        max_length=50,
+        verbose_name="所属模块",
+        help_text="client / property",
+    )
+    key = models.CharField(
+        max_length=100,
+        verbose_name="分组 key",
+        help_text="如 source / follow_purpose",
+    )
+    label_zh = models.CharField(
+        max_length=50,
+        verbose_name="分组中文名",
+        help_text="界面显示名称，如「客源来源」",
+    )
+    description = models.TextField(
+        blank=True,
+        default="",
+        verbose_name="分组说明",
+        help_text="前端 tooltip 使用",
+    )
+    sort_order = models.SmallIntegerField(
+        default=0,
+        verbose_name="排序",
+    )
+    created_at = models.DateTimeField(
+        auto_now_add=True,
+        verbose_name="创建时间",
+    )
+    updated_at = models.DateTimeField(
+        auto_now=True,
+        verbose_name="更新时间",
+    )
 
     class Meta:
         db_table = "lookup_groups"
@@ -25,22 +51,52 @@ class LookupGroup(UUIDPrimaryKeyModel):
 
 class LookupItem(UUIDPrimaryKeyModel):
     group = models.ForeignKey(
-        LookupGroup, on_delete=models.CASCADE, related_name="items"
+        LookupGroup,
+        on_delete=models.CASCADE,
+        related_name="items",
+        verbose_name="所属分组",
+    )
+    value = models.CharField(
+        max_length=100,
+        verbose_name="存储值",
+        help_text="英文 snake_case，如 door_to_door；写入后只读",
+    )
+    label_zh = models.CharField(
+        max_length=50,
+        verbose_name="显示文本",
+        help_text="如「上门」",
+    )
+    is_system = models.BooleanField(
+        default=False,
+        verbose_name="是否系统预制",
+        help_text="True=系统预制不可物理删除，仅可停用",
+    )
+    is_active = models.BooleanField(
+        default=True,
+        verbose_name="是否启用",
+        help_text="False 后录入下拉不展示，历史记录保留并展示「（已停用）」后缀",
+    )
+    sort_order = models.SmallIntegerField(
+        default=0,
+        verbose_name="排序",
     )
-    value = models.CharField(max_length=100)
-    label_zh = models.CharField(max_length=50)
-    is_system = models.BooleanField(default=False)
-    is_active = models.BooleanField(default=True)
-    sort_order = models.SmallIntegerField(default=0)
     created_by = models.ForeignKey(
         "org.Staff",
         null=True,
         blank=True,
         on_delete=models.SET_NULL,
         related_name="created_lookup_items",
+        verbose_name="创建人",
+        help_text="系统预制时为 NULL",
+    )
+    created_at = models.DateTimeField(
+        auto_now_add=True,
+        verbose_name="创建时间",
+    )
+    updated_at = models.DateTimeField(
+        auto_now=True,
+        verbose_name="更新时间",
     )
-    created_at = models.DateTimeField(auto_now_add=True)
-    updated_at = models.DateTimeField(auto_now=True)
 
     class Meta:
         db_table = "lookup_items"