ishenwei
79c3cf2924
为所有 Django 模型添加 Meta.verbose_name 和 verbose_name_plural（中文表名）， 覆盖 10 个 app 的全部 74 个业务模型。 Phase 4.0 范围： - 仅 Meta 类级别中文名（用于 Django Admin、drf-spectacular OpenAPI title、错误信息） - 字段级 verbose_name= 和 help_text= 留待 Phase 4.1（待 PM 补全 DATA_MODEL 后同步） 变更： - 20 个 models 文件改动（每个模型 +2 行） - 8 个 0002/0003 迁移文件（Meta options 变更） - apps/tenant/migrations/0001_initial.py（之前漏生成的 tenant 模型迁移） manage.py check: 0 issues。
205 lines
7.5 KiB
Python
205 lines
7.5 KiB
Python
from django.db import models
|
|
|
|
from core.enums import (
|
|
PropertyCommissionAttachmentCategory,
|
|
PropertyCommissionOwnerType,
|
|
PropertyCommissionStatus,
|
|
PropertyListingHistoryStatus,
|
|
PropertyListingType,
|
|
PropertyNumberHolderApprovalStatus,
|
|
)
|
|
from core.models.base import TimeStampedModel, UUIDPrimaryKeyModel
|
|
|
|
|
|
class ListingHistory(UUIDPrimaryKeyModel):
|
|
property = models.ForeignKey(
|
|
"fonrey_property.Property",
|
|
on_delete=models.RESTRICT,
|
|
related_name="listing_histories",
|
|
)
|
|
listing_type = models.CharField(max_length=20, choices=PropertyListingType.choices)
|
|
status = models.CharField(
|
|
max_length=10,
|
|
choices=PropertyListingHistoryStatus.choices,
|
|
default=PropertyListingHistoryStatus.ACTIVE,
|
|
)
|
|
|
|
sale_price = models.DecimalField(max_digits=12, decimal_places=2, null=True, blank=True)
|
|
rent_price = models.DecimalField(max_digits=10, decimal_places=2, null=True, blank=True)
|
|
sale_unit_price = models.DecimalField(max_digits=10, decimal_places=2, null=True, blank=True)
|
|
|
|
ownership_years = models.CharField(max_length=30, blank=True, default="")
|
|
is_only_house = models.BooleanField(null=True, blank=True)
|
|
tax_included = models.CharField(max_length=15, blank=True, default="")
|
|
sale_reason = models.TextField(blank=True, default="")
|
|
|
|
seller_agent = models.ForeignKey(
|
|
"org.Staff", null=True, blank=True, on_delete=models.SET_NULL
|
|
)
|
|
seller_agent_snapshot = models.JSONField(null=True, blank=True)
|
|
|
|
started_at = models.DateTimeField(auto_now_add=False)
|
|
ended_at = models.DateTimeField(null=True, blank=True)
|
|
created_at = models.DateTimeField(auto_now_add=True)
|
|
|
|
class Meta:
|
|
db_table = "listing_histories"
|
|
verbose_name = "挂牌历史"
|
|
verbose_name_plural = "挂牌历史"
|
|
indexes = [
|
|
models.Index(fields=["property"], name="idx_lh_property"),
|
|
models.Index(fields=["property", "status"], name="idx_lh_active"),
|
|
]
|
|
|
|
|
|
class PriceChange(UUIDPrimaryKeyModel):
|
|
property = models.ForeignKey(
|
|
"fonrey_property.Property", on_delete=models.RESTRICT, related_name="price_changes"
|
|
)
|
|
old_sale_price = models.DecimalField(max_digits=12, decimal_places=2, null=True, blank=True)
|
|
new_sale_price = models.DecimalField(max_digits=12, decimal_places=2, null=True, blank=True)
|
|
old_bottom_price = models.DecimalField(max_digits=12, decimal_places=2, null=True, blank=True)
|
|
new_bottom_price = models.DecimalField(max_digits=12, decimal_places=2, null=True, blank=True)
|
|
old_record_price = models.DecimalField(max_digits=12, decimal_places=2, null=True, blank=True)
|
|
new_record_price = models.DecimalField(max_digits=12, decimal_places=2, null=True, blank=True)
|
|
old_rent_price = models.DecimalField(max_digits=10, decimal_places=2, null=True, blank=True)
|
|
new_rent_price = models.DecimalField(max_digits=10, decimal_places=2, null=True, blank=True)
|
|
|
|
change_reason = models.TextField()
|
|
changed_at = models.DateTimeField(auto_now_add=True)
|
|
changed_by = models.ForeignKey("org.Staff", on_delete=models.RESTRICT)
|
|
|
|
class Meta:
|
|
db_table = "price_changes"
|
|
verbose_name = "调价记录"
|
|
verbose_name_plural = "调价记录"
|
|
indexes = [
|
|
models.Index(fields=["property"], name="idx_pchg_property"),
|
|
models.Index(fields=["property", "-changed_at"], name="idx_pchg_time"),
|
|
]
|
|
|
|
|
|
class Commission(TimeStampedModel):
|
|
property = models.ForeignKey(
|
|
"fonrey_property.Property", on_delete=models.CASCADE, related_name="commissions"
|
|
)
|
|
commission_type = models.CharField(max_length=50)
|
|
period_start = models.DateField()
|
|
period_end = models.DateField(null=True, blank=True)
|
|
is_open_ended = models.BooleanField(default=False)
|
|
|
|
agent = models.ForeignKey(
|
|
"org.Staff",
|
|
null=True,
|
|
blank=True,
|
|
on_delete=models.SET_NULL,
|
|
related_name="commissions_as_agent",
|
|
)
|
|
agent_snapshot = models.JSONField(null=True, blank=True)
|
|
|
|
signing_method = models.CharField(max_length=50, blank=True, default="")
|
|
|
|
owner_type = models.CharField(
|
|
max_length=20,
|
|
choices=PropertyCommissionOwnerType.choices,
|
|
default=PropertyCommissionOwnerType.OWNER,
|
|
)
|
|
property_owner_contact = models.ForeignKey(
|
|
"fonrey_property.PropertyContact",
|
|
null=True,
|
|
blank=True,
|
|
on_delete=models.SET_NULL,
|
|
related_name="commissions",
|
|
)
|
|
owner_name = models.CharField(max_length=50, blank=True, default="")
|
|
owner_id_type = models.CharField(max_length=20, blank=True, default="")
|
|
owner_id_number = models.CharField(max_length=50, blank=True, default="")
|
|
owner_id_number_enc = models.BinaryField(null=True, blank=True)
|
|
|
|
remarks = models.TextField(blank=True, default="")
|
|
|
|
status = models.CharField(
|
|
max_length=20,
|
|
choices=PropertyCommissionStatus.choices,
|
|
default=PropertyCommissionStatus.ACTIVE,
|
|
)
|
|
|
|
created_by = models.ForeignKey(
|
|
"org.Staff",
|
|
null=True,
|
|
blank=True,
|
|
on_delete=models.SET_NULL,
|
|
related_name="created_commissions",
|
|
)
|
|
|
|
class Meta:
|
|
db_table = "commissions"
|
|
verbose_name = "委托管理"
|
|
verbose_name_plural = "委托管理"
|
|
indexes = [
|
|
models.Index(fields=["property"], name="idx_commissions_property"),
|
|
models.Index(fields=["property", "status"], name="idx_commissions_active"),
|
|
]
|
|
|
|
|
|
class CommissionAttachment(UUIDPrimaryKeyModel):
|
|
commission = models.ForeignKey(
|
|
Commission, on_delete=models.CASCADE, related_name="attachments"
|
|
)
|
|
category = models.CharField(
|
|
max_length=20, choices=PropertyCommissionAttachmentCategory.choices
|
|
)
|
|
file_key = models.TextField()
|
|
file_name = models.CharField(max_length=255)
|
|
file_size = models.IntegerField(null=True, blank=True)
|
|
sort_order = models.SmallIntegerField(default=0)
|
|
created_at = models.DateTimeField(auto_now_add=True)
|
|
|
|
class Meta:
|
|
db_table = "commission_attachments"
|
|
verbose_name = "委托附件"
|
|
verbose_name_plural = "委托附件"
|
|
indexes = [models.Index(fields=["commission"], name="idx_ca_commission")]
|
|
|
|
|
|
class NumberHolderApproval(UUIDPrimaryKeyModel):
|
|
property = models.ForeignKey(
|
|
"fonrey_property.Property",
|
|
on_delete=models.CASCADE,
|
|
related_name="number_holder_approvals",
|
|
)
|
|
contact = models.ForeignKey(
|
|
"fonrey_property.PropertyContact",
|
|
on_delete=models.CASCADE,
|
|
related_name="number_holder_approvals",
|
|
)
|
|
|
|
applicant = models.ForeignKey(
|
|
"org.Staff", on_delete=models.RESTRICT, related_name="nh_applications"
|
|
)
|
|
approver = models.ForeignKey(
|
|
"org.Staff",
|
|
null=True,
|
|
blank=True,
|
|
on_delete=models.SET_NULL,
|
|
related_name="nh_approvals",
|
|
)
|
|
|
|
status = models.CharField(
|
|
max_length=20,
|
|
choices=PropertyNumberHolderApprovalStatus.choices,
|
|
default=PropertyNumberHolderApprovalStatus.PENDING,
|
|
)
|
|
remarks = models.TextField(blank=True, default="")
|
|
created_at = models.DateTimeField(auto_now_add=True)
|
|
decided_at = models.DateTimeField(null=True, blank=True)
|
|
|
|
class Meta:
|
|
db_table = "number_holder_approvals"
|
|
verbose_name = "号码方审批"
|
|
verbose_name_plural = "号码方审批"
|
|
indexes = [
|
|
models.Index(fields=["status"], name="idx_nha_status"),
|
|
models.Index(fields=["property"], name="idx_nha_property"),
|
|
]
|