f22d14e439
- TPlusSyncMixin 统一 T+ 同步预留四列（可空+普通索引，唯一键待 IT 定键后升级） - 留痕表实体 ID 无外键冗余固化，删除保护由服务层承担 - init-dev.sql 同步六表 DDL，alembic_version 标记更新 Co-Authored-By: Claude Code <noreply@anthropic.com>
59 lines
2.3 KiB
Python
59 lines
2.3 KiB
Python
"""产品模型：产品主数据。
|
||
|
||
产品类别（product_category）是**折算阈值的行级锚点**：混合业务按产品逐条
|
||
计算（对照表 #14），阈值本身由 M1 参数 `product.threshold` 按 PRODUCT_CATEGORY
|
||
维度承担（#28「全部阈值统一在系统设置维护」），本表不建阈值列 —— 两处维护
|
||
必然漂移。类别值域与 M1 参数维度共用 PRODUCT_CATEGORIES 常量。
|
||
"""
|
||
|
||
from decimal import Decimal
|
||
|
||
from sqlalchemy import Numeric, String, UniqueConstraint
|
||
from sqlalchemy.orm import Mapped, mapped_column
|
||
|
||
from app.models.base import (
|
||
BIGINT_UNSIGNED,
|
||
TINYINT_TYPE,
|
||
Base,
|
||
TimestampMixin,
|
||
TPlusSyncMixin,
|
||
mysql_table_args,
|
||
)
|
||
|
||
|
||
class Product(Base, TimestampMixin, TPlusSyncMixin):
|
||
"""产品表（需求 2.1.2）。停用（status=0）为主，不物理删除。"""
|
||
|
||
__tablename__ = "products"
|
||
__table_args__ = mysql_table_args(
|
||
"产品表（类别锚定折算阈值参数；T+同步不覆盖产品类别）",
|
||
UniqueConstraint("product_name", "spec_model", name="uk_products_name_spec"),
|
||
)
|
||
|
||
id: Mapped[int] = mapped_column(
|
||
BIGINT_UNSIGNED, primary_key=True, autoincrement=True, comment="主键ID"
|
||
)
|
||
product_name: Mapped[str] = mapped_column(String(128), nullable=False, comment="产品名称")
|
||
spec_model: Mapped[str] = mapped_column(
|
||
String(128),
|
||
nullable=False,
|
||
server_default="''",
|
||
comment="规格型号（空串而非 NULL：参与组合唯一键，MySQL 组合索引对 NULL 不去重）",
|
||
)
|
||
unit: Mapped[str | None] = mapped_column(String(16), comment="计量单位")
|
||
stock_quantity: Mapped[Decimal | None] = mapped_column(
|
||
Numeric(14, 2), comment="数量（T+ 同步原样存储，语义待 IT 确认）"
|
||
)
|
||
sale_price: Mapped[Decimal | None] = mapped_column(
|
||
Numeric(14, 4), comment="销售单价（元，T+ 同步）"
|
||
)
|
||
product_category: Mapped[str] = mapped_column(
|
||
String(32),
|
||
nullable=False,
|
||
comment="产品类别：municipal_water市政水利 rail_transit轨道交通（决定折算阈值 30%/20%；T+同步不覆盖）",
|
||
)
|
||
status: Mapped[int] = mapped_column(
|
||
TINYINT_TYPE, nullable=False, server_default="1", comment="状态：1启用 0停用"
|
||
)
|
||
remark: Mapped[str | None] = mapped_column(String(255), comment="备注")
|