CRUD Mixin 位于 common/model.py 文件中

主键

我们未提供自动主键模式，而是必须通过手动定义的方式进行主键声明

# 通用 Mapped 类型主键, 需手动添加，参考以下使用方式
# MappedBase -> id: Mapped[id_key]
# DataClassBase && Base -> id: Mapped[id_key] = mapped_column(init=False)
id_key = Annotated[
    int, mapped_column(primary_key=True, index=True, autoincrement=True, sort_order=-999, comment='主键id')
]

日期时间

日期时间 Mixin 将自动集成到 Base 类中，如果模型父类为 Base，将自动应用

class DateTimeMixin(MappedAsDataclass):
    """日期时间 Mixin 数据类"""

    created_time: Mapped[datetime] = mapped_column(
        DateTime(timezone=True), init=False, default_factory=timezone.now, sort_order=999, comment='创建时间'
    )
    updated_time: Mapped[datetime | None] = mapped_column(
        DateTime(timezone=True), init=False, onupdate=timezone.now, sort_order=999, comment='更新时间'
    )

数据类基类

MappedAsDataclass

声明性数据类基类, 它将带有数据类集成, 允许使用更高级配置；此基类适用于不包含日期时间的模型

class DataClassBase(MappedAsDataclass, MappedBase):
    __abstract__ = True

Base 基类

包含基础表结构的数据类基类；此基类适用于大多数模型

class Base(DataClassBase, DateTimeMixin):
    __abstract__ = True