feat(migrations): add Phase 4.0+4.1 verbose_name/help_text migrations

Generated by manage.py makemigrations after Phase 4.0 (model Meta verbose_name)
and Phase 4.1 (field-level verbose_name/help_text) were committed across all 9 apps.

Field-meta only (Alter field on Meta options); no schema changes.

apps/permission/migrations/0003_alter_permissionchangelog_action_and_more.py

@@ -0,0 +1,336 @@
+# Generated by Django 4.2.16 on 2026-04-30 01:46
+
+import django.contrib.postgres.fields
+from django.db import migrations, models
+import django.db.models.deletion
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('org', '0003_alter_orgunit_address_city_and_more'),
+        ('fonrey_permission', '0002_alter_permissionchangelog_options_and_more'),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name='permissionchangelog',
+            name='action',
+            field=models.CharField(choices=[('create', '创建'), ('update', '更新'), ('delete', '删除'), ('assign', '分配'), ('revoke', '撤销')], help_text='create / update / delete / assign / revoke', max_length=20, verbose_name='操作动作'),
+        ),
+        migrations.AlterField(
+            model_name='permissionchangelog',
+            name='new_value',
+            field=models.JSONField(blank=True, null=True, verbose_name='变更后快照'),
+        ),
+        migrations.AlterField(
+            model_name='permissionchangelog',
+            name='old_value',
+            field=models.JSONField(blank=True, null=True, verbose_name='变更前快照'),
+        ),
+        migrations.AlterField(
+            model_name='permissionchangelog',
+            name='operated_at',
+            field=models.DateTimeField(auto_now_add=True, help_text='append-only 流水，分区键', verbose_name='操作时间'),
+        ),
+        migrations.AlterField(
+            model_name='permissionchangelog',
+            name='operator',
+            field=models.ForeignKey(on_delete=django.db.models.deletion.PROTECT, related_name='permission_changes_operated', to='org.staff', verbose_name='操作人'),
+        ),
+        migrations.AlterField(
+            model_name='permissionchangelog',
+            name='operator_ip',
+            field=models.GenericIPAddressField(blank=True, null=True, verbose_name='操作来源 IP'),
+        ),
+        migrations.AlterField(
+            model_name='permissionchangelog',
+            name='permission_code',
+            field=models.CharField(blank=True, default='', help_text='用 code 而非 FK，避免 PermissionDef 删除后日志丢失', max_length=150, verbose_name='权限编码'),
+        ),
+        migrations.AlterField(
+            model_name='permissionchangelog',
+            name='reason',
+            field=models.TextField(blank=True, default='', help_text='批量设置角色等场景强制填写', verbose_name='操作原因'),
+        ),
+        migrations.AlterField(
+            model_name='permissionchangelog',
+            name='role',
+            field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='change_logs', to='fonrey_permission.role', verbose_name='被影响角色'),
+        ),
+        migrations.AlterField(
+            model_name='permissionchangelog',
+            name='staff',
+            field=models.ForeignKey(blank=True, help_text='target 是 staff_role/staff_override/staff_scope 时必填', null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='permission_change_logs_affecting', to='org.staff', verbose_name='被影响员工'),
+        ),
+        migrations.AlterField(
+            model_name='permissionchangelog',
+            name='target_id',
+            field=models.UUIDField(verbose_name='变更对象 ID'),
+        ),
+        migrations.AlterField(
+            model_name='permissionchangelog',
+            name='target_type',
+            field=models.CharField(choices=[('role', '角色'), ('role_permission', '角色权限'), ('staff_role', '员工角色'), ('staff_override', '员工权限覆盖'), ('staff_scope', '员工数据范围')], help_text='role / role_permission / staff_role / staff_override / staff_scope', max_length=30, verbose_name='变更对象类型'),
+        ),
+        migrations.AlterField(
+            model_name='permissionchangelog',
+            name='user_agent',
+            field=models.TextField(blank=True, default='', verbose_name='操作终端 UA'),
+        ),
+        migrations.AlterField(
+            model_name='permissiondef',
+            name='code',
+            field=models.CharField(help_text='规则：{module}.{sub_module}.{action}[.{qualifier}]', max_length=150, unique=True, verbose_name='权限编码'),
+        ),
+        migrations.AlterField(
+            model_name='permissiondef',
+            name='default_value',
+            field=models.JSONField(default=dict, help_text='系统最小默认值，格式 {"v": <value>}', verbose_name='默认值'),
+        ),
+        migrations.AlterField(
+            model_name='permissiondef',
+            name='description',
+            field=models.TextField(blank=True, default='', verbose_name='权限作用描述'),
+        ),
+        migrations.AlterField(
+            model_name='permissiondef',
+            name='group_name',
+            field=models.CharField(help_text='如「私客基础权限」「联系人基础权限」', max_length=100, verbose_name='分组标题'),
+        ),
+        migrations.AlterField(
+            model_name='permissiondef',
+            name='integer_max',
+            field=models.IntegerField(blank=True, help_text='仅 INTEGER 类型有效；NULL=无上限（业务上 0 通常代表不限制）', null=True, verbose_name='最大值'),
+        ),
+        migrations.AlterField(
+            model_name='permissiondef',
+            name='integer_min',
+            field=models.IntegerField(blank=True, help_text='仅 INTEGER 类型有效', null=True, verbose_name='最小值'),
+        ),
+        migrations.AlterField(
+            model_name='permissiondef',
+            name='is_active',
+            field=models.BooleanField(default=True, help_text='下线权限项置 FALSE，历史记录保留', verbose_name='是否启用'),
+        ),
+        migrations.AlterField(
+            model_name='permissiondef',
+            name='is_deprecated',
+            field=models.BooleanField(default=False, help_text='不再推荐使用但保持兼容', verbose_name='是否废弃'),
+        ),
+        migrations.AlterField(
+            model_name='permissiondef',
+            name='max_allowed_categories',
+            field=django.contrib.postgres.fields.ArrayField(base_field=models.CharField(max_length=50), blank=True, default=list, help_text='允许配置此权限的角色类别列表，空数组=所有类别均可', size=None, verbose_name='可配置角色类别'),
+        ),
+        migrations.AlterField(
+            model_name='permissiondef',
+            name='module',
+            field=models.CharField(choices=[('home', '首页'), ('property', '房源'), ('new_house', '新房'), ('client', '客源'), ('transaction', '交易'), ('data', '数据'), ('marketing', '营销'), ('hr', '人事OA'), ('contract', '合同'), ('trinet', '三网'), ('system', '系统'), ('mobile', '移动端'), ('smart_store', '智能门店'), ('recharge', '在线充值')], help_text='home/property/new_house/client/transaction/data/marketing/hr/contract/trinet/system/mobile/smart_store/recharge', max_length=50, verbose_name='一级模块'),
+        ),
+        migrations.AlterField(
+            model_name='permissiondef',
+            name='name',
+            field=models.CharField(max_length=200, verbose_name='显示名称'),
+        ),
+        migrations.AlterField(
+            model_name='permissiondef',
+            name='scope_choices',
+            field=models.JSONField(blank=True, default=list, help_text='仅 SCOPE 类型有效，可选枚举 code 列表，如 ["none","self","store","company"]', verbose_name='可选范围'),
+        ),
+        migrations.AlterField(
+            model_name='permissiondef',
+            name='sort_order',
+            field=models.PositiveIntegerField(default=0, help_text='分组内排序', verbose_name='排序顺序'),
+        ),
+        migrations.AlterField(
+            model_name='permissiondef',
+            name='sub_module',
+            field=models.CharField(blank=True, default='', help_text='如「二手&租赁」「商圈精耕」', max_length=50, verbose_name='二级模块'),
+        ),
+        migrations.AlterField(
+            model_name='permissiondef',
+            name='value_type',
+            field=models.CharField(choices=[('boolean', '开关型'), ('scope', '范围型'), ('integer', '数值型')], help_text='BOOLEAN=开关型 / SCOPE=范围型 / INTEGER=数值型', max_length=20, verbose_name='权限值类型'),
+        ),
+        migrations.AlterField(
+            model_name='permissiondef',
+            name='version',
+            field=models.PositiveIntegerField(default=1, help_text='变更时递增，用于缓存失效', verbose_name='定义版本'),
+        ),
+        migrations.AlterField(
+            model_name='role',
+            name='category',
+            field=models.CharField(choices=[('agent', '置业顾问'), ('store_manager', '店管'), ('director', '总经'), ('operator', '运营/行政'), ('custom', '自定义')], help_text='agent=置业顾问 / store_manager=店管 / director=总经 / operator=运营 / custom=自定义', max_length=30, verbose_name='角色类别'),
+        ),
+        migrations.AlterField(
+            model_name='role',
+            name='created_by',
+            field=models.ForeignKey(blank=True, help_text='角色类别只能由创建者修改', null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='permission_roles_created', to='org.staff', verbose_name='创建人'),
+        ),
+        migrations.AlterField(
+            model_name='role',
+            name='description',
+            field=models.TextField(blank=True, default='', verbose_name='角色描述'),
+        ),
+        migrations.AlterField(
+            model_name='role',
+            name='is_active',
+            field=models.BooleanField(default=True, help_text='FALSE=禁用（员工无法继承该角色权限）', verbose_name='是否启用'),
+        ),
+        migrations.AlterField(
+            model_name='role',
+            name='is_system_builtin',
+            field=models.BooleanField(default=False, help_text='如「最大权限角色」，不可删除、不可改名', verbose_name='是否系统内置'),
+        ),
+        migrations.AlterField(
+            model_name='role',
+            name='name',
+            field=models.CharField(max_length=100, verbose_name='角色名称'),
+        ),
+        migrations.AlterField(
+            model_name='role',
+            name='template_role',
+            field=models.ForeignKey(blank=True, help_text='PRD「引用该角色配置」列', null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='derived_roles', to='fonrey_permission.role', verbose_name='权限模板来源'),
+        ),
+        migrations.AlterField(
+            model_name='role',
+            name='updated_by',
+            field=models.ForeignKey(blank=True, help_text='权限管理审计用', null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='permission_roles_updated', to='org.staff', verbose_name='最后修改人'),
+        ),
+        migrations.AlterField(
+            model_name='rolepermission',
+            name='permission_def',
+            field=models.ForeignKey(help_text='RESTRICT 防止删除仍被引用的权限项', on_delete=django.db.models.deletion.PROTECT, related_name='role_assignments', to='fonrey_permission.permissiondef', verbose_name='权限定义'),
+        ),
+        migrations.AlterField(
+            model_name='rolepermission',
+            name='role',
+            field=models.ForeignKey(help_text='稀疏存储：角色删除时级联清理权限值', on_delete=django.db.models.deletion.CASCADE, related_name='permissions', to='fonrey_permission.role', verbose_name='所属角色'),
+        ),
+        migrations.AlterField(
+            model_name='rolepermission',
+            name='updated_by',
+            field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='role_permissions_updated', to='org.staff', verbose_name='最后修改人'),
+        ),
+        migrations.AlterField(
+            model_name='rolepermission',
+            name='value',
+            field=models.JSONField(help_text='统一格式 {"v": <value>}', verbose_name='权限值'),
+        ),
+        migrations.AlterField(
+            model_name='staffdatascope',
+            name='expires_at',
+            field=models.DateTimeField(blank=True, null=True, verbose_name='临时授权失效时间'),
+        ),
+        migrations.AlterField(
+            model_name='staffdatascope',
+            name='granted_at',
+            field=models.DateTimeField(auto_now_add=True, verbose_name='授权时间'),
+        ),
+        migrations.AlterField(
+            model_name='staffdatascope',
+            name='granted_by',
+            field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='data_scopes_granted', to='org.staff', verbose_name='授权操作人'),
+        ),
+        migrations.AlterField(
+            model_name='staffdatascope',
+            name='is_readable',
+            field=models.BooleanField(default=True, verbose_name='可读'),
+        ),
+        migrations.AlterField(
+            model_name='staffdatascope',
+            name='is_writable',
+            field=models.BooleanField(default=False, help_text='默认只读', verbose_name='可写'),
+        ),
+        migrations.AlterField(
+            model_name='staffdatascope',
+            name='org_unit',
+            field=models.ForeignKey(blank=True, help_text='scope_type=custom_unit 时必填，其他类型为 NULL', null=True, on_delete=django.db.models.deletion.PROTECT, related_name='data_scope_grants', to='org.orgunit', verbose_name='组织节点'),
+        ),
+        migrations.AlterField(
+            model_name='staffdatascope',
+            name='reason',
+            field=models.TextField(blank=True, default='', verbose_name='授予原因'),
+        ),
+        migrations.AlterField(
+            model_name='staffdatascope',
+            name='scope_type',
+            field=models.CharField(choices=[('self', '本人'), ('group', '本组'), ('store', '本门店'), ('area', '本区域'), ('region', '本大区'), ('company', '全公司'), ('custom_unit', '自定义组织单元')], help_text='self=本人 / group=本组 / store=本门店 / area=本区域 / region=本大区 / company=全公司 / custom_unit=指定节点', max_length=20, verbose_name='范围类型'),
+        ),
+        migrations.AlterField(
+            model_name='staffdatascope',
+            name='staff',
+            field=models.ForeignKey(help_text='员工删除时级联删除范围记录', on_delete=django.db.models.deletion.CASCADE, related_name='data_scopes', to='org.staff', verbose_name='所属员工'),
+        ),
+        migrations.AlterField(
+            model_name='staffpermissionoverride',
+            name='modified_at',
+            field=models.DateTimeField(auto_now=True, verbose_name='最近修改时间'),
+        ),
+        migrations.AlterField(
+            model_name='staffpermissionoverride',
+            name='modified_by',
+            field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='staff_overrides_modified', to='org.staff', verbose_name='修改人'),
+        ),
+        migrations.AlterField(
+            model_name='staffpermissionoverride',
+            name='override_mode',
+            field=models.CharField(choices=[('replace', '覆盖'), ('restrict', '限制'), ('grant', '授予')], default='replace', help_text='REPLACE=替换合并值 / RESTRICT=限制上限 / GRANT=仅扩展', max_length=10, verbose_name='覆盖模式'),
+        ),
+        migrations.AlterField(
+            model_name='staffpermissionoverride',
+            name='permission_def',
+            field=models.ForeignKey(on_delete=django.db.models.deletion.PROTECT, related_name='staff_overrides', to='fonrey_permission.permissiondef', verbose_name='被覆盖权限项'),
+        ),
+        migrations.AlterField(
+            model_name='staffpermissionoverride',
+            name='reason',
+            field=models.TextField(blank=True, default='', help_text='管理员备注，建议强制填写以便审计', verbose_name='备注'),
+        ),
+        migrations.AlterField(
+            model_name='staffpermissionoverride',
+            name='staff',
+            field=models.ForeignKey(help_text='员工删除时级联删除覆盖记录', on_delete=django.db.models.deletion.CASCADE, related_name='permission_overrides', to='org.staff', verbose_name='所属员工'),
+        ),
+        migrations.AlterField(
+            model_name='staffpermissionoverride',
+            name='value',
+            field=models.JSONField(help_text='统一格式 {"v": <value>}', verbose_name='个人权限值'),
+        ),
+        migrations.AlterField(
+            model_name='staffrole',
+            name='assigned_at',
+            field=models.DateTimeField(auto_now_add=True, verbose_name='分配时间'),
+        ),
+        migrations.AlterField(
+            model_name='staffrole',
+            name='assigned_by',
+            field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='staff_role_assignments_made', to='org.staff', verbose_name='分配操作人'),
+        ),
+        migrations.AlterField(
+            model_name='staffrole',
+            name='is_primary',
+            field=models.BooleanField(default=False, help_text='每个员工有且仅有一个主角色', verbose_name='是否主角色'),
+        ),
+        migrations.AlterField(
+            model_name='staffrole',
+            name='role',
+            field=models.ForeignKey(help_text='角色被员工引用时禁止删除', on_delete=django.db.models.deletion.PROTECT, related_name='staff_links', to='fonrey_permission.role', verbose_name='角色'),
+        ),
+        migrations.AlterField(
+            model_name='staffrole',
+            name='staff',
+            field=models.ForeignKey(help_text='员工删除时级联删除角色关联', on_delete=django.db.models.deletion.CASCADE, related_name='staff_roles', to='org.staff', verbose_name='所属员工'),
+        ),
+        migrations.AlterField(
+            model_name='staffrole',
+            name='valid_from',
+            field=models.DateField(blank=True, help_text='预留未来「定时生效」功能', null=True, verbose_name='生效日'),
+        ),
+        migrations.AlterField(
+            model_name='staffrole',
+            name='valid_until',
+            field=models.DateField(blank=True, null=True, verbose_name='失效日'),
+        ),
+    ]