foodie-server/specs/013-food-spec/data-model.md

Data Model: 商品规格

Feature: 013-food-spec | Date: 2026-07-15

实体关系

pos_store (门店)
  │ 1
  │
  │ N
food_specs (规格组) ──< food_specs_value (规格值)
  │ N
  │
  │ N   (多对多，通过关联表)
pos_food (商品) ──< food_spec_relation ──> food_specs

新增表

food_specs（规格组）

门店级可复用规格维度（如"甜度""加料"）。

列	类型	说明
id	bigint PK auto	主键
title	varchar(64)	规格名（如"甜度"）
type	char(1)	1=单选 2=多选
state	char(1)	1=必选 2=可选
language	varchar(8)	语言（沿用现有 language 取值约定）
remark	varchar(255)	备注
md_id	bigint	所属门店 id
sort	int	排序
is_open	tinyint(1)	是否启用
is_delete	tinyint(1)	软删除标记

transient 字段（不入库）：foodSpecsItems: List<FoodSpecsValue> —— 承载级联规格值，保存时作为入参、查询时作为出参。

food_specs_value（规格值）

规格组下的可选项（如"无糖""珍珠"）。

列	类型	说明
id	bigint PK auto	主键
parent_id	bigint	所属规格组 id（→ food_specs.id）
name	varchar(64)	规格值名
price	decimal(10,2)	加价金额（与 pos_food.price 同口径）
note	varchar(255)	备注
state	char(1)	状态
is_open	tinyint(1)	是否启用

food_spec_relation（商品-规格关联）

商品与规格组的多对多关联。

列	类型	说明
id	bigint PK auto	主键
food_id	bigint	商品 id（→ pos_food.id）
specs_id	bigint	规格组 id（→ food_specs.id）

既有表扩展

pos_food

• 保留现有 food_sku（text/json）列：冗余存规格 JSON，与结构化关联双写。
• transient 字段（不入库）：
  • foodSpecs: List<FoodSpecs> —— 保存商品时作为入参（写关联表），查询时作为出参（带规格结构）。
  • sku: JSONArray —— 保存时作为入参（toString 写入 food_sku 列）；foodie 已有此字段，复用。

校验规则（来自需求）

• 规格组 type ∈ {1,2}，state ∈ {1,2}。
• 删除规格组为软删（is_delete=1）；关联表记录保留（已生成订单不受影响）。
• 商品可用规格 = is_open=1 且 is_delete=0 的规格组，及其下 is_open=1 的规格值。
• 门店隔离：查询规格组强制按 md_id 过滤。

索引建议

• food_specs: (md_id, language, is_delete, is_open)
• food_specs_value: (parent_id, is_open)
• food_spec_relation: (food_id), (specs_id)

外键

不建物理外键（与项目现有约定一致），靠应用层维护引用完整性。