feat: scaffold Django multi-tenant project with 5 of 9 apps
Phase 1 scaffolding: config/, core/, base models, AES-256-GCM phone encryption, enums mirror apps.tenant: Tenant + Domain (django-tenants) apps.org: 11 models (OrgUnit hierarchy, Staff, audit logs) apps.account: 4 models (UserAccount as AUTH_USER_MODEL, login/password tracking) apps.permission: 7 models (RBAC + overrides + datascope + append-only changelog) apps.region: 5 models (District, BusinessArea, MetroLine, MetroStation, School) All migrations generated, manage.py check passes
This commit is contained in:
138
apps/org/models/staff.py
Normal file
138
apps/org/models/staff.py
Normal file
@@ -0,0 +1,138 @@
|
||||
from django.conf import settings
|
||||
from django.db import models
|
||||
|
||||
from core.enums import StaffGender, StaffIdType, StaffRole, StaffStatus
|
||||
from core.models.base import SoftDeleteModel
|
||||
|
||||
|
||||
class Staff(SoftDeleteModel):
|
||||
org_unit = models.ForeignKey(
|
||||
"org.OrgUnit",
|
||||
on_delete=models.RESTRICT,
|
||||
related_name="staff_members",
|
||||
db_index=True,
|
||||
)
|
||||
user = models.OneToOneField(
|
||||
settings.AUTH_USER_MODEL,
|
||||
null=True,
|
||||
blank=True,
|
||||
on_delete=models.SET_NULL,
|
||||
related_name="staff_profile",
|
||||
)
|
||||
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).",
|
||||
)
|
||||
job_level = models.SmallIntegerField(null=True, blank=True)
|
||||
supervisor = models.ForeignKey(
|
||||
"self",
|
||||
null=True,
|
||||
blank=True,
|
||||
on_delete=models.SET_NULL,
|
||||
related_name="subordinates",
|
||||
)
|
||||
status = models.CharField(
|
||||
max_length=20,
|
||||
choices=StaffStatus.choices,
|
||||
default=StaffStatus.ACTIVE,
|
||||
)
|
||||
phone_enc = models.BinaryField(
|
||||
null=True,
|
||||
blank=True,
|
||||
help_text="AES-256-GCM encrypted phone (DATA_MODEL_ORG §3.2).",
|
||||
)
|
||||
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",
|
||||
)
|
||||
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",
|
||||
)
|
||||
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",
|
||||
)
|
||||
|
||||
class Meta:
|
||||
db_table = "staff"
|
||||
indexes = [
|
||||
models.Index(fields=["org_unit"], name="idx_staff_org_unit"),
|
||||
models.Index(fields=["supervisor"], name="idx_staff_supervisor"),
|
||||
models.Index(fields=["status"], name="idx_staff_status"),
|
||||
]
|
||||
|
||||
def __str__(self) -> str:
|
||||
return self.name
|
||||
|
||||
|
||||
class StaffPersonalInfo(models.Model):
|
||||
staff = models.OneToOneField(
|
||||
"org.Staff",
|
||||
on_delete=models.CASCADE,
|
||||
related_name="personal_info",
|
||||
primary_key=True,
|
||||
)
|
||||
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",
|
||||
)
|
||||
|
||||
class Meta:
|
||||
db_table = "staff_personal_info"
|
||||
Reference in New Issue
Block a user