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:
0
apps/org/__init__.py
Normal file
0
apps/org/__init__.py
Normal file
7
apps/org/apps.py
Normal file
7
apps/org/apps.py
Normal file
@@ -0,0 +1,7 @@
|
||||
from django.apps import AppConfig
|
||||
|
||||
|
||||
class OrgConfig(AppConfig):
|
||||
default_auto_field = "django.db.models.BigAutoField"
|
||||
name = "apps.org"
|
||||
label = "org"
|
||||
300
apps/org/migrations/0001_initial.py
Normal file
300
apps/org/migrations/0001_initial.py
Normal file
@@ -0,0 +1,300 @@
|
||||
# Generated by Django 4.2.16 on 2026-04-29 08:42
|
||||
|
||||
from django.conf import settings
|
||||
from django.db import migrations, models
|
||||
import django.db.models.deletion
|
||||
import uuid
|
||||
|
||||
|
||||
class Migration(migrations.Migration):
|
||||
|
||||
initial = True
|
||||
|
||||
dependencies = [
|
||||
migrations.swappable_dependency(settings.AUTH_USER_MODEL),
|
||||
]
|
||||
|
||||
operations = [
|
||||
migrations.CreateModel(
|
||||
name='OrgUnit',
|
||||
fields=[
|
||||
('id', models.UUIDField(default=uuid.uuid4, editable=False, primary_key=True, serialize=False)),
|
||||
('created_at', models.DateTimeField(auto_now_add=True, db_index=True)),
|
||||
('updated_at', models.DateTimeField(auto_now=True)),
|
||||
('deleted_at', models.DateTimeField(blank=True, db_index=True, null=True)),
|
||||
('name', models.CharField(max_length=100)),
|
||||
('type', models.CharField(choices=[('company', '公司'), ('division', '事业部'), ('region', '大区'), ('area', '区域'), ('district', '片区'), ('store', '门店'), ('group', '店组'), ('functional', '职能部门')], max_length=20)),
|
||||
('path', models.TextField(help_text='Materialized path: /root_id/.../self_id/ for subtree queries.')),
|
||||
('depth', models.SmallIntegerField(default=0)),
|
||||
('sort_order', models.IntegerField(default=0)),
|
||||
('attribute', models.CharField(blank=True, choices=[('direct', '直营'), ('franchise', '加盟')], max_length=10, null=True)),
|
||||
('address_city', models.CharField(blank=True, default='', max_length=50)),
|
||||
('address_district', models.CharField(blank=True, default='', max_length=50)),
|
||||
('address_detail', models.CharField(blank=True, default='', max_length=200)),
|
||||
('latitude', models.DecimalField(blank=True, decimal_places=7, max_digits=10, null=True)),
|
||||
('longitude', models.DecimalField(blank=True, decimal_places=7, max_digits=10, null=True)),
|
||||
('established_at', models.DateField(blank=True, null=True)),
|
||||
('phone', models.CharField(blank=True, default='', max_length=30)),
|
||||
('ext_start', models.IntegerField(blank=True, null=True)),
|
||||
('ext_end', models.IntegerField(blank=True, null=True)),
|
||||
('is_active', models.BooleanField(default=True)),
|
||||
],
|
||||
options={
|
||||
'db_table': 'org_units',
|
||||
'ordering': ['sort_order', 'name'],
|
||||
},
|
||||
),
|
||||
migrations.CreateModel(
|
||||
name='Staff',
|
||||
fields=[
|
||||
('id', models.UUIDField(default=uuid.uuid4, editable=False, primary_key=True, serialize=False)),
|
||||
('created_at', models.DateTimeField(auto_now_add=True, db_index=True)),
|
||||
('updated_at', models.DateTimeField(auto_now=True)),
|
||||
('deleted_at', models.DateTimeField(blank=True, db_index=True, null=True)),
|
||||
('name', models.CharField(max_length=50)),
|
||||
('nickname', models.CharField(blank=True, default='', max_length=50)),
|
||||
('employee_no', models.CharField(blank=True, max_length=30, null=True, unique=True)),
|
||||
('role', models.CharField(choices=[('agent', '经纪人'), ('store_manager', '店长'), ('area_manager', '区域经理'), ('admin', '系统管理员'), ('operator', '运营/行政'), ('system', '系统账号')], max_length=30)),
|
||||
('job_title', models.CharField(blank=True, default='', max_length=100)),
|
||||
('job_category', models.CharField(blank=True, default='', help_text="Job classification (e.g. '置业顾问' = agent qualification flag).", max_length=50)),
|
||||
('job_level', models.SmallIntegerField(blank=True, null=True)),
|
||||
('status', models.CharField(choices=[('active', '在职'), ('probation', '试用'), ('resigned', '离职'), ('frozen', '冻结')], default='active', max_length=20)),
|
||||
('phone_enc', models.BinaryField(blank=True, help_text='AES-256-GCM encrypted phone (DATA_MODEL_ORG §3.2).', null=True)),
|
||||
('phone_hash', models.CharField(blank=True, db_index=True, max_length=64, null=True)),
|
||||
('phone_hide', models.BooleanField(default=False)),
|
||||
('email', models.EmailField(blank=True, default='', max_length=255)),
|
||||
('extension', models.CharField(blank=True, default='', max_length=20)),
|
||||
('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(blank=True, null=True)),
|
||||
('rejoined_at', models.DateField(blank=True, null=True)),
|
||||
('resigned_at', models.DateField(blank=True, null=True)),
|
||||
('joined_count', models.SmallIntegerField(default=1)),
|
||||
('industry_exp_years', models.SmallIntegerField(blank=True, null=True)),
|
||||
('business_type', models.CharField(blank=True, default='', max_length=50)),
|
||||
('bank_name', models.CharField(blank=True, default='', max_length=100)),
|
||||
('bank_account', models.CharField(blank=True, default='', max_length=50)),
|
||||
('partner_no', models.CharField(blank=True, default='', max_length=50)),
|
||||
('recruit_source', models.CharField(blank=True, default='', max_length=50)),
|
||||
('mentor', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='mentees', to='org.staff')),
|
||||
('org_unit', models.ForeignKey(on_delete=django.db.models.deletion.RESTRICT, related_name='staff_members', to='org.orgunit')),
|
||||
('recruit_by', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='recruited_staff', to='org.staff')),
|
||||
('referrer', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='referred_staff', to='org.staff')),
|
||||
('supervisor', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='subordinates', to='org.staff')),
|
||||
('user', models.OneToOneField(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='staff_profile', to=settings.AUTH_USER_MODEL)),
|
||||
],
|
||||
options={
|
||||
'db_table': 'staff',
|
||||
},
|
||||
),
|
||||
migrations.CreateModel(
|
||||
name='StaffWorkExperience',
|
||||
fields=[
|
||||
('id', models.UUIDField(default=uuid.uuid4, editable=False, primary_key=True, serialize=False)),
|
||||
('created_at', models.DateTimeField(auto_now_add=True, db_index=True)),
|
||||
('updated_at', models.DateTimeField(auto_now=True)),
|
||||
('company', models.CharField(max_length=200)),
|
||||
('job_title', models.CharField(blank=True, default='', max_length=100)),
|
||||
('start_date', models.DateField(blank=True, null=True)),
|
||||
('end_date', models.DateField(blank=True, null=True)),
|
||||
('reason', models.CharField(blank=True, default='', max_length=200)),
|
||||
('reference_name', models.CharField(blank=True, default='', max_length=50)),
|
||||
('reference_phone', models.CharField(blank=True, default='', max_length=30)),
|
||||
('staff', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='work_experiences', to='org.staff')),
|
||||
],
|
||||
options={
|
||||
'db_table': 'staff_work_experiences',
|
||||
},
|
||||
),
|
||||
migrations.CreateModel(
|
||||
name='StaffTraining',
|
||||
fields=[
|
||||
('id', models.UUIDField(default=uuid.uuid4, editable=False, primary_key=True, serialize=False)),
|
||||
('created_at', models.DateTimeField(auto_now_add=True, db_index=True)),
|
||||
('updated_at', models.DateTimeField(auto_now=True)),
|
||||
('training_name', models.CharField(max_length=200)),
|
||||
('training_date', models.DateField(blank=True, null=True)),
|
||||
('certificate', models.CharField(blank=True, default='', max_length=200)),
|
||||
('staff', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='trainings', to='org.staff')),
|
||||
],
|
||||
options={
|
||||
'db_table': 'staff_trainings',
|
||||
},
|
||||
),
|
||||
migrations.CreateModel(
|
||||
name='StaffRewardPunish',
|
||||
fields=[
|
||||
('id', models.UUIDField(default=uuid.uuid4, editable=False, primary_key=True, serialize=False)),
|
||||
('created_at', models.DateTimeField(auto_now_add=True, db_index=True)),
|
||||
('updated_at', models.DateTimeField(auto_now=True)),
|
||||
('deleted_at', models.DateTimeField(blank=True, db_index=True, null=True)),
|
||||
('rp_date', models.DateField()),
|
||||
('category', models.CharField(help_text='Configurable lookup_items domain: org.reward_punish_category.', max_length=50)),
|
||||
('name', models.CharField(max_length=100)),
|
||||
('remarks', models.TextField(blank=True, default='')),
|
||||
('created_by', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='created_reward_punish', to='org.staff')),
|
||||
('staff', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='reward_punish_records', to='org.staff')),
|
||||
],
|
||||
options={
|
||||
'db_table': 'staff_reward_punish',
|
||||
},
|
||||
),
|
||||
migrations.CreateModel(
|
||||
name='StaffRemark',
|
||||
fields=[
|
||||
('id', models.UUIDField(default=uuid.uuid4, editable=False, primary_key=True, serialize=False)),
|
||||
('created_at', models.DateTimeField(auto_now_add=True, db_index=True)),
|
||||
('updated_at', models.DateTimeField(auto_now=True)),
|
||||
('deleted_at', models.DateTimeField(blank=True, db_index=True, null=True)),
|
||||
('content', models.TextField()),
|
||||
('created_by', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='created_remarks', to='org.staff')),
|
||||
('staff', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='remarks', to='org.staff')),
|
||||
],
|
||||
options={
|
||||
'db_table': 'staff_remarks',
|
||||
},
|
||||
),
|
||||
migrations.CreateModel(
|
||||
name='StaffFamilyMember',
|
||||
fields=[
|
||||
('id', models.UUIDField(default=uuid.uuid4, editable=False, primary_key=True, serialize=False)),
|
||||
('created_at', models.DateTimeField(auto_now_add=True, db_index=True)),
|
||||
('updated_at', models.DateTimeField(auto_now=True)),
|
||||
('relation', models.CharField(max_length=30)),
|
||||
('name', models.CharField(max_length=50)),
|
||||
('birthdate', models.DateField(blank=True, null=True)),
|
||||
('occupation', models.CharField(blank=True, default='', max_length=100)),
|
||||
('work_unit', models.CharField(blank=True, default='', max_length=200)),
|
||||
('phone_enc', models.BinaryField(blank=True, null=True)),
|
||||
('staff', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='family_members', to='org.staff')),
|
||||
],
|
||||
options={
|
||||
'db_table': 'staff_family_members',
|
||||
},
|
||||
),
|
||||
migrations.CreateModel(
|
||||
name='StaffEducation',
|
||||
fields=[
|
||||
('id', models.UUIDField(default=uuid.uuid4, editable=False, primary_key=True, serialize=False)),
|
||||
('created_at', models.DateTimeField(auto_now_add=True, db_index=True)),
|
||||
('updated_at', models.DateTimeField(auto_now=True)),
|
||||
('stage', models.CharField(blank=True, default='', max_length=30)),
|
||||
('school', models.CharField(max_length=200)),
|
||||
('major', models.CharField(blank=True, default='', max_length=100)),
|
||||
('start_date', models.DateField(blank=True, null=True)),
|
||||
('end_date', models.DateField(blank=True, null=True)),
|
||||
('enrollment_status', models.CharField(blank=True, default='', max_length=30)),
|
||||
('degree', models.CharField(blank=True, default='', max_length=30)),
|
||||
('staff', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='educations', to='org.staff')),
|
||||
],
|
||||
options={
|
||||
'db_table': 'staff_educations',
|
||||
},
|
||||
),
|
||||
migrations.CreateModel(
|
||||
name='StaffAccount',
|
||||
fields=[
|
||||
('id', models.UUIDField(default=uuid.uuid4, editable=False, primary_key=True, serialize=False)),
|
||||
('created_at', models.DateTimeField(auto_now_add=True, db_index=True)),
|
||||
('updated_at', models.DateTimeField(auto_now=True)),
|
||||
('platform', models.CharField(choices=[('fonrey', '房睿主账号'), ('58anjuke', '58安居客'), ('cnreic', '中国网络经纪人'), ('wechat_mp', '微信公众号')], max_length=30)),
|
||||
('account_no', models.CharField(blank=True, default='', max_length=100)),
|
||||
('is_real_name_match', models.BooleanField(blank=True, null=True)),
|
||||
('is_bound', models.BooleanField(default=False)),
|
||||
('bound_at', models.DateTimeField(blank=True, null=True)),
|
||||
('staff', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='external_accounts', to='org.staff')),
|
||||
],
|
||||
options={
|
||||
'db_table': 'staff_accounts',
|
||||
},
|
||||
),
|
||||
migrations.AddField(
|
||||
model_name='orgunit',
|
||||
name='manager',
|
||||
field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='managed_org_units', to='org.staff'),
|
||||
),
|
||||
migrations.AddField(
|
||||
model_name='orgunit',
|
||||
name='parent',
|
||||
field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.RESTRICT, related_name='children', to='org.orgunit'),
|
||||
),
|
||||
migrations.CreateModel(
|
||||
name='StaffTransferLog',
|
||||
fields=[
|
||||
('id', models.UUIDField(default=uuid.uuid4, editable=False, primary_key=True, serialize=False)),
|
||||
('created_at', models.DateTimeField(auto_now_add=True, db_index=True)),
|
||||
('updated_at', models.DateTimeField(auto_now=True)),
|
||||
('transfer_type', models.CharField(choices=[('onboard', '入职'), ('transfer', '调动'), ('resign', '离职'), ('rejoin', '复职'), ('supervisor_change', '上级变更'), ('role_change', '角色变更'), ('freeze', '冻结账号'), ('unfreeze', '恢复账号')], max_length=30)),
|
||||
('old_value', models.JSONField(blank=True, null=True)),
|
||||
('new_value', models.JSONField(blank=True, null=True)),
|
||||
('transfer_date', models.DateField()),
|
||||
('remarks', models.CharField(blank=True, default='', max_length=50)),
|
||||
('operated_at', models.DateTimeField(auto_now_add=True)),
|
||||
('operator', models.ForeignKey(on_delete=django.db.models.deletion.RESTRICT, related_name='operated_transfers', to='org.staff')),
|
||||
('staff', models.ForeignKey(on_delete=django.db.models.deletion.RESTRICT, related_name='transfer_logs', to='org.staff')),
|
||||
],
|
||||
options={
|
||||
'db_table': 'staff_transfer_logs',
|
||||
'indexes': [models.Index(fields=['staff', '-transfer_date'], name='idx_transfer_logs_staff'), models.Index(fields=['transfer_type', '-operated_at'], name='idx_transfer_logs_type'), models.Index(fields=['operator'], name='idx_transfer_logs_operator')],
|
||||
},
|
||||
),
|
||||
migrations.CreateModel(
|
||||
name='StaffPersonalInfo',
|
||||
fields=[
|
||||
('staff', models.OneToOneField(on_delete=django.db.models.deletion.CASCADE, primary_key=True, related_name='personal_info', serialize=False, to='org.staff')),
|
||||
('gender', models.CharField(blank=True, choices=[('male', '男'), ('female', '女'), ('unknown', '未知')], default='', max_length=10)),
|
||||
('id_type', models.CharField(blank=True, choices=[('id_card', '身份证'), ('passport', '护照'), ('other', '其他')], default='', max_length=20)),
|
||||
('id_number_enc', models.BinaryField(blank=True, null=True)),
|
||||
('id_number_hash', models.CharField(blank=True, db_index=True, max_length=64, null=True)),
|
||||
('id_verified', models.BooleanField(default=False)),
|
||||
('id_verified_at', models.DateTimeField(blank=True, null=True)),
|
||||
('birthdate', models.DateField(blank=True, null=True)),
|
||||
('native_place', models.CharField(blank=True, default='', max_length=100)),
|
||||
('domicile_type', models.CharField(blank=True, default='', max_length=20)),
|
||||
('marital_status', models.CharField(blank=True, default='', max_length=20)),
|
||||
('political_status', models.CharField(blank=True, default='', max_length=20)),
|
||||
('has_children', models.BooleanField(blank=True, null=True)),
|
||||
('education_level', models.CharField(blank=True, default='', max_length=20)),
|
||||
('ethnicity', models.CharField(blank=True, default='', max_length=20)),
|
||||
('domicile_address', models.CharField(blank=True, default='', max_length=200)),
|
||||
('residence_address', models.CharField(blank=True, default='', max_length=200)),
|
||||
('work_start_date', models.DateField(blank=True, null=True)),
|
||||
('emergency_contact', models.CharField(blank=True, default='', max_length=50)),
|
||||
('emergency_phone_enc', models.BinaryField(blank=True, null=True)),
|
||||
('updated_at', models.DateTimeField(auto_now=True)),
|
||||
('updated_by', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='updated_personal_info', to='org.staff')),
|
||||
],
|
||||
options={
|
||||
'db_table': 'staff_personal_info',
|
||||
},
|
||||
),
|
||||
migrations.AddConstraint(
|
||||
model_name='staffaccount',
|
||||
constraint=models.UniqueConstraint(fields=('staff', 'platform'), name='uq_staff_accounts_staff_platform'),
|
||||
),
|
||||
migrations.AddIndex(
|
||||
model_name='staff',
|
||||
index=models.Index(fields=['org_unit'], name='idx_staff_org_unit'),
|
||||
),
|
||||
migrations.AddIndex(
|
||||
model_name='staff',
|
||||
index=models.Index(fields=['supervisor'], name='idx_staff_supervisor'),
|
||||
),
|
||||
migrations.AddIndex(
|
||||
model_name='staff',
|
||||
index=models.Index(fields=['status'], name='idx_staff_status'),
|
||||
),
|
||||
migrations.AddIndex(
|
||||
model_name='orgunit',
|
||||
index=models.Index(fields=['parent'], name='idx_org_units_parent'),
|
||||
),
|
||||
migrations.AddIndex(
|
||||
model_name='orgunit',
|
||||
index=models.Index(fields=['type'], name='idx_org_units_type'),
|
||||
),
|
||||
migrations.AddIndex(
|
||||
model_name='orgunit',
|
||||
index=models.Index(fields=['path'], name='idx_org_units_path'),
|
||||
),
|
||||
]
|
||||
0
apps/org/migrations/__init__.py
Normal file
0
apps/org/migrations/__init__.py
Normal file
26
apps/org/models/__init__.py
Normal file
26
apps/org/models/__init__.py
Normal file
@@ -0,0 +1,26 @@
|
||||
from apps.org.models.org_unit import OrgUnit
|
||||
from apps.org.models.staff import Staff, StaffPersonalInfo
|
||||
from apps.org.models.staff_logs import (
|
||||
StaffAccount,
|
||||
StaffEducation,
|
||||
StaffFamilyMember,
|
||||
StaffRemark,
|
||||
StaffRewardPunish,
|
||||
StaffTraining,
|
||||
StaffTransferLog,
|
||||
StaffWorkExperience,
|
||||
)
|
||||
|
||||
__all__ = [
|
||||
"OrgUnit",
|
||||
"Staff",
|
||||
"StaffPersonalInfo",
|
||||
"StaffAccount",
|
||||
"StaffEducation",
|
||||
"StaffFamilyMember",
|
||||
"StaffRemark",
|
||||
"StaffRewardPunish",
|
||||
"StaffTraining",
|
||||
"StaffTransferLog",
|
||||
"StaffWorkExperience",
|
||||
]
|
||||
57
apps/org/models/org_unit.py
Normal file
57
apps/org/models/org_unit.py
Normal file
@@ -0,0 +1,57 @@
|
||||
from django.db import models
|
||||
|
||||
from core.enums import OrgUnitAttribute, OrgUnitType
|
||||
from core.models.base import SoftDeleteModel
|
||||
|
||||
|
||||
class OrgUnit(SoftDeleteModel):
|
||||
name = models.CharField(max_length=100)
|
||||
type = models.CharField(max_length=20, choices=OrgUnitType.choices)
|
||||
parent = models.ForeignKey(
|
||||
"self",
|
||||
null=True,
|
||||
blank=True,
|
||||
on_delete=models.RESTRICT,
|
||||
related_name="children",
|
||||
db_index=True,
|
||||
)
|
||||
path = models.TextField(
|
||||
help_text="Materialized path: /root_id/.../self_id/ for subtree queries.",
|
||||
)
|
||||
depth = models.SmallIntegerField(default=0)
|
||||
sort_order = models.IntegerField(default=0)
|
||||
attribute = models.CharField(
|
||||
max_length=10,
|
||||
choices=OrgUnitAttribute.choices,
|
||||
null=True,
|
||||
blank=True,
|
||||
)
|
||||
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",
|
||||
)
|
||||
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"
|
||||
indexes = [
|
||||
models.Index(fields=["parent"], name="idx_org_units_parent"),
|
||||
models.Index(fields=["type"], name="idx_org_units_type"),
|
||||
models.Index(fields=["path"], name="idx_org_units_path"),
|
||||
]
|
||||
ordering = ["sort_order", "name"]
|
||||
|
||||
def __str__(self) -> str:
|
||||
return f"{self.name} ({self.type})"
|
||||
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"
|
||||
164
apps/org/models/staff_logs.py
Normal file
164
apps/org/models/staff_logs.py
Normal file
@@ -0,0 +1,164 @@
|
||||
from django.db import models
|
||||
|
||||
from core.enums import StaffAccountPlatform, StaffTransferType
|
||||
from core.models.base import SoftDeleteModel, TimeStampedModel
|
||||
|
||||
|
||||
class StaffTransferLog(TimeStampedModel):
|
||||
staff = models.ForeignKey(
|
||||
"org.Staff",
|
||||
on_delete=models.RESTRICT,
|
||||
related_name="transfer_logs",
|
||||
)
|
||||
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",
|
||||
)
|
||||
operated_at = models.DateTimeField(auto_now_add=True)
|
||||
|
||||
class Meta:
|
||||
db_table = "staff_transfer_logs"
|
||||
indexes = [
|
||||
models.Index(fields=["staff", "-transfer_date"], name="idx_transfer_logs_staff"),
|
||||
models.Index(fields=["transfer_type", "-operated_at"], name="idx_transfer_logs_type"),
|
||||
models.Index(fields=["operator"], name="idx_transfer_logs_operator"),
|
||||
]
|
||||
|
||||
|
||||
class StaffRewardPunish(SoftDeleteModel):
|
||||
staff = models.ForeignKey(
|
||||
"org.Staff",
|
||||
on_delete=models.CASCADE,
|
||||
related_name="reward_punish_records",
|
||||
)
|
||||
rp_date = models.DateField()
|
||||
category = models.CharField(
|
||||
max_length=50,
|
||||
help_text="Configurable lookup_items domain: org.reward_punish_category.",
|
||||
)
|
||||
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",
|
||||
)
|
||||
|
||||
class Meta:
|
||||
db_table = "staff_reward_punish"
|
||||
|
||||
|
||||
class StaffAccount(TimeStampedModel):
|
||||
staff = models.ForeignKey(
|
||||
"org.Staff",
|
||||
on_delete=models.CASCADE,
|
||||
related_name="external_accounts",
|
||||
)
|
||||
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"
|
||||
constraints = [
|
||||
models.UniqueConstraint(
|
||||
fields=["staff", "platform"],
|
||||
name="uq_staff_accounts_staff_platform",
|
||||
),
|
||||
]
|
||||
|
||||
|
||||
class StaffWorkExperience(TimeStampedModel):
|
||||
staff = models.ForeignKey(
|
||||
"org.Staff",
|
||||
on_delete=models.CASCADE,
|
||||
related_name="work_experiences",
|
||||
)
|
||||
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"
|
||||
|
||||
|
||||
class StaffEducation(TimeStampedModel):
|
||||
staff = models.ForeignKey(
|
||||
"org.Staff",
|
||||
on_delete=models.CASCADE,
|
||||
related_name="educations",
|
||||
)
|
||||
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"
|
||||
|
||||
|
||||
class StaffTraining(TimeStampedModel):
|
||||
staff = models.ForeignKey(
|
||||
"org.Staff",
|
||||
on_delete=models.CASCADE,
|
||||
related_name="trainings",
|
||||
)
|
||||
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"
|
||||
|
||||
|
||||
class StaffFamilyMember(TimeStampedModel):
|
||||
staff = models.ForeignKey(
|
||||
"org.Staff",
|
||||
on_delete=models.CASCADE,
|
||||
related_name="family_members",
|
||||
)
|
||||
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"
|
||||
|
||||
|
||||
class StaffRemark(SoftDeleteModel):
|
||||
staff = models.ForeignKey(
|
||||
"org.Staff",
|
||||
on_delete=models.CASCADE,
|
||||
related_name="remarks",
|
||||
)
|
||||
content = models.TextField()
|
||||
created_by = models.ForeignKey(
|
||||
"org.Staff",
|
||||
null=True,
|
||||
blank=True,
|
||||
on_delete=models.SET_NULL,
|
||||
related_name="created_remarks",
|
||||
)
|
||||
|
||||
class Meta:
|
||||
db_table = "staff_remarks"
|
||||
0
apps/org/serializers.py
Normal file
0
apps/org/serializers.py
Normal file
0
apps/org/services/__init__.py
Normal file
0
apps/org/services/__init__.py
Normal file
0
apps/org/tasks.py
Normal file
0
apps/org/tasks.py
Normal file
0
apps/org/templates/org/.gitkeep
Normal file
0
apps/org/templates/org/.gitkeep
Normal file
0
apps/org/tests/__init__.py
Normal file
0
apps/org/tests/__init__.py
Normal file
5
apps/org/urls.py
Normal file
5
apps/org/urls.py
Normal file
@@ -0,0 +1,5 @@
|
||||
from django.urls import path
|
||||
|
||||
app_name = "org"
|
||||
|
||||
urlpatterns: list = []
|
||||
0
apps/org/views.py
Normal file
0
apps/org/views.py
Normal file
Reference in New Issue
Block a user