feat(permission): add Chinese verbose_name/help_text to permission models (Phase 4.1 part 6/9)

apps/permission/models/role.py

@@ -5,24 +5,48 @@ from core.models.base import SoftDeleteModel, TimeStampedModel
 
 
 class Role(SoftDeleteModel):
-    name = models.CharField(max_length=100)
-    category = models.CharField(max_length=30, choices=PermissionRoleCategory.choices)
-    description = models.TextField(blank=True, default="")
+    name = models.CharField(
+        max_length=100,
+        verbose_name="角色名称",
+    )
+    category = models.CharField(
+        max_length=30,
+        choices=PermissionRoleCategory.choices,
+        verbose_name="角色类别",
+        help_text="agent=置业顾问 / store_manager=店管 / director=总经 / operator=运营 / custom=自定义",
+    )
+    description = models.TextField(
+        blank=True,
+        default="",
+        verbose_name="角色描述",
+    )
     template_role = models.ForeignKey(
         "fonrey_permission.Role",
         null=True,
         blank=True,
         on_delete=models.SET_NULL,
         related_name="derived_roles",
+        verbose_name="权限模板来源",
+        help_text='PRD「引用该角色配置」列',
+    )
+    is_system_builtin = models.BooleanField(
+        default=False,
+        verbose_name="是否系统内置",
+        help_text='如「最大权限角色」，不可删除、不可改名',
+    )
+    is_active = models.BooleanField(
+        default=True,
+        verbose_name="是否启用",
+        help_text="FALSE=禁用（员工无法继承该角色权限）",
     )
-    is_system_builtin = models.BooleanField(default=False)
-    is_active = models.BooleanField(default=True)
     created_by = models.ForeignKey(
         "org.Staff",
         null=True,
         blank=True,
         on_delete=models.SET_NULL,
         related_name="permission_roles_created",
+        verbose_name="创建人",
+        help_text="角色类别只能由创建者修改",
     )
     updated_by = models.ForeignKey(
         "org.Staff",
@@ -30,6 +54,8 @@ class Role(SoftDeleteModel):
         blank=True,
         on_delete=models.SET_NULL,
         related_name="permission_roles_updated",
+        verbose_name="最后修改人",
+        help_text="权限管理审计用",
     )
 
     class Meta:
@@ -61,19 +87,27 @@ class RolePermission(TimeStampedModel):
         "fonrey_permission.Role",
         on_delete=models.CASCADE,
         related_name="permissions",
+        verbose_name="所属角色",
+        help_text="稀疏存储：角色删除时级联清理权限值",
     )
     permission_def = models.ForeignKey(
         "fonrey_permission.PermissionDef",
         on_delete=models.PROTECT,
         related_name="role_assignments",
+        verbose_name="权限定义",
+        help_text="RESTRICT 防止删除仍被引用的权限项",
+    )
+    value = models.JSONField(
+        verbose_name="权限值",
+        help_text='统一格式 {"v": <value>}',
     )
-    value = models.JSONField()
     updated_by = models.ForeignKey(
         "org.Staff",
         null=True,
         blank=True,
         on_delete=models.SET_NULL,
         related_name="role_permissions_updated",
+        verbose_name="最后修改人",
     )
 
     class Meta: