ishenwei
4aba6dfa77
Set up the required directory layout, app scaffolding, core settings, templates, static assets, and Docker/Tailwind tooling to establish a standardized development baseline.
81 lines
2.0 KiB
Python
81 lines
2.0 KiB
Python
import uuid
|
||
|
||
from django.db import models
|
||
from django.utils import timezone
|
||
|
||
|
||
class UUIDPrimaryKeyModel(models.Model):
|
||
"""所有业务模型的根基类：UUID v4 主键"""
|
||
|
||
id = models.UUIDField(primary_key=True, default=uuid.uuid4, editable=False)
|
||
|
||
class Meta:
|
||
abstract = True
|
||
|
||
|
||
class TimeStampedModel(UUIDPrimaryKeyModel):
|
||
"""追加创建/更新时间（TIMESTAMPTZ）"""
|
||
|
||
created_at = models.DateTimeField(auto_now_add=True, db_index=True)
|
||
updated_at = models.DateTimeField(auto_now=True)
|
||
|
||
class Meta:
|
||
abstract = True
|
||
ordering = ["-created_at"]
|
||
|
||
|
||
class ActiveManager(models.Manager):
|
||
"""默认只返回未软删除的记录"""
|
||
|
||
def get_queryset(self):
|
||
return super().get_queryset().filter(deleted_at__isnull=True)
|
||
|
||
|
||
class SoftDeleteModel(TimeStampedModel):
|
||
"""软删除：deleted_at=NULL 表示未删除"""
|
||
|
||
deleted_at = models.DateTimeField(null=True, blank=True, db_index=True)
|
||
objects = ActiveManager()
|
||
all_objects = models.Manager()
|
||
|
||
def delete(self, using=None, keep_parents=False):
|
||
self.deleted_at = timezone.now()
|
||
self.save(update_fields=["deleted_at"])
|
||
|
||
def hard_delete(self):
|
||
super().delete()
|
||
|
||
def restore(self):
|
||
self.deleted_at = None
|
||
self.save(update_fields=["deleted_at"])
|
||
|
||
@property
|
||
def is_deleted(self):
|
||
return self.deleted_at is not None
|
||
|
||
class Meta:
|
||
abstract = True
|
||
|
||
|
||
class AuditedModel(SoftDeleteModel):
|
||
"""审计字段：操作人（FK to Staff，允许 NULL 表示系统操作）"""
|
||
|
||
created_by = models.ForeignKey(
|
||
"org.Staff",
|
||
null=True,
|
||
blank=True,
|
||
on_delete=models.SET_NULL,
|
||
related_name="%(app_label)s_%(class)s_created",
|
||
db_index=True,
|
||
)
|
||
updated_by = models.ForeignKey(
|
||
"org.Staff",
|
||
null=True,
|
||
blank=True,
|
||
on_delete=models.SET_NULL,
|
||
related_name="%(app_label)s_%(class)s_updated",
|
||
)
|
||
|
||
class Meta:
|
||
abstract = True
|