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

apps/setting/models/setting.py

@@ -17,18 +17,38 @@ TRADE_STATUS_CHOICES = (
 
 
 class TenantSetting(UUIDPrimaryKeyModel):
-    category = models.CharField(max_length=50)
-    key = models.CharField(max_length=100)
-    value = models.JSONField()
-    value_type = models.CharField(max_length=20, choices=SettingValueType.choices)
+    category = models.CharField(
+        max_length=50,
+        verbose_name="配置分类",
+        help_text="client / property / showroom",
+    )
+    key = models.CharField(
+        max_length=100,
+        verbose_name="配置 key",
+        help_text="如 duplicate_check_scope",
+    )
+    value = models.JSONField(
+        verbose_name="配置值",
+        help_text='JSONB，统一格式 {"v": <value>}',
+    )
+    value_type = models.CharField(
+        max_length=20,
+        choices=SettingValueType.choices,
+        verbose_name="值类型",
+        help_text="bool / int / string / enum，用于前端渲染控件",
+    )
     updated_by = models.ForeignKey(
         "org.Staff",
         null=True,
         blank=True,
         on_delete=models.SET_NULL,
         related_name="updated_tenant_settings",
+        verbose_name="最后修改人",
+    )
+    updated_at = models.DateTimeField(
+        auto_now=True,
+        verbose_name="更新时间",
     )
-    updated_at = models.DateTimeField(auto_now=True)
 
     class Meta:
         db_table = "tenant_settings"
@@ -45,12 +65,34 @@ class TenantSetting(UUIDPrimaryKeyModel):
 
 
 class FieldRequirementRule(UUIDPrimaryKeyModel):
-    module = models.CharField(max_length=20, choices=FieldRuleModule.choices)
-    entity_type = models.CharField(max_length=50, choices=FieldRuleEntityType.choices)
-    trade_status = models.CharField(max_length=20, choices=TRADE_STATUS_CHOICES)
-    field_key = models.CharField(max_length=50)
+    module = models.CharField(
+        max_length=20,
+        choices=FieldRuleModule.choices,
+        verbose_name="模块",
+        help_text="property / client，MVP 仅 property",
+    )
+    entity_type = models.CharField(
+        max_length=50,
+        choices=FieldRuleEntityType.choices,
+        verbose_name="实体类型",
+        help_text="与 property.property_type 值域完全一致：residential/villa/commercial_residential/shop/office/other",
+    )
+    trade_status = models.CharField(
+        max_length=20,
+        choices=TRADE_STATUS_CHOICES,
+        verbose_name="交易状态",
+        help_text="sale=出售 / rent=出租 / sale_rent=租售 / *=全部（fallback 通配）",
+    )
+    field_key = models.CharField(
+        max_length=50,
+        verbose_name="字段 key",
+        help_text="如 orientation / decoration / floor / building_area",
+    )
     requirement = models.CharField(
-        max_length=10, choices=FieldRuleRequirement.choices
+        max_length=10,
+        choices=FieldRuleRequirement.choices,
+        verbose_name="规则",
+        help_text="required=必填 / optional=选填 / hidden=隐藏",
     )
     updated_by = models.ForeignKey(
         "org.Staff",
@@ -58,8 +100,12 @@ class FieldRequirementRule(UUIDPrimaryKeyModel):
         blank=True,
         on_delete=models.SET_NULL,
         related_name="updated_field_rules",
+        verbose_name="最后修改人",
+    )
+    updated_at = models.DateTimeField(
+        auto_now=True,
+        verbose_name="更新时间",
     )
-    updated_at = models.DateTimeField(auto_now=True)
 
     class Meta:
         db_table = "field_requirement_rules"