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).
This commit is contained in:
2026-04-30 09:25:17 +08:00
parent a3800bf09d
commit f185127335
3 changed files with 570 additions and 99 deletions

View File

@@ -5,8 +5,17 @@ from core.models.base import SoftDeleteModel
class OrgUnit(SoftDeleteModel):
name = models.CharField(max_length=100)
type = models.CharField(max_length=20, choices=OrgUnitType.choices)
name = models.CharField(
max_length=100,
verbose_name="部门名称",
help_text="部门/组织名称",
)
type = models.CharField(
max_length=20,
choices=OrgUnitType.choices,
verbose_name="组织类型",
help_text="company=公司 / division=事业部 / region=大区 / area=区域 / district=片区 / store=门店 / group=店组 / functional=职能",
)
parent = models.ForeignKey(
"self",
null=True,
@@ -14,35 +23,100 @@ class OrgUnit(SoftDeleteModel):
on_delete=models.RESTRICT,
related_name="children",
db_index=True,
verbose_name="父节点",
help_text="父节点,根节点为 NULL",
)
path = models.TextField(
help_text="Materialized path: /root_id/.../self_id/ for subtree queries.",
verbose_name="物化路径",
help_text='/root_id/.../self_id/,用于子树查询',
)
depth = models.SmallIntegerField(
default=0,
verbose_name="节点深度",
help_text="根=0最大支持 8 层",
)
sort_order = models.IntegerField(
default=0,
verbose_name="排序顺序",
help_text="同级排序",
)
depth = models.SmallIntegerField(default=0)
sort_order = models.IntegerField(default=0)
attribute = models.CharField(
max_length=10,
choices=OrgUnitAttribute.choices,
null=True,
blank=True,
verbose_name="经营属性",
help_text="direct=直营 / franchise=加盟",
)
address_city = models.CharField(
max_length=50,
blank=True,
default="",
verbose_name="所在城市",
)
address_district = models.CharField(
max_length=50,
blank=True,
default="",
verbose_name="所在县区",
)
address_detail = models.CharField(
max_length=200,
blank=True,
default="",
verbose_name="详细地址",
)
latitude = models.DecimalField(
max_digits=10,
decimal_places=7,
null=True,
blank=True,
verbose_name="纬度",
help_text="部门定位针 WGS84",
)
longitude = models.DecimalField(
max_digits=10,
decimal_places=7,
null=True,
blank=True,
verbose_name="经度",
help_text="部门定位针 WGS84",
)
address_city = models.CharField(max_length=50, blank=True, default="")
address_district = models.CharField(max_length=50, blank=True, default="")
address_detail = models.CharField(max_length=200, blank=True, default="")
latitude = models.DecimalField(max_digits=10, decimal_places=7, null=True, blank=True)
longitude = models.DecimalField(max_digits=10, decimal_places=7, null=True, blank=True)
manager = models.ForeignKey(
"org.Staff",
null=True,
blank=True,
on_delete=models.SET_NULL,
related_name="managed_org_units",
verbose_name="部门负责人",
help_text="循环依赖Application 层维护",
)
established_at = models.DateField(
null=True,
blank=True,
verbose_name="成立时间",
)
phone = models.CharField(
max_length=30,
blank=True,
default="",
verbose_name="部门联系电话",
)
ext_start = models.IntegerField(
null=True,
blank=True,
verbose_name="分机号起始",
)
ext_end = models.IntegerField(
null=True,
blank=True,
verbose_name="分机号结束",
)
is_active = models.BooleanField(
default=True,
verbose_name="是否启用",
help_text="FALSE=已关闭部门,仍可在筛选中显示",
)
established_at = models.DateField(null=True, blank=True)
phone = models.CharField(max_length=30, blank=True, default="")
ext_start = models.IntegerField(null=True, blank=True)
ext_end = models.IntegerField(null=True, blank=True)
is_active = models.BooleanField(default=True)
class Meta:
db_table = "org_units"

View File

@@ -11,6 +11,8 @@ class Staff(SoftDeleteModel):
on_delete=models.RESTRICT,
related_name="staff_members",
db_index=True,
verbose_name="所属组织节点",
help_text="当前所属组织节点(门店或店组)",
)
user = models.OneToOneField(
settings.AUTH_USER_MODEL,
@@ -18,73 +20,195 @@ class Staff(SoftDeleteModel):
blank=True,
on_delete=models.SET_NULL,
related_name="staff_profile",
verbose_name="登录账号",
help_text="Django auth 登录账号",
)
name = models.CharField(
max_length=50,
verbose_name="真实姓名",
)
nickname = models.CharField(
max_length=50,
blank=True,
default="",
verbose_name="昵称",
help_text="通讯录/显示名",
)
employee_no = models.CharField(
max_length=30,
null=True,
blank=True,
unique=True,
verbose_name="员工工号",
help_text="系统自动生成或手动录入",
)
role = models.CharField(
max_length=30,
choices=StaffRole.choices,
verbose_name="系统角色",
help_text="agent=经纪人 / store_manager=店长 / area_manager=区域经理 / admin=管理员 / operator=运营 / system=系统账号",
)
job_title = models.CharField(
max_length=100,
blank=True,
default="",
verbose_name="职务名称",
help_text='如「高级业务员」',
)
name = models.CharField(max_length=50)
nickname = models.CharField(max_length=50, blank=True, default="")
employee_no = models.CharField(max_length=30, null=True, blank=True, unique=True)
role = models.CharField(max_length=30, choices=StaffRole.choices)
job_title = models.CharField(max_length=100, blank=True, default="")
job_category = models.CharField(
max_length=50,
blank=True,
default="",
help_text="Job classification (e.g. '置业顾问' = agent qualification flag).",
verbose_name="职务类别",
help_text='如「置业顾问」(经纪人判定字段)',
)
job_level = models.SmallIntegerField(
null=True,
blank=True,
verbose_name="职级",
)
job_level = models.SmallIntegerField(null=True, blank=True)
supervisor = models.ForeignKey(
"self",
null=True,
blank=True,
on_delete=models.SET_NULL,
related_name="subordinates",
verbose_name="直属上级",
)
status = models.CharField(
max_length=20,
choices=StaffStatus.choices,
default=StaffStatus.ACTIVE,
verbose_name="员工状态",
help_text="active=在职 / probation=试用期 / resigned=已离职 / frozen=账号冻结",
)
phone_enc = models.BinaryField(
null=True,
blank=True,
help_text="AES-256-GCM encrypted phone (DATA_MODEL_ORG §3.2).",
verbose_name="手机号(加密)",
help_text="AES-256-GCM 加密手机号",
)
phone_hash = models.CharField(
max_length=64,
null=True,
blank=True,
db_index=True,
verbose_name="手机号哈希",
help_text="SHA-256 哈希,用于唯一性索引",
)
phone_hide = models.BooleanField(
default=False,
verbose_name="通讯录隐藏手机号",
)
email = models.EmailField(
max_length=255,
blank=True,
default="",
verbose_name="邮箱",
)
extension = models.CharField(
max_length=20,
blank=True,
default="",
verbose_name="分机号",
)
avatar_key = models.TextField(
blank=True,
default="",
verbose_name="头像存储路径",
help_text="R2/S3 头像路径",
)
is_active = models.BooleanField(
default=True,
verbose_name="是否启用",
help_text="FALSE 时账号不可登录(联动 auth_user.is_active",
)
is_system_admin = models.BooleanField(
default=False,
verbose_name="是否系统管理员",
help_text="影响权限上限",
)
first_joined_at = models.DateField(
null=True,
blank=True,
verbose_name="首次入职日期",
help_text="计算工龄起点",
)
rejoined_at = models.DateField(
null=True,
blank=True,
verbose_name="最近复职日期",
)
resigned_at = models.DateField(
null=True,
blank=True,
verbose_name="最近离职日期",
)
joined_count = models.SmallIntegerField(
default=1,
verbose_name="累计入职次数",
)
industry_exp_years = models.SmallIntegerField(
null=True,
blank=True,
verbose_name="行业经验",
help_text="单位:年",
)
phone_hash = models.CharField(max_length=64, null=True, blank=True, db_index=True)
phone_hide = models.BooleanField(default=False)
email = models.EmailField(max_length=255, blank=True, default="")
extension = models.CharField(max_length=20, blank=True, default="")
avatar_key = models.TextField(blank=True, default="")
is_active = models.BooleanField(default=True)
is_system_admin = models.BooleanField(default=False)
first_joined_at = models.DateField(null=True, blank=True)
rejoined_at = models.DateField(null=True, blank=True)
resigned_at = models.DateField(null=True, blank=True)
joined_count = models.SmallIntegerField(default=1)
industry_exp_years = models.SmallIntegerField(null=True, blank=True)
mentor = models.ForeignKey(
"self",
null=True,
blank=True,
on_delete=models.SET_NULL,
related_name="mentees",
verbose_name="师傅",
help_text="带教员工",
)
business_type = models.CharField(
max_length=50,
blank=True,
default="",
verbose_name="业务类型",
)
bank_name = models.CharField(
max_length=100,
blank=True,
default="",
verbose_name="银行名称",
)
bank_account = models.CharField(
max_length=50,
blank=True,
default="",
verbose_name="银行卡号",
help_text="内部财务用",
)
partner_no = models.CharField(
max_length=50,
blank=True,
default="",
verbose_name="联号",
)
business_type = models.CharField(max_length=50, blank=True, default="")
bank_name = models.CharField(max_length=100, blank=True, default="")
bank_account = models.CharField(max_length=50, blank=True, default="")
partner_no = models.CharField(max_length=50, blank=True, default="")
recruit_by = models.ForeignKey(
"self",
null=True,
blank=True,
on_delete=models.SET_NULL,
related_name="recruited_staff",
verbose_name="招聘人",
)
recruit_source = models.CharField(
max_length=50,
blank=True,
default="",
verbose_name="招聘来源",
)
recruit_source = models.CharField(max_length=50, blank=True, default="")
referrer = models.ForeignKey(
"self",
null=True,
blank=True,
on_delete=models.SET_NULL,
related_name="referred_staff",
verbose_name="转介人",
)
class Meta:
@@ -107,33 +231,132 @@ class StaffPersonalInfo(models.Model):
on_delete=models.CASCADE,
related_name="personal_info",
primary_key=True,
verbose_name="所属员工",
)
gender = models.CharField(
max_length=10,
choices=StaffGender.choices,
blank=True,
default="",
verbose_name="性别",
help_text="male=男 / female=女 / unknown=未知",
)
id_type = models.CharField(
max_length=20,
choices=StaffIdType.choices,
blank=True,
default="",
verbose_name="证件类型",
help_text="id_card=身份证 / passport=护照 / other=其他",
)
id_number_enc = models.BinaryField(
null=True,
blank=True,
verbose_name="证件号码(加密)",
help_text="AES 加密",
)
id_number_hash = models.CharField(
max_length=64,
null=True,
blank=True,
db_index=True,
verbose_name="证件号码哈希",
help_text="SHA-256 哈希,实名认证比对用",
)
id_verified = models.BooleanField(
default=False,
verbose_name="是否实名认证",
)
id_verified_at = models.DateTimeField(
null=True,
blank=True,
verbose_name="认证时间",
)
birthdate = models.DateField(
null=True,
blank=True,
verbose_name="出生日期",
)
native_place = models.CharField(
max_length=100,
blank=True,
default="",
verbose_name="籍贯",
)
domicile_type = models.CharField(
max_length=20,
blank=True,
default="",
verbose_name="户籍性质",
)
marital_status = models.CharField(
max_length=20,
blank=True,
default="",
verbose_name="婚姻状况",
)
political_status = models.CharField(
max_length=20,
blank=True,
default="",
verbose_name="政治面貌",
)
has_children = models.BooleanField(
null=True,
blank=True,
verbose_name="有无子女",
)
education_level = models.CharField(
max_length=20,
blank=True,
default="",
verbose_name="最高学历",
)
ethnicity = models.CharField(
max_length=20,
blank=True,
default="",
verbose_name="民族",
)
domicile_address = models.CharField(
max_length=200,
blank=True,
default="",
verbose_name="户口所在地",
)
residence_address = models.CharField(
max_length=200,
blank=True,
default="",
verbose_name="居住地址",
)
work_start_date = models.DateField(
null=True,
blank=True,
verbose_name="参加工作时间",
)
emergency_contact = models.CharField(
max_length=50,
blank=True,
default="",
verbose_name="紧急联系人",
)
emergency_phone_enc = models.BinaryField(
null=True,
blank=True,
verbose_name="紧急联系人电话(加密)",
)
updated_at = models.DateTimeField(
auto_now=True,
verbose_name="最后更新时间",
)
gender = models.CharField(max_length=10, choices=StaffGender.choices, blank=True, default="")
id_type = models.CharField(max_length=20, choices=StaffIdType.choices, blank=True, default="")
id_number_enc = models.BinaryField(null=True, blank=True)
id_number_hash = models.CharField(max_length=64, null=True, blank=True, db_index=True)
id_verified = models.BooleanField(default=False)
id_verified_at = models.DateTimeField(null=True, blank=True)
birthdate = models.DateField(null=True, blank=True)
native_place = models.CharField(max_length=100, blank=True, default="")
domicile_type = models.CharField(max_length=20, blank=True, default="")
marital_status = models.CharField(max_length=20, blank=True, default="")
political_status = models.CharField(max_length=20, blank=True, default="")
has_children = models.BooleanField(null=True, blank=True)
education_level = models.CharField(max_length=20, blank=True, default="")
ethnicity = models.CharField(max_length=20, blank=True, default="")
domicile_address = models.CharField(max_length=200, blank=True, default="")
residence_address = models.CharField(max_length=200, blank=True, default="")
work_start_date = models.DateField(null=True, blank=True)
emergency_contact = models.CharField(max_length=50, blank=True, default="")
emergency_phone_enc = models.BinaryField(null=True, blank=True)
updated_at = models.DateTimeField(auto_now=True)
updated_by = models.ForeignKey(
"org.Staff",
null=True,
blank=True,
on_delete=models.SET_NULL,
related_name="updated_personal_info",
verbose_name="最后修改人",
)
class Meta:

View File

@@ -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: