当前位置：首页 > news >正文

快驴商品模块功能分析与数据库表结构设计文档(一）---升鲜宝生鲜配送供应链管理系统源代码服务(标准版、专业版）

news 2026/5/9 14:13:12

公开资料 + 餐饮 B2B 供应链业务推理版

适用对象：升鲜宝供应链系统产品经理 / 架构师 / 后端开发 / DBA / 测试人员

生成日期：2023-02-09

版本：V1.0

重要说明	内容
资料性质	本文基于快驴官网、合作商招募页、规则中心、App公开描述、公开报道以及餐饮B2B供应链业务逻辑进行归纳分析。
数据库性质	本文中的表名、字段名、索引和关联关系均为竞品推理版设计，不代表美团快驴内部真实数据库结构。
使用目的	用于升鲜宝对标快驴进行商品中心、城市商品池、供应商报价、多单位、质检与标签体系建设参考。
命名建议	文中采用 kl_ 前缀表示快驴推理版；升鲜宝落地时建议改为 pms_ / sxb_pms_ / sxb_supply_ 等符合现有系统规范的前缀。

一、研究依据与边界说明

1.1 公开资料依据

来源	可用信息	用于本文的分析点
快驴进货官网	强调价格实惠、种类齐全、品质食材、送货及时、直配到店。	证明商品模块需要支持丰富品类、城市履约、商品质量与供应链闭环。
美团快驴合作商招募页	快驴是美团旗下餐饮供应链平台，面向蔬菜、冻品、干调等多品类合作商招募。	证明存在合作商/供应商商品、报价、服务城市、交货仓与结算链路。
规则中心：合作商生产与交付管理规范	涉及合作商发布商品售卖信息、接受订购需求、生产加工、独立包装、标签打印、仓库收货差异。	证明商品标签、SKU包装、供应商履约、交仓差异需要与商品主数据关联。
规则中心：商品质量标准	涉及标签清晰完整、一物一签、实物与标签一致、生产日期/保质期不得遮盖等要求。	证明商品质检标准、标签标准、效期与资质需要纳入商品模块。
App公开描述与公开报道	描述一站式餐厅食材、用品采购平台；公开报道中提及米面粮油、蔬菜鸡蛋、时令水果、肉禽水产、酒水饮料、方便速食等品类。	证明商品中心需要支持标品、生鲜非标品、冻品、称重品、餐厨用品等多类型商品。

1.2 边界说明

· 本文只分析“商品模块”，不完整展开订单、WMS、TMS、财务结算，但会说明商品字段如何流转到订单、履约、仓库、售后与结算。
· 本文设计重点是字段级建模：每张核心表都给出字段、类型、约束、业务含义、字段关联与校验规则。
· 快驴实际系统可能采用微服务、多库分表、搜索引擎、缓存中间件、数据仓库等更复杂架构，本文以MySQL 8.0业务库建模为主。
· 本文为升鲜宝参考设计，落地时应结合现有 pms_goods、pms_goods_sku、pms_goods_unit_relation、供应商、仓库、订单等表进行迁移和兼容。

二、快驴商品模块业务定位

快驴商品模块不是普通商城商品档案，而是面向餐饮采购场景的“B2B商品主数据中心 + 城市商品池 + 供应商报价中心 + 多单位规格中心 + 商品质量标准中心 + 履约标签中心”。商品模块同时服务商户选购、城市运营定价、合作商报价、仓库收货质检、供应商交仓标签、订单履约拆单和售后责任判定。

能力域	核心问题	系统设计要求
商品主数据	平台销售的商品是什么？	采用分类、品牌、SPU、SKU、属性、图片、资质等标准模型。
多单位与换算	销售、采购、库存、称重是否使用同一单位？	SKU单位关系表必须标识销售单位、采购单位、库存单位、称重单位和换算率。
城市商品池	同一商品是否在所有城市都可售？	按 city_id + sku_id + sale_unit_id 控制城市上架、起订量、库存展示与默认仓。
供应商报价	同一SKU由哪个供应商供货，报价是多少？	按 supplier_id + city_id + warehouse_id + sku_id + supply_unit_id 管理报价、产能、交货仓。
价格中心	商户最终看到什么价？	支持基础价、活动价、等级价、协议价、调价审批、价格生效时间和历史价。
质检标准	收货时怎样判断合格？	按分类、SPU、SKU三级质检标准，支持外观、包装、温度、重量误差、效期规则。
标签包装	供应商交货怎样追溯？	标签模板与打印记录关联供应商、履约任务、订单明细、SKU、二维码和条码。
缺货替代	商品缺货时如何补采/替换？	建立城市级或全局替代关系，支持同品、相似、升级、降级替代。

三、商品模块总体功能架构

3.1 功能模块清单

序号	子模块	核心功能	对应核心表
1	商品分类管理	多级分类、默认温区、默认商品类型、默认质检/效期/资质规则	kl_goods_category
2	品牌管理	品牌档案、Logo、别名、国家地区	kl_goods_brand
3	属性规格管理	分类属性、属性值、SKU规格生成	kl_goods_attribute, kl_goods_attribute_value, kl_goods_sku_attribute
4	SPU管理	商品主体、产地、保质期、温区、生鲜/称重/批次属性	kl_goods_spu
5	SKU管理	规格、包装、重量、体积、条码、默认单位、标签要求	kl_goods_sku
6	单位换算管理	基础单位、销售单位、采购单位、库存单位、称重单位、换算率	kl_goods_unit, kl_goods_sku_unit
7	图片与资质管理	主图、轮播图、详情图、包装图、检疫证、检测报告、合格证	kl_goods_image, kl_goods_cert
8	城市商品池	城市上架、默认履约仓、起订量、限购、预售、库存展示	kl_goods_city_sale
9	城市价格管理	基础价、活动价、等级价、协议价、成本价、毛利、调价审批	kl_goods_price_city, kl_goods_price_approval
10	供应商报价	供应商供货商品、报价、服务城市、交货仓、产能、提前期	kl_goods_supplier_quote, kl_goods_supplier_quote_history
11	质检标准	分类/SPU/SKU质检标准、温度、包装、标签、重量误差、效期	kl_goods_qc_standard
12	标签打印	商品标签、箱标签、冷冻标签、标签模板、打印记录	kl_goods_label_template, kl_goods_label_print
13	替代商品	缺货替代、城市替代、差价处理	kl_goods_substitute
14	审核与日志	商品审核、报价审核、调价审批、状态变更日志	kl_goods_audit_log, kl_goods_status_log

3.2 商品模块分层建议

商品展示层：分类页 / 搜索页 / 商品详情 / 常购商品 / 购物车

商品运营层：城市商品池 / 价格中心 / 活动商品 / 商品推荐 / 缺货替代

商品主数据层：分类 / 品牌 / SPU / SKU / 属性 / 单位 / 图片 / 资质

供应商协同层：供应商报价 / 供货产能 / 交货仓 / 标签打印 / 交货差异

质量控制层：质检标准 / 标签标准 / 效期标准 / 温控标准 / 售后判责

数据服务层：商品搜索索引 / 商品缓存 / 价格缓存 / 单位换算服务 / 审核日志

四、商品主数据模型与ER关系

4.1 推荐商品模型

商品分类 Category

└── 品牌 Brand

└── SPU 商品主体

└── SKU 商品规格

├── SKU属性

├── SKU单位关系：基础单位 / 销售单位 / 采购单位 / 库存单位 / 称重单位

├── 城市商品池：城市 + SKU + 销售单位 + 默认仓 + 上下架

├── 城市价格：城市商品 + 成本价 + 销售价 + 生效时间

├── 供应商报价：供应商 + 城市 + 仓库 + SKU + 供货单位 + 报价

├── 质检标准：分类 / SPU / SKU 三级继承

├── 标签打印：模板 + 供应商 + 履约任务 + 订单明细 + SKU

└── 缺货替代：原SKU → 替代SKU

4.2 ER关系文字版

kl_goods_category.id -> kl_goods_spu.category_id

kl_goods_brand.id -> kl_goods_spu.brand_id

kl_goods_spu.id -> kl_goods_sku.spu_id

kl_goods_attribute.id -> kl_goods_sku_attribute.attr_id

kl_goods_attribute_value.id -> kl_goods_sku_attribute.attr_value_id

kl_goods_sku.id -> kl_goods_sku_unit.sku_id

kl_goods_unit.id -> kl_goods_sku_unit.unit_id

kl_goods_sku.id -> kl_goods_city_sale.sku_id

kl_goods_city_sale.id -> kl_goods_price_city.city_goods_id

kl_goods_sku.id -> kl_goods_supplier_quote.sku_id

kl_goods_unit.id -> kl_goods_supplier_quote.supply_unit_id

kl_goods_sku.id -> kl_goods_qc_standard.sku_id

kl_goods_label_template.id -> kl_goods_label_print.template_id

kl_goods_sku.id -> kl_goods_substitute.source_sku_id / substitute_sku_id

五、商品模块详细功能设计

5.1 商品分类管理

商品分类不仅用于前台导航，还影响温区、质检、售后时效、资质要求、供应商经营范围、价格策略和库存管理方式。分类建议采用三级结构：一级品类、二级品类、三级品类。

· 支持新增、编辑、停用、排序、图标维护。
· 支持配置默认商品类型、默认温区、是否需要质检、是否需要效期、是否需要资质。
· 分类被商品引用后不建议物理删除，只允许逻辑删除或停用。
· 支持分类路径 category_path，提升树查询效率。

5.2 SPU管理

SPU表示商品主体，例如“土豆”“生菜”“五常大米”。SPU负责承载商品公共属性：分类、品牌、产地、保质期、温区、生鲜属性、称重属性、批次属性、资质与质检要求。

· SPU通过审核后才允许上架销售。
· 生鲜/冻品建议开启 batch_required_flag 和 qc_required_flag。
· 称重商品 weigh_flag=1 时，SKU单位关系必须配置称重单位。
· 商品主图可从 kl_goods_image 中同步。

5.3 SKU管理

SKU表示可销售和履约的商品规格，例如“精品土豆5kg/袋”“矿泉水24瓶/箱”。SKU是订单、仓库、供应商报价、标签、质检的核心关联对象。

· SKU必须属于一个SPU。
· SKU编码 sku_code 平台唯一，不能因名称变化影响历史订单。
· SKU可以记录包装颜色、包装材质，用于区分相似商品。
· SKU默认销售/采购/库存单位必须在SKU单位关系表中合法存在。

5.4 单位与换算管理

餐饮B2B商品常出现销售、采购、库存、称重单位不一致的场景。必须通过SKU单位关系表解决单位合法性与换算。

· 一个SKU只能有一个基础单位。
· 城市商品销售单位必须 sale_unit_flag=1。
· 供应商报价供货单位必须 purchase_unit_flag=1。
· 仓库库存单位必须 inventory_unit_flag=1。
· 换算时统一先转基础单位，再转目标单位。

5.5 城市商品池管理

快驴类平台是城市化运营，同一SKU在不同城市可能销售状态、价格、默认仓、起订量、履约能力不同。

· 唯一键建议为 city_id + sku_id + sale_unit_id。
· 城市商品上架前必须有有效销售价。
· 城市商品可覆盖SKU默认起订量、订购步长。
· 预售商品 presale_flag=1 时，库存校验和履约计划需单独处理。

5.6 供应商报价管理

平台模式下，同一SKU可由多个供应商供货。报价不仅是价格，还包括服务城市、交货仓、供货单位、最大产能、备货提前期和质量评分。

· 报价必须经过审核后 quote_status=1 才能用于履约分配。
· 供应商报价供货单位必须是SKU允许采购的单位。
· 报价变更需要记录历史，便于结算追溯。
· 城市商品成本价可来源于供应商最低有效报价，也可来自成本中心。

5.7 城市价格管理

B2B食材价格变化频繁，需要支持基础价、活动价、等级价、协议价和价格生效时间。订单下单时必须锁定价格快照。

· 价格生效区间不得重叠，或通过优先级解决。
· 销售价低于最低售价时必须审批。
· 订单明细必须冗余商品名称、规格、单位、单价，避免主数据变更影响历史订单。
· 调价审批通过后才允许新价格生效。

5.8 质检标准管理

质检标准用于仓库收货、售后判责和供应商评分。建议支持分类级、SPU级、SKU级三级继承。

· 质检标准优先级：SKU > SPU > 分类 > 平台默认。
· 生鲜品类应配置外观要求、重量误差、包装要求。
· 冷藏/冷冻品应配置温度范围。
· 效期商品应配置最低剩余保质期。

5.9 标签与包装管理

合作商交货需要标签追溯。商品标签应关联供应商、履约任务、订单明细、SKU、数量、单位、二维码/条码。

· 一物一签，标签与实物必须一致。
· 冷冻/冷藏商品可使用低温标签模板。
· 标签打印失败需可重打，重打记录必须保留。
· 标签二维码可追溯到订单明细和供应商履约任务。

5.10 缺货替代商品管理

当某SKU缺货时，可按城市或全局替代关系推荐同品、相似、升级或降级替代商品。

· 替代关系应避免循环替代。
· 同一原SKU在同一城市可设置多个替代商品并排序。
· 差价处理支持按新价、原价、人工确认。
· 替代商品必须在该城市可售。

六、核心业务流程设计

6.1 商品创建与审核流程

运营/供应商创建商品

-> 选择分类与品牌

-> 维护SPU基础信息

-> 维护SKU规格、包装、条码、默认单位

-> 配置SKU单位关系

-> 上传图片、资质与质检标准

-> 提交审核

-> 审核通过

-> 进入城市商品池或供应商报价流程

6.2 城市上架与定价流程

选择城市

-> 选择SKU与销售单位

-> 配置默认履约仓、起订量、库存展示策略

-> 配置基础销售价与成本价

-> 若触发低毛利/低售价规则则走调价审批

-> 价格生效

-> 城市商品上架

-> 商户端可见

6.3 供应商报价与履约分配流程

供应商选择可供货SKU

-> 选择供货城市、交货仓、供货单位

-> 填写报价、产能、提前期

-> 平台审核报价

-> 报价生效

-> 订单拆单时匹配供应商

-> 生成供应商备货任务

-> 供应商打印标签并交仓

6.4 下单价格与商品快照流程

商户选择城市商品

-> 系统校验城市商品上架状态

-> 系统按价格优先级获取有效价

-> 校验起订量、订购步长、库存策略

-> 创建订单明细

-> 冗余sku_code、goods_name、spec_value、sale_unit_name、unit_price

-> 后续商品主数据变更不影响历史订单

6.5 仓库收货质检流程

供应商交仓

-> 扫描商品标签

-> 根据sku_id查找SKU级质检标准

-> 若SKU无标准，回退SPU级，再回退分类级

-> 检查外观、包装、标签、温度、重量误差、效期

-> 合格入库，不合格拒收或进入异常区

-> 质检结果回写供应商质量评分

6.6 单位换算流程

输入业务数量与单位

-> 校验sku_id + unit_id 在 kl_goods_sku_unit 中存在且业务flag合法

-> 数量 * conversion_rate 转为基础单位数量

-> 如需转库存单位，再除以库存单位 conversion_rate

-> 结果按目标单位 precision_scale 进行小数位处理

-> 写入订单/采购/库存/成本流水

七、数据库表结构总览

序号	表名	表说明	归属域	字段数
1	kl_goods_category	商品分类表	基础主数据	18
2	kl_goods_brand	商品品牌表	基础主数据	11
3	kl_goods_attribute	商品属性定义表	基础主数据	13
4	kl_goods_attribute_value	商品属性可选值表	基础主数据	8
5	kl_goods_spu	商品SPU表	基础主数据	29
6	kl_goods_sku	商品SKU表	基础主数据	27
7	kl_goods_sku_attribute	SKU属性值表	基础主数据	10
8	kl_goods_unit	商品单位表	基础主数据	10
9	kl_goods_sku_unit	SKU单位关系表	基础主数据	17
10	kl_goods_image	商品图片表	基础主数据	10
11	kl_goods_cert	商品资质证照表	基础主数据	15
12	kl_goods_city_sale	城市商品销售池表	城市/价格	19
13	kl_goods_price_city	城市商品价格表	城市/价格	18
14	kl_goods_supplier_quote	供应商商品报价表	供应商协同	20
15	kl_goods_supplier_quote_history	供应商报价历史表	供应商协同	9
16	kl_goods_qc_standard	商品质检标准表	质量标准	20
17	kl_goods_label_template	商品标签模板表	标签履约	13
18	kl_goods_label_print	商品标签打印记录表	标签履约	18
19	kl_goods_substitute	商品替代关系表	基础主数据	11
20	kl_goods_price_approval	商品调价审批表	城市/价格	16
21	kl_goods_audit_log	商品审核日志表	审核日志	10
22	kl_goods_status_log	商品状态变更日志表	审核日志	8

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

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

8.1 kl_goods_category：商品分类表

字段名	类型	约束/索引	业务含义	字段关联/校验规则
id	BIGINT	PK NOT NULL AUTO_INCREMENT	分类ID
parent_id	BIGINT	NOT NULL DEFAULT 0	父级分类ID，0表示一级分类	kl_goods_category.id 分类树自关联
category_code	VARCHAR(32)	NOT NULL	分类编码	平台内唯一
category_name	VARCHAR(64)	NOT NULL	分类名称	同级分类建议唯一
category_level	TINYINT	NOT NULL	分类层级：1一级 2二级 3三级	由 parent_id 推导或写入
category_path	VARCHAR(255)		分类路径，如/1/10/100	便于递归查询
goods_type	TINYINT	NOT NULL DEFAULT 1	默认商品类型：1标品 2生鲜非标 3称重品 4冻品 5预售品	kl_goods_spu.goods_type 创建SPU时可继承
storage_type	TINYINT	NOT NULL DEFAULT 1	默认温区：1常温 2冷藏 3冷冻	kl_goods_spu.storage_type 创建SPU时可继承
qc_required_flag	TINYINT	NOT NULL DEFAULT 0	是否需要质检：0否 1是	kl_goods_spu.qc_required_flag 生鲜/冻品默认开启
shelf_life_required_flag	TINYINT	NOT NULL DEFAULT 0	是否需要效期：0否 1是	kl_goods_spu.shelf_life_required_flag 食品类建议开启
cert_required_flag	TINYINT	NOT NULL DEFAULT 0	是否需要资质证照：0否 1是	kl_goods_cert 涉及食安/检疫时开启
sale_after_rule_type	TINYINT		默认售后规则类型	分类级售后时效/退换规则
icon_url	VARCHAR(255)		分类图标	前端展示
sort_no	INT	NOT NULL DEFAULT 0	排序号	越小越靠前
enabled_flag	TINYINT	NOT NULL DEFAULT 1	启用标记：0停用 1启用	停用后前台不展示
created_at	DATETIME	NOT NULL DEFAULT CURRENT_TIMESTAMP	创建时间
updated_at	DATETIME	NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP	更新时间
deleted_flag	TINYINT	NOT NULL DEFAULT 0	删除标记：0否 1是	逻辑删除

主要索引/约束：

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：商品品牌表

字段名	类型	约束/索引	业务含义	字段关联/校验规则
id	BIGINT	PK NOT NULL AUTO_INCREMENT	品牌ID
brand_code	VARCHAR(32)	NOT NULL	品牌编码	平台内唯一
brand_name	VARCHAR(128)	NOT NULL	品牌名称	支持模糊查询
brand_alias	VARCHAR(128)		品牌别名	可用于搜索
logo_url	VARCHAR(255)		品牌Logo
origin_country	VARCHAR(64)		品牌国家/地区
sort_no	INT	NOT NULL DEFAULT 0	排序号
enabled_flag	TINYINT	NOT NULL DEFAULT 1	启用标记：0停用 1启用
created_at	DATETIME	NOT NULL DEFAULT CURRENT_TIMESTAMP	创建时间
updated_at	DATETIME	NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP	更新时间
deleted_flag	TINYINT	NOT NULL DEFAULT 0	删除标记

主要索引/约束：

PRIMARY KEY (id)

UNIQUE KEY uk_brand_code (brand_code)

KEY idx_brand_name (brand_name)

8.3 kl_goods_attribute：商品属性定义表

字段名	类型	约束/索引	业务含义	字段关联/校验规则
id	BIGINT	PK NOT NULL AUTO_INCREMENT	属性ID
category_id	BIGINT		所属分类ID	kl_goods_category.id 分类属性模板
attr_code	VARCHAR(32)	NOT NULL	属性编码	同一分类下唯一
attr_name	VARCHAR(64)		属性名称	如规格、等级、口味、包装
attr_type	TINYINT		属性类型：1规格属性 2参数属性 3履约属性	规格属性影响SKU
input_type	TINYINT		录入方式：1手工 2单选 3多选 4数值 5日期
required_flag	TINYINT	NOT NULL DEFAULT 0	是否必填
search_flag	TINYINT	NOT NULL DEFAULT 0	是否作为搜索筛选项
sort_no	INT	NOT NULL DEFAULT 0	排序号
enabled_flag	TINYINT	NOT NULL DEFAULT 1	启用标记
created_at	DATETIME	NOT NULL DEFAULT CURRENT_TIMESTAMP	创建时间
updated_at	DATETIME	NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP	更新时间
deleted_flag	TINYINT	NOT NULL DEFAULT 0	删除标记

主要索引/约束：

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：商品属性可选值表

字段名	类型	约束/索引	业务含义	字段关联/校验规则
id	BIGINT	PK NOT NULL AUTO_INCREMENT	属性值ID
attr_id	BIGINT		属性ID	kl_goods_attribute.id
value_code	VARCHAR(32)		属性值编码
value_name	VARCHAR(128)		属性值名称
sort_no	INT	NOT NULL DEFAULT 0	排序号
enabled_flag	TINYINT	NOT NULL DEFAULT 1	启用标记
created_at	DATETIME	NOT NULL DEFAULT CURRENT_TIMESTAMP	创建时间
deleted_flag	TINYINT	NOT NULL DEFAULT 0	删除标记

主要索引/约束：

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表

字段名	类型	约束/索引	业务含义	字段关联/校验规则
id	BIGINT	PK NOT NULL AUTO_INCREMENT	SPU ID
spu_code	VARCHAR(32)	NOT NULL	SPU编码	平台唯一
spu_name	VARCHAR(128)	NOT NULL	商品名称	如土豆、精品生菜
short_name	VARCHAR(64)		商品简称	用于标签/移动端
category_id	BIGINT	NOT NULL	分类ID	kl_goods_category.id 必填
brand_id	BIGINT		品牌ID	kl_goods_brand.id 无品牌可空
goods_type	TINYINT	NOT NULL DEFAULT 1	商品类型：1标品 2生鲜非标 3称重品 4冻品 5预售品	继承分类默认值
storage_type	TINYINT	NOT NULL DEFAULT 1	温区：1常温 2冷藏 3冷冻	影响仓储与标签
source_type	TINYINT	NOT NULL DEFAULT 1	来源：1平台自建 2供应商创建 3系统导入	供应商创建需审核
origin_place	VARCHAR(128)		产地	商品详情/溯源
shelf_life_days	INT		保质期天数	效期商品必填
shelf_life_unit	TINYINT	DEFAULT 1	保质期单位：1天 2月 3年
batch_required_flag	TINYINT	NOT NULL DEFAULT 0	是否批次管理	生鲜/冻品/食品建议开启
shelf_life_required_flag	TINYINT	NOT NULL DEFAULT 0	是否效期管理
weigh_flag	TINYINT	NOT NULL DEFAULT 0	是否称重商品	称重品需要称重单位
fresh_flag	TINYINT	NOT NULL DEFAULT 0	是否生鲜商品	影响质检与售后时效
cert_required_flag	TINYINT	NOT NULL DEFAULT 0	是否需要商品资质
qc_required_flag	TINYINT	NOT NULL DEFAULT 0	是否需要质检
supplier_quote_flag	TINYINT	NOT NULL DEFAULT 1	是否允许供应商报价	平台模式核心开关
city_sale_flag	TINYINT	NOT NULL DEFAULT 1	是否允许城市销售	不同城市可单独上架
description	TEXT		商品描述
main_image_url	VARCHAR(255)		主图URL	kl_goods_image.image_url 可由主图同步
audit_status	TINYINT	NOT NULL DEFAULT 0	审核状态：0待审 1通过 2拒绝 3撤回	通过后允许生成SKU/上架
enabled_flag	TINYINT	NOT NULL DEFAULT 1	启用标记
created_by	BIGINT		创建人ID	kl_sys_user.id
created_at	DATETIME	NOT NULL DEFAULT CURRENT_TIMESTAMP	创建时间
updated_by	BIGINT		更新人ID	kl_sys_user.id
updated_at	DATETIME	NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP	更新时间
deleted_flag	TINYINT	NOT NULL DEFAULT 0	删除标记

主要索引/约束：

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表

字段名	类型	约束/索引	业务含义	字段关联/校验规则
id	BIGINT	PK NOT NULL AUTO_INCREMENT	SKU ID
spu_id	BIGINT	NOT NULL	SPU ID	kl_goods_spu.id 一个SPU多个SKU
sku_code	VARCHAR(32)	NOT NULL	SKU编码	平台唯一
sku_name	VARCHAR(128)	NOT NULL	SKU名称	可冗余SPU+规格
spec_value	VARCHAR(128)		规格值	如5kg/袋、24瓶/箱
package_spec	VARCHAR(128)		包装规格	履约包装说明
package_material	VARCHAR(64)		包装材质	如塑料袋、纸箱
package_color	VARCHAR(64)		包装颜色	用于区分相似商品
barcode	VARCHAR(64)		商品条码	标品优先填
external_sku_code	VARCHAR(64)		外部SKU编码	对接供应商/ERP
net_weight	DECIMAL(18,4)		净重	配合重量单位
gross_weight	DECIMAL(18,4)		毛重	物流计费/装车
length	DECIMAL(18,4)		长
width	DECIMAL(18,4)		宽
height	DECIMAL(18,4)		高
volume	DECIMAL(18,6)		体积	长宽高可计算
weight_unit_id	BIGINT		重量单位ID	kl_goods_unit.id
default_sale_unit_id	BIGINT		默认销售单位ID	kl_goods_unit.id 必须在kl_goods_sku_unit中sale_unit_flag=1
default_purchase_unit_id	BIGINT		默认采购单位ID	kl_goods_unit.id 必须在kl_goods_sku_unit中purchase_unit_flag=1
default_inventory_unit_id	BIGINT		默认库存单位ID	kl_goods_unit.id 必须在kl_goods_sku_unit中inventory_unit_flag=1
label_required_flag	TINYINT	NOT NULL DEFAULT 1	是否要求打印商品标签	合作商交付关键字段
low_temp_label_flag	TINYINT	NOT NULL DEFAULT 0	是否需要低温标签	冷冻/冷藏可开启
fragile_flag	TINYINT		是否易碎	影响分拣/配送
enabled_flag	TINYINT	NOT NULL DEFAULT 1	启用标记
created_at	DATETIME	NOT NULL DEFAULT CURRENT_TIMESTAMP	创建时间
updated_at	DATETIME	NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP	更新时间
deleted_flag	TINYINT	NOT NULL DEFAULT 0	删除标记

主要索引/约束：

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属性值表

字段名	类型	约束/索引	业务含义	字段关联/校验规则
id	BIGINT	PK NOT NULL AUTO_INCREMENT	SKU属性ID
spu_id	BIGINT		SPU ID	kl_goods_spu.id 冗余便于查询
sku_id	BIGINT		SKU ID	kl_goods_sku.id
attr_id	BIGINT		属性ID	kl_goods_attribute.id
attr_code	VARCHAR(32)		属性编码	冗余
attr_name	VARCHAR(64)		属性名称	冗余
attr_value_id	BIGINT		属性值ID	kl_goods_attribute_value.id 可空，手工值时为空
attr_value	VARCHAR(128)		属性值
created_at	DATETIME	NOT NULL DEFAULT CURRENT_TIMESTAMP	创建时间
deleted_flag	TINYINT	NOT NULL DEFAULT 0	删除标记

主要索引/约束：

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：商品单位表

字段名	类型	约束/索引	业务含义	字段关联/校验规则
id	BIGINT	PK NOT NULL AUTO_INCREMENT	单位ID
unit_code	VARCHAR(32)	NOT NULL	单位编码	平台唯一
unit_name	VARCHAR(32)	NOT NULL	单位名称	如斤、kg、箱、袋
unit_type	TINYINT	NOT NULL DEFAULT 1	单位类型：1数量 2重量 3体积 4包装	影响换算规则
precision_scale	INT	NOT NULL DEFAULT 2	数量小数位	用于数量录入与展示
standard_flag	TINYINT	NOT NULL DEFAULT 0	是否标准单位	kg、g、L等可标为标准
enabled_flag	TINYINT	NOT NULL DEFAULT 1	启用标记
created_at	DATETIME	NOT NULL DEFAULT CURRENT_TIMESTAMP	创建时间
updated_at	DATETIME	NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP	更新时间
deleted_flag	TINYINT	NOT NULL DEFAULT 0	删除标记

主要索引/约束：

PRIMARY KEY (id)

UNIQUE KEY uk_unit_code (unit_code)

UNIQUE KEY uk_unit_name (unit_name)

8.9 kl_goods_sku_unit：SKU单位关系表

字段名	类型	约束/索引	业务含义	字段关联/校验规则
id	BIGINT	PK NOT NULL AUTO_INCREMENT	SKU单位关系ID
sku_id	BIGINT	NOT NULL	SKU ID	kl_goods_sku.id
unit_id	BIGINT	NOT NULL	单位ID	kl_goods_unit.id
base_unit_flag	TINYINT	NOT NULL DEFAULT 0	是否基础单位	一个SKU只能有一个基础单位
sale_unit_flag	TINYINT	NOT NULL DEFAULT 0	是否销售单位	kl_goods_city_sale.sale_unit_id 城市商品销售单位必须开启
purchase_unit_flag	TINYINT	NOT NULL DEFAULT 0	是否采购单位	kl_goods_supplier_quote.supply_unit_id 供应商供货单位必须开启
inventory_unit_flag	TINYINT	NOT NULL DEFAULT 0	是否库存单位	kl_wms_inventory.unit_id 库存单位必须开启
weigh_unit_flag	TINYINT	NOT NULL DEFAULT 0	是否称重单位	称重品使用
conversion_rate	DECIMAL(18,6)	NOT NULL DEFAULT 1	相对基础单位换算率	例：1箱=20kg，则箱相对kg为20
reverse_conversion_rate	DECIMAL(18,6)		反向换算率	可选冗余
min_order_qty	DECIMAL(18,4)		最小起订量	销售/采购均可校验
max_order_qty	DECIMAL(18,4)		最大订购量	限购/供货约束
order_step_qty	DECIMAL(18,4)		订购步长	如0.5斤、1箱
enabled_flag	TINYINT	NOT NULL DEFAULT 1	启用标记
created_at	DATETIME	NOT NULL DEFAULT CURRENT_TIMESTAMP	创建时间
updated_at	DATETIME	NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP	更新时间
deleted_flag	TINYINT	NOT NULL DEFAULT 0	删除标记

主要索引/约束：

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：商品图片表

字段名	类型	约束/索引	业务含义	字段关联/校验规则
id	BIGINT	PK NOT NULL AUTO_INCREMENT	图片ID
spu_id	BIGINT		SPU ID	kl_goods_spu.id SPU图片
sku_id	BIGINT		SKU ID	kl_goods_sku.id SKU图片
image_type	TINYINT	NOT NULL DEFAULT 1	图片类型：1主图 2轮播图 3详情图 4资质图 5包装图
image_url	VARCHAR(255)	NOT NULL	图片地址
sort_no	INT	NOT NULL DEFAULT 0	排序号
main_flag	TINYINT	NOT NULL DEFAULT 0	是否主图	可同步到SPU主图
enabled_flag	TINYINT	NOT NULL DEFAULT 1	启用标记
created_at	DATETIME	NOT NULL DEFAULT CURRENT_TIMESTAMP	创建时间
deleted_flag	TINYINT	NOT NULL DEFAULT 0	删除标记

主要索引/约束：

PRIMARY KEY (id)

KEY idx_spu_id (spu_id)

KEY idx_sku_id (sku_id)

8.11 kl_goods_cert：商品资质证照表

字段名	类型	约束/索引	业务含义	字段关联/校验规则
id	BIGINT	PK NOT NULL AUTO_INCREMENT	资质ID
spu_id	BIGINT		SPU ID	kl_goods_spu.id SPU级资质
sku_id	BIGINT		SKU ID	kl_goods_sku.id SKU级资质
supplier_id	BIGINT		供应商ID	kl_supplier.id 供应商提供的资质
cert_type	TINYINT		资质类型：1检疫证 2检测报告 3生产许可 4合格证 5其他
cert_name	VARCHAR(128)		资质名称
cert_no	VARCHAR(128)		资质编号
file_url	VARCHAR(255)		文件URL
valid_start	DATE		有效期开始
valid_end	DATE		有效期结束	到期需提醒
audit_status	TINYINT		审核状态：0待审 1通过 2拒绝
enabled_flag	TINYINT	NOT NULL DEFAULT 1	启用标记
created_at	DATETIME	NOT NULL DEFAULT CURRENT_TIMESTAMP	创建时间
updated_at	DATETIME	NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP	更新时间
deleted_flag	TINYINT	NOT NULL DEFAULT 0	删除标记

主要索引/约束：

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：城市商品销售池表

字段名	类型	约束/索引	业务含义	字段关联/校验规则
id	BIGINT	PK NOT NULL AUTO_INCREMENT	城市商品ID
city_id	BIGINT	NOT NULL	城市ID	kl_base_city.id 城市化运营核心字段
sku_id	BIGINT	NOT NULL	SKU ID	kl_goods_sku.id
sale_unit_id	BIGINT	NOT NULL	销售单位ID	kl_goods_unit.id 必须在sku_unit中sale_unit_flag=1
default_warehouse_id	BIGINT		默认履约仓库ID	kl_base_warehouse.id
sale_enabled	TINYINT	NOT NULL DEFAULT 1	销售状态：0下架 1上架 2暂停 3售罄 4预售
presale_flag	TINYINT	NOT NULL DEFAULT 0	是否预售	预售不强校验现货库存
stock_display_flag	TINYINT	NOT NULL DEFAULT 1	是否展示库存	B端常用
stock_deduct_type	TINYINT	NOT NULL DEFAULT 1	扣库存方式：1下单锁定 2支付锁定 3出库扣减
min_order_qty	DECIMAL(18,4)		最小起订量	覆盖SKU单位设置
max_order_qty	DECIMAL(18,4)		最大限购量
order_step_qty	DECIMAL(18,4)		订购步长
sale_start_time	DATETIME		销售开始时间
sale_end_time	DATETIME		销售结束时间
search_keyword	VARCHAR(255)		搜索关键词	同义词/拼音
sort_no	INT	NOT NULL DEFAULT 0	排序号
created_at	DATETIME	NOT NULL DEFAULT CURRENT_TIMESTAMP	创建时间
updated_at	DATETIME	NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP	更新时间
deleted_flag	TINYINT	NOT NULL DEFAULT 0	删除标记

主要索引/约束：

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：城市商品价格表

字段名	类型	约束/索引	业务含义	字段关联/校验规则
id	BIGINT	PK NOT NULL AUTO_INCREMENT	价格ID
city_goods_id	BIGINT	NOT NULL	城市商品ID	kl_goods_city_sale.id
city_id	BIGINT	NOT NULL	城市ID	kl_goods_city_sale.city_id 冗余便于查询
sku_id	BIGINT	NOT NULL	SKU ID	kl_goods_city_sale.sku_id 冗余便于查询
sale_unit_id	BIGINT	NOT NULL	销售单位ID	kl_goods_city_sale.sale_unit_id 冗余便于查询
cost_price	DECIMAL(18,4)	NOT NULL DEFAULT 0	成本价	kl_goods_supplier_quote.quote_price 可由供应商报价/成本中心计算
sale_price	DECIMAL(18,4)	NOT NULL	销售价	kl_order_item.unit_price 下单时锁价到订单明细
market_price	DECIMAL(18,4)		市场价	展示/划线价
min_sale_price	DECIMAL(18,4)		最低售价	毛利红线
gross_margin_rate	DECIMAL(8,4)		毛利率	可由售价和成本计算
price_type	TINYINT	NOT NULL DEFAULT 1	价格类型：1基础价 2活动价 3等级价 4协议价	价格优先级使用
effective_start	DATETIME	NOT NULL	生效开始时间
effective_end	DATETIME		生效结束时间	空表示长期有效
approval_status	TINYINT	NOT NULL DEFAULT 0	审批状态：0待审 1通过 2拒绝	高风险调价走审批
enabled_flag	TINYINT	NOT NULL DEFAULT 1	启用标记
created_at	DATETIME	NOT NULL DEFAULT CURRENT_TIMESTAMP	创建时间
updated_at	DATETIME	NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP	更新时间
deleted_flag	TINYINT	NOT NULL DEFAULT 0	删除标记

主要索引/约束：

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：供应商商品报价表

字段名	类型	约束/索引	业务含义	字段关联/校验规则
id	BIGINT	PK NOT NULL AUTO_INCREMENT	供应商报价ID
supplier_id	BIGINT	NOT NULL	供应商ID	kl_supplier.id 报价主体
city_id	BIGINT	NOT NULL	服务城市ID	kl_base_city.id
warehouse_id	BIGINT		交货仓库ID	kl_base_warehouse.id 供应商交仓地点
sku_id	BIGINT	NOT NULL	SKU ID	kl_goods_sku.id
supply_unit_id	BIGINT	NOT NULL	供货单位ID	kl_goods_unit.id 必须在sku_unit中purchase_unit_flag=1
quote_price	DECIMAL(18,4)	NOT NULL	供应商报价	可作为成本价来源
tax_rate	DECIMAL(8,4)		税率	开票/结算
min_supply_qty	DECIMAL(18,4)		最小供货量
max_supply_qty	DECIMAL(18,4)		最大供货量
daily_capacity_qty	DECIMAL(18,4)		每日最大供货能力	供应商履约分配
lead_time_hours	INT		备货提前小时数	截单/备货计划
stockout_rate	DECIMAL(8,4)		历史缺货率	供应商评分
quality_score	DECIMAL(8,2)		商品质量评分	质检/售后回写
quote_status	TINYINT	NOT NULL DEFAULT 0	报价状态：0待审 1生效 2拒绝 3失效 4暂停
effective_start	DATETIME	NOT NULL	生效开始时间
effective_end	DATETIME		生效结束时间
created_at	DATETIME	NOT NULL DEFAULT CURRENT_TIMESTAMP	创建时间
updated_at	DATETIME	NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP	更新时间
deleted_flag	TINYINT	NOT NULL DEFAULT 0	删除标记

主要索引/约束：

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：供应商报价历史表

字段名	类型	约束/索引	业务含义	字段关联/校验规则
id	BIGINT	PK NOT NULL AUTO_INCREMENT	历史ID
quote_id	BIGINT		报价ID	kl_goods_supplier_quote.id
supplier_id	BIGINT		供应商ID	kl_supplier.id 冗余
sku_id	BIGINT		SKU ID	kl_goods_sku.id 冗余
old_quote_price	DECIMAL(18,4)		调整前报价
new_quote_price	DECIMAL(18,4)		调整后报价
change_reason	VARCHAR(255)		调整原因
operator_id	BIGINT		操作人ID	kl_sys_user.id
created_at	DATETIME	NOT NULL DEFAULT CURRENT_TIMESTAMP	创建时间

主要索引/约束：

PRIMARY KEY (id)

KEY idx_quote_id (quote_id)

KEY idx_supplier_sku (supplier_id, sku_id)

8.16 kl_goods_qc_standard：商品质检标准表

字段名	类型	约束/索引	业务含义	字段关联/校验规则
id	BIGINT	PK NOT NULL AUTO_INCREMENT	质检标准ID
category_id	BIGINT		分类ID	kl_goods_category.id 分类级标准
spu_id	BIGINT		SPU ID	kl_goods_spu.id SPU级标准
sku_id	BIGINT		SKU ID	kl_goods_sku.id SKU级标准
standard_code	VARCHAR(32)	NOT NULL	标准编码	唯一
standard_name	VARCHAR(128)	NOT NULL	标准名称
standard_level	TINYINT	NOT NULL DEFAULT 1	标准级别：1分类 2SPU 3SKU	优先级SKU>SPU>分类
storage_type	TINYINT		适用温区：1常温 2冷藏 3冷冻
appearance_required	VARCHAR(512)		外观要求	如无腐烂、无明显泥沙
package_required	VARCHAR(512)		包装要求
label_required	VARCHAR(512)		标签要求	一物一签、清晰可扫
temp_min	DECIMAL(8,2)		最低温度	冷链质检
temp_max	DECIMAL(8,2)		最高温度	冷链质检
weight_tolerance_rate	DECIMAL(8,4)		重量允许误差比例	如±3%
shelf_life_min_days	INT		入库最低剩余保质期天数
reject_rule	VARCHAR(512)		拒收规则
enabled_flag	TINYINT	NOT NULL DEFAULT 1	启用标记
created_at	DATETIME	NOT NULL DEFAULT CURRENT_TIMESTAMP	创建时间
updated_at	DATETIME	NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP	更新时间
deleted_flag	TINYINT	NOT NULL DEFAULT 0	删除标记

主要索引/约束：

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：商品标签模板表

字段名	类型	约束/索引	业务含义	字段关联/校验规则
id	BIGINT	PK NOT NULL AUTO_INCREMENT	标签模板ID
template_code	VARCHAR(32)	NOT NULL	模板编码	唯一
template_name	VARCHAR(128)	NOT NULL	模板名称
template_type	TINYINT		模板类型：1商品标签 2箱标签 3分拣标签 4冷冻标签
storage_type	TINYINT		适用温区
template_content	TEXT	NOT NULL	模板内容JSON/HTML
width_mm	DECIMAL(8,2)		宽度mm
height_mm	DECIMAL(8,2)		高度mm
low_temp_flag	TINYINT	NOT NULL DEFAULT 0	是否低温标签
enabled_flag	TINYINT	NOT NULL DEFAULT 1	启用标记
created_at	DATETIME	NOT NULL DEFAULT CURRENT_TIMESTAMP	创建时间
updated_at	DATETIME	NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP	更新时间
deleted_flag	TINYINT	NOT NULL DEFAULT 0	删除标记

主要索引/约束：

PRIMARY KEY (id)

UNIQUE KEY uk_template_code (template_code)

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

字段名	类型	约束/索引	业务含义	字段关联/校验规则
id	BIGINT	PK NOT NULL AUTO_INCREMENT	标签打印ID
print_code	VARCHAR(32)	NOT NULL	打印批次号	唯一
template_id	BIGINT		标签模板ID	kl_goods_label_template.id
supplier_id	BIGINT		供应商ID	kl_supplier.id
warehouse_id	BIGINT		仓库ID	kl_base_warehouse.id
fulfill_task_id	BIGINT		履约任务ID	kl_fulfill_supplier_task.id
order_id	BIGINT		订单ID	kl_order.id
order_item_id	BIGINT		订单明细ID	kl_order_item.id 标签追溯到订单明细
sku_id	BIGINT	NOT NULL	SKU ID	kl_goods_sku.id
sku_name	VARCHAR(128)	NOT NULL	SKU名称	快照
spec_value	VARCHAR(128)		规格	快照
quantity	DECIMAL(18,4)		标签对应数量
unit_id	BIGINT		单位ID	kl_goods_unit.id
qr_code	VARCHAR(255)		二维码内容
barcode	VARCHAR(128)		条码内容
print_status	TINYINT	NOT NULL DEFAULT 0	打印状态：0待打印 1已打印 2失败
print_time	DATETIME		打印时间
created_at	DATETIME	NOT NULL DEFAULT CURRENT_TIMESTAMP	创建时间

主要索引/约束：

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：商品替代关系表

字段名	类型	约束/索引	业务含义	字段关联/校验规则
id	BIGINT	PK NOT NULL AUTO_INCREMENT	替代商品ID
city_id	BIGINT		城市ID	kl_base_city.id 城市维度替代，可空表示全局
source_sku_id	BIGINT	NOT NULL	原SKU ID	kl_goods_sku.id 缺货商品
substitute_sku_id	BIGINT	NOT NULL	替代SKU ID	kl_goods_sku.id 替代商品
substitute_level	TINYINT	NOT NULL DEFAULT 1	替代优先级	越小优先级越高
substitute_type	TINYINT		替代类型：1同品 2相似 3升级 4降级
price_diff_handle_type	TINYINT		差价处理：1按新价 2原价 3人工确认
enabled_flag	TINYINT	NOT NULL DEFAULT 1	启用标记
created_at	DATETIME	NOT NULL DEFAULT CURRENT_TIMESTAMP	创建时间
updated_at	DATETIME	NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP	更新时间
deleted_flag	TINYINT	NOT NULL DEFAULT 0	删除标记

主要索引/约束：

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：商品调价审批表

字段名	类型	约束/索引	业务含义	字段关联/校验规则
id	BIGINT	PK NOT NULL AUTO_INCREMENT	审批ID
approval_code	VARCHAR(32)	NOT NULL	审批单号	唯一
price_id	BIGINT		价格ID	kl_goods_price_city.id 待审批价格记录
city_goods_id	BIGINT		城市商品ID	kl_goods_city_sale.id
sku_id	BIGINT		SKU ID	kl_goods_sku.id
old_sale_price	DECIMAL(18,4)		原销售价
new_sale_price	DECIMAL(18,4)		新销售价
old_cost_price	DECIMAL(18,4)		原成本价
new_cost_price	DECIMAL(18,4)		新成本价
reason	VARCHAR(512)		调价原因
approval_status	TINYINT		审批状态：0待审 1通过 2拒绝 3撤回
applicant_id	BIGINT		申请人ID	kl_sys_user.id
approver_id	BIGINT		审批人ID	kl_sys_user.id
approval_time	DATETIME		审批时间
created_at	DATETIME	NOT NULL DEFAULT CURRENT_TIMESTAMP	创建时间
updated_at	DATETIME	NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP	更新时间

主要索引/约束：

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：商品审核日志表

字段名	类型	约束/索引	业务含义	字段关联/校验规则
id	BIGINT	PK NOT NULL AUTO_INCREMENT	审核日志ID
biz_type	TINYINT	NOT NULL	业务类型：1SPU 2SKU 3价格 4供应商报价 5城市上架
biz_id	BIGINT	NOT NULL	业务ID	按biz_type关联不同表
audit_action	TINYINT		审核动作：1提交 2通过 3拒绝 4撤回
before_status	TINYINT		审核前状态
after_status	TINYINT		审核后状态
audit_remark	VARCHAR(512)		审核意见
auditor_id	BIGINT		审核人ID	kl_sys_user.id
audit_time	DATETIME		审核时间
created_at	DATETIME	NOT NULL DEFAULT CURRENT_TIMESTAMP	创建时间

主要索引/约束：

PRIMARY KEY (id)

KEY idx_biz_type_id (biz_type, biz_id)

KEY idx_auditor_id (auditor_id)

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

字段名	类型	约束/索引	业务含义	字段关联/校验规则
id	BIGINT	PK NOT NULL AUTO_INCREMENT	状态日志ID
biz_type	TINYINT		业务类型：1SPU 2SKU 3城市商品 4报价
biz_id	BIGINT		业务ID
before_status	TINYINT		变更前状态
after_status	TINYINT		变更后状态
change_reason	VARCHAR(512)		变更原因
operator_id	BIGINT		操作人ID	kl_sys_user.id
created_at	DATETIME	NOT NULL DEFAULT CURRENT_TIMESTAMP	创建时间

主要索引/约束：

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='商品状态变更日志表';

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

关系名称	当前字段	关联字段	业务说明
分类自关联	kl_goods_category.parent_id	kl_goods_category.id	形成多级分类树；parent_id=0表示一级分类。
分类到SPU	kl_goods_spu.category_id	kl_goods_category.id	SPU必须属于一个分类；分类默认温区/质检/效期可继承到SPU。
品牌到SPU	kl_goods_spu.brand_id	kl_goods_brand.id	品牌可为空；标品建议维护品牌。
SPU到SKU	kl_goods_sku.spu_id	kl_goods_spu.id	一个SPU下可有多个SKU规格。
属性到SKU	kl_goods_sku_attribute.attr_id	kl_goods_attribute.id	SKU规格属性来源于分类属性定义。
单位到SKU单位	kl_goods_sku_unit.unit_id	kl_goods_unit.id	SKU允许使用的单位必须来自单位表。
SKU到SKU单位	kl_goods_sku_unit.sku_id	kl_goods_sku.id	一个SKU至少配置基础、销售、采购、库存单位。
城市商品销售单位合法性	kl_goods_city_sale.sku_id + sale_unit_id	kl_goods_sku_unit.sku_id + unit_id	必须存在且 sale_unit_flag=1。
供应商供货单位合法性	kl_goods_supplier_quote.sku_id + supply_unit_id	kl_goods_sku_unit.sku_id + unit_id	必须存在且 purchase_unit_flag=1。
库存单位合法性	kl_wms_inventory.sku_id + unit_id	kl_goods_sku_unit.sku_id + unit_id	必须存在且 inventory_unit_flag=1。
城市商品到价格	kl_goods_price_city.city_goods_id	kl_goods_city_sale.id	一个城市商品可有多条价格记录，通过生效时间和价格类型确定当前价。
供应商报价到成本	kl_goods_price_city.cost_price	kl_goods_supplier_quote.quote_price	成本价可由有效供应商报价、采购成本或成本中心计算。
订单商品快照	kl_order_item.sku_id / unit_price	kl_goods_sku.id / kl_goods_price_city.sale_price	下单时冗余商品名称、规格、单位、单价，保证历史订单稳定。
标签追溯	kl_goods_label_print.order_item_id	kl_order_item.id	标签可追溯到订单明细、供应商履约任务和SKU。
质检标准优先级	kl_goods_qc_standard.sku_id/spu_id/category_id	kl_goods_sku.id / kl_goods_spu.id / kl_goods_category.id	查找顺序：SKU级 > SPU级 > 分类级 > 平台默认。
替代商品	kl_goods_substitute.source_sku_id / substitute_sku_id	kl_goods_sku.id	缺货时根据城市和优先级寻找替代SKU。

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

11.1 状态字段建议

字段	状态值	说明
audit_status	0待审 / 1通过 / 2拒绝 / 3撤回	用于SPU、资质、报价、价格审批等审核场景。
enabled_flag	0停用 / 1启用	基础档案启停，不建议物理删除。
sale_enabled	0下架 / 1上架 / 2暂停 / 3售罄 / 4预售	城市商品销售状态。
quote_status	0待审 / 1生效 / 2拒绝 / 3失效 / 4暂停	供应商报价状态。
print_status	0待打印 / 1已打印 / 2失败	标签打印记录状态。
approval_status	0待审 / 1通过 / 2拒绝 / 3撤回	调价审批状态。

11.2 关键唯一约束

业务对象	唯一约束	业务意义
分类	uk_category_code(category_code)	分类编码全局唯一。
品牌	uk_brand_code(brand_code)	品牌编码唯一。
SPU	uk_spu_code(spu_code)	商品主体编码唯一。
SKU	uk_sku_code(sku_code)	SKU编码唯一，是订单、仓库、供应商报价核心引用。
SKU单位	uk_sku_unit(sku_id, unit_id)	同一SKU不能重复配置相同单位。
城市商品	uk_city_sku_unit(city_id, sku_id, sale_unit_id)	同一城市同一SKU同一销售单位只能有一条销售配置。
标签模板	uk_template_code(template_code)	标签模板编码唯一。
替代关系	uk_source_substitute_city(city_id, source_sku_id, substitute_sku_id)	同一城市同一替代关系不能重复。

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的循环。
· 标签打印记录一旦关联订单明细，不允许物理删除，只能保留作废/重打状态。

十二、升鲜宝对标快驴的商品模块落地建议

12.1 升鲜宝建议优先落地的表

优先级	建议落地表	落地原因
P0	pms_goods_spu / pms_goods_sku	先把SPU/SKU商品主体和规格拆清楚，避免商品名称+规格混用。
P0	pms_goods_unit / pms_goods_sku_unit	解决销售单位、采购单位、库存单位、称重单位混乱问题。
P0	pms_goods_city_sale	为后续多城市、多仓、多店铺上架奠定基础。
P0	pms_goods_price_city	支持城市差异价格、调价生效时间和订单锁价。
P1	pms_goods_supplier_quote	支持供应商报价、平台模式、供应商履约任务。
P1	pms_goods_qc_standard	支持入库质检和售后判责。
P1	pms_goods_label_template / pms_goods_label_print	支持供应商标签打印和交仓追溯。
P2	pms_goods_substitute	支持缺货替代、补采和智能推荐。

12.2 升鲜宝商品模块最关键的四条主线

订单销售看：sku_id + sale_unit_id

供应商采购看：sku_id + purchase_unit_id

仓库库存看：sku_id + inventory_unit_id

称重换算看：sku_id + base_unit_id + conversion_rate

12.3 双单位与生鲜称重示例

场景	示例	数据库表达
按斤销售、按只辅助显示	波士顿龙虾：65斤 / 50只	SKU配置斤为库存/销售单位，只为辅助单位；库存扩展表可记录辅助数量。
按箱采购、按kg库存	精品土豆：1箱=20kg	base_unit=kg，箱conversion_rate=20，采购单位flag=1。
按袋销售、按箱采购	调料：1箱=20袋	袋为销售单位，箱为采购单位，换算率分别配置。
称重品订单	商户下单10斤，仓库实际称重9.85斤	订单数量与实际履约数量分开，售后或多退少补按差异处理。

12.4 建设顺序建议

第一阶段：分类、品牌、SPU、SKU、单位、SKU单位关系

第二阶段：城市商品池、城市价格、订单商品快照

第三阶段：供应商报价、供应商商品、履约标签

第四阶段：质检标准、售后判责、供应商扣罚

第五阶段：缺货替代、智能推荐、价格预测、商品搜索优化

资料来源

资料	URL
快驴进货官网	https://www.kuailvzaixian.com/
美团快驴进货合作商招募	https://123.meituan.com/serve/web/business/140?source=mtqygw
快驴进货平台合作商生产与交付管理规范（规则中心）	https://rules-center.meituan.com/m/detail/guize/268?activeRule=1&commonType=17
快驴进货平台商品质量标准（规则中心）	https://rules-center.meituan.com/rules-detail/284
快驴进货平台自营及三方商品售后规则（规则中心）	https://rules-center.meituan.com/rules-detail/289
快驴进货 App Store 公开描述	https://apps.apple.com/cn/app/快驴进货/id1188224117
新浪科技公开报道：快驴进货业务与品类	https://tech.sina.cn/i/gn/2018-11-29/detail-ihpevhcm3449806.d.html