diff --git a/apps/org/models/org_unit.py b/apps/org/models/org_unit.py index f517ee7..b2470a7 100644 --- a/apps/org/models/org_unit.py +++ b/apps/org/models/org_unit.py @@ -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" diff --git a/apps/org/models/staff.py b/apps/org/models/staff.py index cafa146..284820c 100644 --- a/apps/org/models/staff.py +++ b/apps/org/models/staff.py @@ -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: diff --git a/apps/org/models/staff_logs.py b/apps/org/models/staff_logs.py index 9e223b7..a095a17 100644 --- a/apps/org/models/staff_logs.py +++ b/apps/org/models/staff_logs.py @@ -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: