八、字段级数据字典与关联关系

本章节是本文的核心：每张商品相关表均按照“字段、类型、约束/索引、业务含义、关联/规则”进行字段级说明。

8.1 kl_goods_category：商品分类表

主要索引/约束：

PRIMARY KEY (id)

UNIQUE KEY uk_category_code (category_code)

KEY idx_parent_id (parent_id)

KEY idx_category_level (category_level)

8.2 kl_goods_brand：商品品牌表

主要索引/约束：

PRIMARY KEY (id)

UNIQUE KEY uk_brand_code (brand_code)

KEY idx_brand_name (brand_name)

8.3 kl_goods_attribute：商品属性定义表

主要索引/约束：

PRIMARY KEY (id)

UNIQUE KEY uk_category_attr_code (category_id, attr_code)

KEY idx_category_id (category_id)

8.4 kl_goods_attribute_value：商品属性可选值表

主要索引/约束：

PRIMARY KEY (id)

UNIQUE KEY uk_attr_value_code (attr_id, value_code)

KEY idx_attr_id (attr_id)

8.5 kl_goods_spu：商品SPU表

主要索引/约束：

PRIMARY KEY (id)

UNIQUE KEY uk_spu_code (spu_code)

KEY idx_category_id (category_id)

KEY idx_brand_id (brand_id)

KEY idx_spu_name (spu_name)

KEY idx_goods_type (goods_type)

8.6 kl_goods_sku：商品SKU表

主要索引/约束：

PRIMARY KEY (id)

UNIQUE KEY uk_sku_code (sku_code)

KEY idx_spu_id (spu_id)

KEY idx_barcode (barcode)

KEY idx_default_sale_unit (default_sale_unit_id)

8.7 kl_goods_sku_attribute：SKU属性值表

主要索引/约束：

PRIMARY KEY (id)

UNIQUE KEY uk_sku_attr (sku_id, attr_id)

KEY idx_spu_id (spu_id)

KEY idx_attr_id (attr_id)

8.8 kl_goods_unit：商品单位表

主要索引/约束：

PRIMARY KEY (id)

UNIQUE KEY uk_unit_code (unit_code)

UNIQUE KEY uk_unit_name (unit_name)

8.9 kl_goods_sku_unit：SKU单位关系表

主要索引/约束：

PRIMARY KEY (id)

UNIQUE KEY uk_sku_unit (sku_id, unit_id)

KEY idx_sku_id (sku_id)

KEY idx_unit_id (unit_id)

KEY idx_sale_unit (sku_id, sale_unit_flag)

KEY idx_purchase_unit (sku_id, purchase_unit_flag)

KEY idx_inventory_unit (sku_id, inventory_unit_flag)

8.10 kl_goods_image：商品图片表

主要索引/约束：

PRIMARY KEY (id)

KEY idx_spu_id (spu_id)

KEY idx_sku_id (sku_id)

8.11 kl_goods_cert：商品资质证照表

主要索引/约束：

PRIMARY KEY (id)

KEY idx_spu_id (spu_id)

KEY idx_sku_id (sku_id)

KEY idx_supplier_id (supplier_id)

KEY idx_valid_end (valid_end)

8.12 kl_goods_city_sale：城市商品销售池表

主要索引/约束：

PRIMARY KEY (id)

UNIQUE KEY uk_city_sku_unit (city_id, sku_id, sale_unit_id)

KEY idx_city_id (city_id)

KEY idx_sku_id (sku_id)

KEY idx_sale_enabled (sale_enabled)

KEY idx_default_warehouse (default_warehouse_id)

8.13 kl_goods_price_city：城市商品价格表

主要索引/约束：

PRIMARY KEY (id)

KEY idx_city_goods_id (city_goods_id)

KEY idx_city_sku_unit (city_id, sku_id, sale_unit_id)

KEY idx_effective_time (effective_start, effective_end)

8.14 kl_goods_supplier_quote：供应商商品报价表

主要索引/约束：

PRIMARY KEY (id)

KEY idx_supplier_id (supplier_id)

KEY idx_city_sku (city_id, sku_id)

KEY idx_warehouse_id (warehouse_id)

KEY idx_effective_time (effective_start, effective_end)

8.15 kl_goods_supplier_quote_history：供应商报价历史表

主要索引/约束：

PRIMARY KEY (id)

KEY idx_quote_id (quote_id)

KEY idx_supplier_sku (supplier_id, sku_id)

8.16 kl_goods_qc_standard：商品质检标准表

主要索引/约束：

PRIMARY KEY (id)

UNIQUE KEY uk_standard_code (standard_code)

KEY idx_category_id (category_id)

KEY idx_spu_id (spu_id)

KEY idx_sku_id (sku_id)

8.17 kl_goods_label_template：商品标签模板表

主要索引/约束：

PRIMARY KEY (id)

UNIQUE KEY uk_template_code (template_code)

8.18 kl_goods_label_print：商品标签打印记录表

主要索引/约束：

PRIMARY KEY (id)

UNIQUE KEY uk_print_code (print_code)

KEY idx_template_id (template_id)

KEY idx_supplier_id (supplier_id)

KEY idx_sku_id (sku_id)

KEY idx_order_item_id (order_item_id)

8.19 kl_goods_substitute：商品替代关系表

主要索引/约束：

PRIMARY KEY (id)

UNIQUE KEY uk_source_substitute_city (city_id, source_sku_id, substitute_sku_id)

KEY idx_source_sku_id (source_sku_id)

KEY idx_substitute_sku_id (substitute_sku_id)

8.20 kl_goods_price_approval：商品调价审批表

主要索引/约束：

PRIMARY KEY (id)

UNIQUE KEY uk_approval_code (approval_code)

KEY idx_price_id (price_id)

KEY idx_sku_id (sku_id)

KEY idx_approval_status (approval_status)

8.21 kl_goods_audit_log：商品审核日志表

主要索引/约束：

PRIMARY KEY (id)

KEY idx_biz_type_id (biz_type, biz_id)

KEY idx_auditor_id (auditor_id)

8.22 kl_goods_status_log：商品状态变更日志表

主要索引/约束：

PRIMARY KEY (id)

KEY idx_biz_type_id (biz_type, biz_id)

KEY idx_operator_id (operator_id)

九、完整MySQL 8.0 DDL推理版

以下DDL可直接作为设计评审和开发建表参考。落地到升鲜宝时建议按现有命名规范、租户字段、审计字段、逻辑删除字段、数据权限字段进行统一调整。

9.1 kl_goods_category

CREATE TABLE kl_goods_category (

    id BIGINT NOT NULL AUTO_INCREMENT COMMENT '分类ID',

    parent_id BIGINT NOT NULL DEFAULT 0 COMMENT '父级分类ID，0表示一级分类',

    category_code VARCHAR(32) NOT NULL COMMENT '分类编码',

    category_name VARCHAR(64) NOT NULL COMMENT '分类名称',

    category_level TINYINT NOT NULL COMMENT '分类层级：1一级 2二级 3三级',

    category_path VARCHAR(255) COMMENT '分类路径，如/1/10/100',

    goods_type TINYINT NOT NULL DEFAULT 1 COMMENT '默认商品类型：1标品 2生鲜非标 3称重品 4冻品 5预售品',

    storage_type TINYINT NOT NULL DEFAULT 1 COMMENT '默认温区：1常温 2冷藏 3冷冻',

    qc_required_flag TINYINT NOT NULL DEFAULT 0 COMMENT '是否需要质检：0否 1是',

    shelf_life_required_flag TINYINT NOT NULL DEFAULT 0 COMMENT '是否需要效期：0否 1是',

    cert_required_flag TINYINT NOT NULL DEFAULT 0 COMMENT '是否需要资质证照：0否 1是',

    sale_after_rule_type TINYINT COMMENT '默认售后规则类型',

    icon_url VARCHAR(255) COMMENT '分类图标',

    sort_no INT NOT NULL DEFAULT 0 COMMENT '排序号',

    enabled_flag TINYINT NOT NULL DEFAULT 1 COMMENT '启用标记：0停用 1启用',

    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',

    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',

    deleted_flag TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记：0否 1是',

    PRIMARY KEY (id),

    UNIQUE KEY uk_category_code (category_code),

    KEY idx_parent_id (parent_id),

    KEY idx_category_level (category_level)

) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='商品分类表';

9.2 kl_goods_brand

CREATE TABLE kl_goods_brand (

    id BIGINT NOT NULL AUTO_INCREMENT COMMENT '品牌ID',

    brand_code VARCHAR(32) NOT NULL COMMENT '品牌编码',

    brand_name VARCHAR(128) NOT NULL COMMENT '品牌名称',

    brand_alias VARCHAR(128) COMMENT '品牌别名',

    logo_url VARCHAR(255) COMMENT '品牌Logo',

    origin_country VARCHAR(64) COMMENT '品牌国家/地区',

    sort_no INT NOT NULL DEFAULT 0 COMMENT '排序号',

    enabled_flag TINYINT NOT NULL DEFAULT 1 COMMENT '启用标记：0停用 1启用',

    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',

    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',

    deleted_flag TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记',

    PRIMARY KEY (id),

    UNIQUE KEY uk_brand_code (brand_code),

    KEY idx_brand_name (brand_name)

) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='商品品牌表';

9.3 kl_goods_attribute

CREATE TABLE kl_goods_attribute (

    id BIGINT NOT NULL AUTO_INCREMENT COMMENT '属性ID',

    category_id BIGINT COMMENT '所属分类ID',

    attr_code VARCHAR(32) NOT NULL COMMENT '属性编码',

    attr_name VARCHAR(64) COMMENT '属性名称',

    attr_type TINYINT COMMENT '属性类型：1规格属性 2参数属性 3履约属性',

    input_type TINYINT COMMENT '录入方式：1手工 2单选 3多选 4数值 5日期',

    required_flag TINYINT NOT NULL DEFAULT 0 COMMENT '是否必填',

    search_flag TINYINT NOT NULL DEFAULT 0 COMMENT '是否作为搜索筛选项',

    sort_no INT NOT NULL DEFAULT 0 COMMENT '排序号',

    enabled_flag TINYINT NOT NULL DEFAULT 1 COMMENT '启用标记',

    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',

    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',

    deleted_flag TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记',

    PRIMARY KEY (id),

    UNIQUE KEY uk_category_attr_code (category_id, attr_code),

    KEY idx_category_id (category_id)

) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='商品属性定义表';

9.4 kl_goods_attribute_value

CREATE TABLE kl_goods_attribute_value (

    id BIGINT NOT NULL AUTO_INCREMENT COMMENT '属性值ID',

    attr_id BIGINT COMMENT '属性ID',

    value_code VARCHAR(32) COMMENT '属性值编码',

    value_name VARCHAR(128) COMMENT '属性值名称',

    sort_no INT NOT NULL DEFAULT 0 COMMENT '排序号',

    enabled_flag TINYINT NOT NULL DEFAULT 1 COMMENT '启用标记',

    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',

    deleted_flag TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记',

    PRIMARY KEY (id),

    UNIQUE KEY uk_attr_value_code (attr_id, value_code),

    KEY idx_attr_id (attr_id)

) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='商品属性可选值表';

9.5 kl_goods_spu

CREATE TABLE kl_goods_spu (

    id BIGINT NOT NULL AUTO_INCREMENT COMMENT 'SPU ID',

    spu_code VARCHAR(32) NOT NULL COMMENT 'SPU编码',

    spu_name VARCHAR(128) NOT NULL COMMENT '商品名称',

    short_name VARCHAR(64) COMMENT '商品简称',

    category_id BIGINT NOT NULL COMMENT '分类ID',

    brand_id BIGINT COMMENT '品牌ID',

    goods_type TINYINT NOT NULL DEFAULT 1 COMMENT '商品类型：1标品 2生鲜非标 3称重品 4冻品 5预售品',

    storage_type TINYINT NOT NULL DEFAULT 1 COMMENT '温区：1常温 2冷藏 3冷冻',

    source_type TINYINT NOT NULL DEFAULT 1 COMMENT '来源：1平台自建 2供应商创建 3系统导入',

    origin_place VARCHAR(128) COMMENT '产地',

    shelf_life_days INT COMMENT '保质期天数',

    shelf_life_unit TINYINT DEFAULT 1 COMMENT '保质期单位：1天 2月 3年',

    batch_required_flag TINYINT NOT NULL DEFAULT 0 COMMENT '是否批次管理',

    shelf_life_required_flag TINYINT NOT NULL DEFAULT 0 COMMENT '是否效期管理',

    weigh_flag TINYINT NOT NULL DEFAULT 0 COMMENT '是否称重商品',

    fresh_flag TINYINT NOT NULL DEFAULT 0 COMMENT '是否生鲜商品',

    cert_required_flag TINYINT NOT NULL DEFAULT 0 COMMENT '是否需要商品资质',

    qc_required_flag TINYINT NOT NULL DEFAULT 0 COMMENT '是否需要质检',

    supplier_quote_flag TINYINT NOT NULL DEFAULT 1 COMMENT '是否允许供应商报价',

    city_sale_flag TINYINT NOT NULL DEFAULT 1 COMMENT '是否允许城市销售',

    description TEXT COMMENT '商品描述',

    main_image_url VARCHAR(255) COMMENT '主图URL',

    audit_status TINYINT NOT NULL DEFAULT 0 COMMENT '审核状态：0待审 1通过 2拒绝 3撤回',

    enabled_flag TINYINT NOT NULL DEFAULT 1 COMMENT '启用标记',

    created_by BIGINT COMMENT '创建人ID',

    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',

    updated_by BIGINT COMMENT '更新人ID',

    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',

    deleted_flag TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记',

    PRIMARY KEY (id),

    UNIQUE KEY uk_spu_code (spu_code),

    KEY idx_category_id (category_id),

    KEY idx_brand_id (brand_id),

    KEY idx_spu_name (spu_name),

    KEY idx_goods_type (goods_type)

) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='商品SPU表';

9.6 kl_goods_sku

CREATE TABLE kl_goods_sku (

    id BIGINT NOT NULL AUTO_INCREMENT COMMENT 'SKU ID',

    spu_id BIGINT NOT NULL COMMENT 'SPU ID',

    sku_code VARCHAR(32) NOT NULL COMMENT 'SKU编码',

    sku_name VARCHAR(128) NOT NULL COMMENT 'SKU名称',

    spec_value VARCHAR(128) COMMENT '规格值',

    package_spec VARCHAR(128) COMMENT '包装规格',

    package_material VARCHAR(64) COMMENT '包装材质',

    package_color VARCHAR(64) COMMENT '包装颜色',

    barcode VARCHAR(64) COMMENT '商品条码',

    external_sku_code VARCHAR(64) COMMENT '外部SKU编码',

    net_weight DECIMAL(18,4) COMMENT '净重',

    gross_weight DECIMAL(18,4) COMMENT '毛重',

    length DECIMAL(18,4) COMMENT '长',

    width DECIMAL(18,4) COMMENT '宽',

    height DECIMAL(18,4) COMMENT '高',

    volume DECIMAL(18,6) COMMENT '体积',

    weight_unit_id BIGINT COMMENT '重量单位ID',

    default_sale_unit_id BIGINT COMMENT '默认销售单位ID',

    default_purchase_unit_id BIGINT COMMENT '默认采购单位ID',

    default_inventory_unit_id BIGINT COMMENT '默认库存单位ID',

    label_required_flag TINYINT NOT NULL DEFAULT 1 COMMENT '是否要求打印商品标签',

    low_temp_label_flag TINYINT NOT NULL DEFAULT 0 COMMENT '是否需要低温标签',

    fragile_flag TINYINT COMMENT '是否易碎',

    enabled_flag TINYINT NOT NULL DEFAULT 1 COMMENT '启用标记',

    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',

    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',

    deleted_flag TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记',

    PRIMARY KEY (id),

    UNIQUE KEY uk_sku_code (sku_code),

    KEY idx_spu_id (spu_id),

    KEY idx_barcode (barcode),

    KEY idx_default_sale_unit (default_sale_unit_id)

) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='商品SKU表';

9.7 kl_goods_sku_attribute

CREATE TABLE kl_goods_sku_attribute (

    id BIGINT NOT NULL AUTO_INCREMENT COMMENT 'SKU属性ID',

    spu_id BIGINT COMMENT 'SPU ID',

    sku_id BIGINT COMMENT 'SKU ID',

    attr_id BIGINT COMMENT '属性ID',

    attr_code VARCHAR(32) COMMENT '属性编码',

    attr_name VARCHAR(64) COMMENT '属性名称',

    attr_value_id BIGINT COMMENT '属性值ID',

    attr_value VARCHAR(128) COMMENT '属性值',

    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',

    deleted_flag TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记',

    PRIMARY KEY (id),

    UNIQUE KEY uk_sku_attr (sku_id, attr_id),

    KEY idx_spu_id (spu_id),

    KEY idx_attr_id (attr_id)

) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='SKU属性值表';

9.8 kl_goods_unit

CREATE TABLE kl_goods_unit (

    id BIGINT NOT NULL AUTO_INCREMENT COMMENT '单位ID',

    unit_code VARCHAR(32) NOT NULL COMMENT '单位编码',

    unit_name VARCHAR(32) NOT NULL COMMENT '单位名称',

    unit_type TINYINT NOT NULL DEFAULT 1 COMMENT '单位类型：1数量 2重量 3体积 4包装',

    precision_scale INT NOT NULL DEFAULT 2 COMMENT '数量小数位',

    standard_flag TINYINT NOT NULL DEFAULT 0 COMMENT '是否标准单位',

    enabled_flag TINYINT NOT NULL DEFAULT 1 COMMENT '启用标记',

    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',

    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',

    deleted_flag TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记',

    PRIMARY KEY (id),

    UNIQUE KEY uk_unit_code (unit_code),

    UNIQUE KEY uk_unit_name (unit_name)

) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='商品单位表';

9.9 kl_goods_sku_unit

CREATE TABLE kl_goods_sku_unit (

    id BIGINT NOT NULL AUTO_INCREMENT COMMENT 'SKU单位关系ID',

    sku_id BIGINT NOT NULL COMMENT 'SKU ID',

    unit_id BIGINT NOT NULL COMMENT '单位ID',

    base_unit_flag TINYINT NOT NULL DEFAULT 0 COMMENT '是否基础单位',

    sale_unit_flag TINYINT NOT NULL DEFAULT 0 COMMENT '是否销售单位',

    purchase_unit_flag TINYINT NOT NULL DEFAULT 0 COMMENT '是否采购单位',

    inventory_unit_flag TINYINT NOT NULL DEFAULT 0 COMMENT '是否库存单位',

    weigh_unit_flag TINYINT NOT NULL DEFAULT 0 COMMENT '是否称重单位',

    conversion_rate DECIMAL(18,6) NOT NULL DEFAULT 1 COMMENT '相对基础单位换算率',

    reverse_conversion_rate DECIMAL(18,6) COMMENT '反向换算率',

    min_order_qty DECIMAL(18,4) COMMENT '最小起订量',

    max_order_qty DECIMAL(18,4) COMMENT '最大订购量',

    order_step_qty DECIMAL(18,4) COMMENT '订购步长',

    enabled_flag TINYINT NOT NULL DEFAULT 1 COMMENT '启用标记',

    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',

    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',

    deleted_flag TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记',

    PRIMARY KEY (id),

    UNIQUE KEY uk_sku_unit (sku_id, unit_id),

    KEY idx_sku_id (sku_id),

    KEY idx_unit_id (unit_id),

    KEY idx_sale_unit (sku_id, sale_unit_flag),

    KEY idx_purchase_unit (sku_id, purchase_unit_flag),

    KEY idx_inventory_unit (sku_id, inventory_unit_flag)

) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='SKU单位关系表';

9.10 kl_goods_image

CREATE TABLE kl_goods_image (

    id BIGINT NOT NULL AUTO_INCREMENT COMMENT '图片ID',

    spu_id BIGINT COMMENT 'SPU ID',

    sku_id BIGINT COMMENT 'SKU ID',

    image_type TINYINT NOT NULL DEFAULT 1 COMMENT '图片类型：1主图 2轮播图 3详情图 4资质图 5包装图',

    image_url VARCHAR(255) NOT NULL COMMENT '图片地址',

    sort_no INT NOT NULL DEFAULT 0 COMMENT '排序号',

    main_flag TINYINT NOT NULL DEFAULT 0 COMMENT '是否主图',

    enabled_flag TINYINT NOT NULL DEFAULT 1 COMMENT '启用标记',

    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',

    deleted_flag TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记',

    PRIMARY KEY (id),

    KEY idx_spu_id (spu_id),

    KEY idx_sku_id (sku_id)

) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='商品图片表';

9.11 kl_goods_cert

CREATE TABLE kl_goods_cert (

    id BIGINT NOT NULL AUTO_INCREMENT COMMENT '资质ID',

    spu_id BIGINT COMMENT 'SPU ID',

    sku_id BIGINT COMMENT 'SKU ID',

    supplier_id BIGINT COMMENT '供应商ID',

    cert_type TINYINT COMMENT '资质类型：1检疫证 2检测报告 3生产许可 4合格证 5其他',

    cert_name VARCHAR(128) COMMENT '资质名称',

    cert_no VARCHAR(128) COMMENT '资质编号',

    file_url VARCHAR(255) COMMENT '文件URL',

    valid_start DATE COMMENT '有效期开始',

    valid_end DATE COMMENT '有效期结束',

    audit_status TINYINT COMMENT '审核状态：0待审 1通过 2拒绝',

    enabled_flag TINYINT NOT NULL DEFAULT 1 COMMENT '启用标记',

    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',

    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',

    deleted_flag TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记',

    PRIMARY KEY (id),

    KEY idx_spu_id (spu_id),

    KEY idx_sku_id (sku_id),

    KEY idx_supplier_id (supplier_id),

    KEY idx_valid_end (valid_end)

) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='商品资质证照表';

9.12 kl_goods_city_sale

CREATE TABLE kl_goods_city_sale (

    id BIGINT NOT NULL AUTO_INCREMENT COMMENT '城市商品ID',

    city_id BIGINT NOT NULL COMMENT '城市ID',

    sku_id BIGINT NOT NULL COMMENT 'SKU ID',

    sale_unit_id BIGINT NOT NULL COMMENT '销售单位ID',

    default_warehouse_id BIGINT COMMENT '默认履约仓库ID',

    sale_enabled TINYINT NOT NULL DEFAULT 1 COMMENT '销售状态：0下架 1上架 2暂停 3售罄 4预售',

    presale_flag TINYINT NOT NULL DEFAULT 0 COMMENT '是否预售',

    stock_display_flag TINYINT NOT NULL DEFAULT 1 COMMENT '是否展示库存',

    stock_deduct_type TINYINT NOT NULL DEFAULT 1 COMMENT '扣库存方式：1下单锁定 2支付锁定 3出库扣减',

    min_order_qty DECIMAL(18,4) COMMENT '最小起订量',

    max_order_qty DECIMAL(18,4) COMMENT '最大限购量',

    order_step_qty DECIMAL(18,4) COMMENT '订购步长',

    sale_start_time DATETIME COMMENT '销售开始时间',

    sale_end_time DATETIME COMMENT '销售结束时间',

    search_keyword VARCHAR(255) COMMENT '搜索关键词',

    sort_no INT NOT NULL DEFAULT 0 COMMENT '排序号',

    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',

    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',

    deleted_flag TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记',

    PRIMARY KEY (id),

    UNIQUE KEY uk_city_sku_unit (city_id, sku_id, sale_unit_id),

    KEY idx_city_id (city_id),

    KEY idx_sku_id (sku_id),

    KEY idx_sale_enabled (sale_enabled),

    KEY idx_default_warehouse (default_warehouse_id)

) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='城市商品销售池表';

9.13 kl_goods_price_city

CREATE TABLE kl_goods_price_city (

    id BIGINT NOT NULL AUTO_INCREMENT COMMENT '价格ID',

    city_goods_id BIGINT NOT NULL COMMENT '城市商品ID',

    city_id BIGINT NOT NULL COMMENT '城市ID',

    sku_id BIGINT NOT NULL COMMENT 'SKU ID',

    sale_unit_id BIGINT NOT NULL COMMENT '销售单位ID',

    cost_price DECIMAL(18,4) NOT NULL DEFAULT 0 COMMENT '成本价',

    sale_price DECIMAL(18,4) NOT NULL COMMENT '销售价',

    market_price DECIMAL(18,4) COMMENT '市场价',

    min_sale_price DECIMAL(18,4) COMMENT '最低售价',

    gross_margin_rate DECIMAL(8,4) COMMENT '毛利率',

    price_type TINYINT NOT NULL DEFAULT 1 COMMENT '价格类型：1基础价 2活动价 3等级价 4协议价',

    effective_start DATETIME NOT NULL COMMENT '生效开始时间',

    effective_end DATETIME COMMENT '生效结束时间',

    approval_status TINYINT NOT NULL DEFAULT 0 COMMENT '审批状态：0待审 1通过 2拒绝',

    enabled_flag TINYINT NOT NULL DEFAULT 1 COMMENT '启用标记',

    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',

    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',

    deleted_flag TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记',

    PRIMARY KEY (id),

    KEY idx_city_goods_id (city_goods_id),

    KEY idx_city_sku_unit (city_id, sku_id, sale_unit_id),

    KEY idx_effective_time (effective_start, effective_end)

) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='城市商品价格表';

9.14 kl_goods_supplier_quote

CREATE TABLE kl_goods_supplier_quote (

    id BIGINT NOT NULL AUTO_INCREMENT COMMENT '供应商报价ID',

    supplier_id BIGINT NOT NULL COMMENT '供应商ID',

    city_id BIGINT NOT NULL COMMENT '服务城市ID',

    warehouse_id BIGINT COMMENT '交货仓库ID',

    sku_id BIGINT NOT NULL COMMENT 'SKU ID',

    supply_unit_id BIGINT NOT NULL COMMENT '供货单位ID',

    quote_price DECIMAL(18,4) NOT NULL COMMENT '供应商报价',

    tax_rate DECIMAL(8,4) COMMENT '税率',

    min_supply_qty DECIMAL(18,4) COMMENT '最小供货量',

    max_supply_qty DECIMAL(18,4) COMMENT '最大供货量',

    daily_capacity_qty DECIMAL(18,4) COMMENT '每日最大供货能力',

    lead_time_hours INT COMMENT '备货提前小时数',

    stockout_rate DECIMAL(8,4) COMMENT '历史缺货率',

    quality_score DECIMAL(8,2) COMMENT '商品质量评分',

    quote_status TINYINT NOT NULL DEFAULT 0 COMMENT '报价状态：0待审 1生效 2拒绝 3失效 4暂停',

    effective_start DATETIME NOT NULL COMMENT '生效开始时间',

    effective_end DATETIME COMMENT '生效结束时间',

    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',

    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',

    deleted_flag TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记',

    PRIMARY KEY (id),

    KEY idx_supplier_id (supplier_id),

    KEY idx_city_sku (city_id, sku_id),

    KEY idx_warehouse_id (warehouse_id),

    KEY idx_effective_time (effective_start, effective_end)

) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='供应商商品报价表';

9.15 kl_goods_supplier_quote_history

CREATE TABLE kl_goods_supplier_quote_history (

    id BIGINT NOT NULL AUTO_INCREMENT COMMENT '历史ID',

    quote_id BIGINT COMMENT '报价ID',

    supplier_id BIGINT COMMENT '供应商ID',

    sku_id BIGINT COMMENT 'SKU ID',

    old_quote_price DECIMAL(18,4) COMMENT '调整前报价',

    new_quote_price DECIMAL(18,4) COMMENT '调整后报价',

    change_reason VARCHAR(255) COMMENT '调整原因',

    operator_id BIGINT COMMENT '操作人ID',

    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',

    PRIMARY KEY (id),

    KEY idx_quote_id (quote_id),

    KEY idx_supplier_sku (supplier_id, sku_id)

) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='供应商报价历史表';

9.16 kl_goods_qc_standard

CREATE TABLE kl_goods_qc_standard (

    id BIGINT NOT NULL AUTO_INCREMENT COMMENT '质检标准ID',

    category_id BIGINT COMMENT '分类ID',

    spu_id BIGINT COMMENT 'SPU ID',

    sku_id BIGINT COMMENT 'SKU ID',

    standard_code VARCHAR(32) NOT NULL COMMENT '标准编码',

    standard_name VARCHAR(128) NOT NULL COMMENT '标准名称',

    standard_level TINYINT NOT NULL DEFAULT 1 COMMENT '标准级别：1分类 2SPU 3SKU',

    storage_type TINYINT COMMENT '适用温区：1常温 2冷藏 3冷冻',

    appearance_required VARCHAR(512) COMMENT '外观要求',

    package_required VARCHAR(512) COMMENT '包装要求',

    label_required VARCHAR(512) COMMENT '标签要求',

    temp_min DECIMAL(8,2) COMMENT '最低温度',

    temp_max DECIMAL(8,2) COMMENT '最高温度',

    weight_tolerance_rate DECIMAL(8,4) COMMENT '重量允许误差比例',

    shelf_life_min_days INT COMMENT '入库最低剩余保质期天数',

    reject_rule VARCHAR(512) COMMENT '拒收规则',

    enabled_flag TINYINT NOT NULL DEFAULT 1 COMMENT '启用标记',

    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',

    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',

    deleted_flag TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记',

    PRIMARY KEY (id),

    UNIQUE KEY uk_standard_code (standard_code),

    KEY idx_category_id (category_id),

    KEY idx_spu_id (spu_id),

    KEY idx_sku_id (sku_id)

) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='商品质检标准表';

9.17 kl_goods_label_template

CREATE TABLE kl_goods_label_template (

    id BIGINT NOT NULL AUTO_INCREMENT COMMENT '标签模板ID',

    template_code VARCHAR(32) NOT NULL COMMENT '模板编码',

    template_name VARCHAR(128) NOT NULL COMMENT '模板名称',

    template_type TINYINT COMMENT '模板类型：1商品标签 2箱标签 3分拣标签 4冷冻标签',

    storage_type TINYINT COMMENT '适用温区',

    template_content TEXT NOT NULL COMMENT '模板内容JSON/HTML',

    width_mm DECIMAL(8,2) COMMENT '宽度mm',

    height_mm DECIMAL(8,2) COMMENT '高度mm',

    low_temp_flag TINYINT NOT NULL DEFAULT 0 COMMENT '是否低温标签',

    enabled_flag TINYINT NOT NULL DEFAULT 1 COMMENT '启用标记',

    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',

    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',

    deleted_flag TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记',

    PRIMARY KEY (id),

    UNIQUE KEY uk_template_code (template_code)

) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='商品标签模板表';

9.18 kl_goods_label_print

CREATE TABLE kl_goods_label_print (

    id BIGINT NOT NULL AUTO_INCREMENT COMMENT '标签打印ID',

    print_code VARCHAR(32) NOT NULL COMMENT '打印批次号',

    template_id BIGINT COMMENT '标签模板ID',

    supplier_id BIGINT COMMENT '供应商ID',

    warehouse_id BIGINT COMMENT '仓库ID',

    fulfill_task_id BIGINT COMMENT '履约任务ID',

    order_id BIGINT COMMENT '订单ID',

    order_item_id BIGINT COMMENT '订单明细ID',

    sku_id BIGINT NOT NULL COMMENT 'SKU ID',

    sku_name VARCHAR(128) NOT NULL COMMENT 'SKU名称',

    spec_value VARCHAR(128) COMMENT '规格',

    quantity DECIMAL(18,4) COMMENT '标签对应数量',

    unit_id BIGINT COMMENT '单位ID',

    qr_code VARCHAR(255) COMMENT '二维码内容',

    barcode VARCHAR(128) COMMENT '条码内容',

    print_status TINYINT NOT NULL DEFAULT 0 COMMENT '打印状态：0待打印 1已打印 2失败',

    print_time DATETIME COMMENT '打印时间',

    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',

    PRIMARY KEY (id),

    UNIQUE KEY uk_print_code (print_code),

    KEY idx_template_id (template_id),

    KEY idx_supplier_id (supplier_id),

    KEY idx_sku_id (sku_id),

    KEY idx_order_item_id (order_item_id)

) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='商品标签打印记录表';

9.19 kl_goods_substitute

CREATE TABLE kl_goods_substitute (

    id BIGINT NOT NULL AUTO_INCREMENT COMMENT '替代商品ID',

    city_id BIGINT COMMENT '城市ID',

    source_sku_id BIGINT NOT NULL COMMENT '原SKU ID',

    substitute_sku_id BIGINT NOT NULL COMMENT '替代SKU ID',

    substitute_level TINYINT NOT NULL DEFAULT 1 COMMENT '替代优先级',

    substitute_type TINYINT COMMENT '替代类型：1同品 2相似 3升级 4降级',

    price_diff_handle_type TINYINT COMMENT '差价处理：1按新价 2原价 3人工确认',

    enabled_flag TINYINT NOT NULL DEFAULT 1 COMMENT '启用标记',

    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',

    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',

    deleted_flag TINYINT NOT NULL DEFAULT 0 COMMENT '删除标记',

    PRIMARY KEY (id),

    UNIQUE KEY uk_source_substitute_city (city_id, source_sku_id, substitute_sku_id),

    KEY idx_source_sku_id (source_sku_id),

    KEY idx_substitute_sku_id (substitute_sku_id)

) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='商品替代关系表';

9.20 kl_goods_price_approval

CREATE TABLE kl_goods_price_approval (

    id BIGINT NOT NULL AUTO_INCREMENT COMMENT '审批ID',

    approval_code VARCHAR(32) NOT NULL COMMENT '审批单号',

    price_id BIGINT COMMENT '价格ID',

    city_goods_id BIGINT COMMENT '城市商品ID',

    sku_id BIGINT COMMENT 'SKU ID',

    old_sale_price DECIMAL(18,4) COMMENT '原销售价',

    new_sale_price DECIMAL(18,4) COMMENT '新销售价',

    old_cost_price DECIMAL(18,4) COMMENT '原成本价',

    new_cost_price DECIMAL(18,4) COMMENT '新成本价',

    reason VARCHAR(512) COMMENT '调价原因',

    approval_status TINYINT COMMENT '审批状态：0待审 1通过 2拒绝 3撤回',

    applicant_id BIGINT COMMENT '申请人ID',

    approver_id BIGINT COMMENT '审批人ID',

    approval_time DATETIME COMMENT '审批时间',

    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',

    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',

    PRIMARY KEY (id),

    UNIQUE KEY uk_approval_code (approval_code),

    KEY idx_price_id (price_id),

    KEY idx_sku_id (sku_id),

    KEY idx_approval_status (approval_status)

) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='商品调价审批表';

9.21 kl_goods_audit_log

CREATE TABLE kl_goods_audit_log (

    id BIGINT NOT NULL AUTO_INCREMENT COMMENT '审核日志ID',

    biz_type TINYINT NOT NULL COMMENT '业务类型：1SPU 2SKU 3价格 4供应商报价 5城市上架',

    biz_id BIGINT NOT NULL COMMENT '业务ID',

    audit_action TINYINT COMMENT '审核动作：1提交 2通过 3拒绝 4撤回',

    before_status TINYINT COMMENT '审核前状态',

    after_status TINYINT COMMENT '审核后状态',

    audit_remark VARCHAR(512) COMMENT '审核意见',

    auditor_id BIGINT COMMENT '审核人ID',

    audit_time DATETIME COMMENT '审核时间',

    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',

    PRIMARY KEY (id),

    KEY idx_biz_type_id (biz_type, biz_id),

    KEY idx_auditor_id (auditor_id)

) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='商品审核日志表';

9.22 kl_goods_status_log

CREATE TABLE kl_goods_status_log (

    id BIGINT NOT NULL AUTO_INCREMENT COMMENT '状态日志ID',

    biz_type TINYINT COMMENT '业务类型：1SPU 2SKU 3城市商品 4报价',

    biz_id BIGINT COMMENT '业务ID',

    before_status TINYINT COMMENT '变更前状态',

    after_status TINYINT COMMENT '变更后状态',

    change_reason VARCHAR(512) COMMENT '变更原因',

    operator_id BIGINT COMMENT '操作人ID',

    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',

    PRIMARY KEY (id),

    KEY idx_biz_type_id (biz_type, biz_id),

    KEY idx_operator_id (operator_id)

) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='商品状态变更日志表';

十、字段与字段之间的核心关联矩阵

十一、状态机、唯一约束与数据校验规则

11.1 状态字段建议

11.2 关键唯一约束

11.3 核心数据校验规则

• · 创建SPU时，category_id必须存在且未删除。
• · 创建SKU时，spu_id必须存在且SPU未停用。
• · SKU的default_sale_unit_id、default_purchase_unit_id、default_inventory_unit_id必须在kl_goods_sku_unit中存在对应记录。
• · 一个SKU必须且只能有一个base_unit_flag=1的单位。
• · 城市商品的sale_unit_id必须是SKU允许的销售单位。
• · 供应商报价的supply_unit_id必须是SKU允许的采购单位。
• · 价格生效时间必须满足effective_start < effective_end，effective_end可为空。
• · 同一城市商品同一价格类型的有效时间段不应重叠，除非通过优先级字段解决。
• · 上架城市商品前必须存在有效价格，且SKU、SPU、分类均处于启用状态。
• · 质检标准如果同时配置category_id、spu_id、sku_id，应以standard_level约束其作用范围，避免歧义。
• · 替代商品不能指向自身，且应防止A替代B、B替代A的循环。
• · 标签打印记录一旦关联订单明细，不允许物理删除，只能保留作废/重打状态。