Keine Beschreibung

name: master-product description: 商品资料主表 - 服装行业数据仓库核心表，存储商品基础信息、统计分析维度和业务指标，包含分类、品牌、颜色、尺码、季节等维度代码 license: MIT compatibility: opencode metadata: category: database domain: retail-erp

table_type: master

商品资料主表 (master_product)

表信息

表名: master_product
主键: product_id
时间字段: created_at, updated_at, launch_date, data_date
查询日期字段: (不适用，主数据表)

关键字段

字段名	数据类型	查询用途
product_id	varchar(50)	商品ID，主键标识
product_code	varchar(50)	商品编码/货号，唯一标识
product_barcode	varchar(20)	国际商品条码/EAN码，用于扫码识别
product_name	varchar(200)	商品名称，支持模糊查询
product_name_en	varchar(200)	商品英文名称，用于国际化查询
product_short_name	varchar(100)	商品简称/缩写，用于快速识别
category_code	varchar(20)	分类代码，关联master_product_dimension(type=‘category_major/minor’)
category_name	varchar(100)	分类名称，用于商品分类筛选
brand_code	varchar(20)	品牌代码，关联master_product_dimension(type=‘brand’)
brand_name	varchar(100)	品牌名称，用于品牌筛选
style_code	varchar(30)	款式编码，用于款式识别
color_code	varchar(20)	颜色代码，关联master_product_dimension(type=‘color_family’)
color_name	varchar(50)	颜色名称，用于颜色筛选
size_code	varchar(10)	尺码代码，关联master_product_dimension(type=‘size_group’)
size_name	varchar(20)	尺码名称，用于尺码筛选
season_code	varchar(10)	季节代码，关联master_product_dimension(type=‘season’)
year	int	年份，用于季节年份筛选
collection	varchar(50)	系列/批次，用于系列分析
min_order_qty	int	最小起订量，用于采购计划
lead_time_days	int	采购提前期（天），用于供应链分析
cost_price	decimal(10,2)	成本价，用于毛利计算
suggested_retail_price	decimal(10,2)	建议零售价，用于价格分析
current_price	decimal(10,2)	当前售价，用于价格筛选
currency_code	varchar(3)	货币代码，默认CNY
safety_stock	int	安全库存水平，用于库存预警
max_stock	int	最高库存量，用于容量管理
reorder_point	int	补货点，用于补货提醒
economic_order_qty	int	经济订货量，用于采购优化
abc_class	varchar(1)	ABC分类(A/B/C)，用于库存管理
xyz_class	varchar(1)	XYZ分类(X/Y/Z)，用于需求稳定性分析
sales_velocity	decimal(10,2)	销售流速（日均销量），用于畅销品分析
sell_through_rate	decimal(5,4)	售罄率，用于商品周转分析
gross_margin	decimal(5,4)	毛利率，用于盈利能力分析
return_rate	decimal(5,4)	退货率，用于质量分析
product_status	varchar(20)	商品状态：active/inactive/discontinued
launch_date	date	上市日期，用于新品分析
discontinuation_date	date	停售日期，用于退市分析
data_date	date	数据日期（数据仓库快照）
created_at	datetime	创建时间，用于时间序列分析
updated_at	datetime	更新时间，用于数据变更跟踪
deleted_at	datetime	删除时间，用于数据归档查询

关联关系

被关联:
- bill_*.product_id → 本表.product_id (所有单据表的商品关联)
- stock_store_snapshot.product_id → 本表.product_id (库存快照)

维度字段说明：

category_code, brand_code, color_code, size_code, season_code, style_code 字段存储维度编码
这些字段不需要外键关联，直接存储维度表的code值
查询时可直接使用这些编码值进行筛选
维度表master_product_dimension作为独立数据字典，提供编码与名称的映射关系

在查询拆解中的角色

where部分：用于商品范围筛选，用户提到的商品条件必须映射到本表字段，维度代码字段(category_code, brand_code等)可直接使用编码值筛选
from部分：可作为主表查询商品信息，或作为关联表提供商品维度
汇总部分：可按category、brand、color、size、season等维度分组统计，也可按业务指标(price, sales_velocity等)进行聚合分析

维度默认值参考

以下为商品维度表的固定分类编码，用于理解业务含义和构建查询条件：

1. 商品大类 (category_major)

编码	名称	描述
CLOTHING	服装	服装类商品
SHOES	鞋类	鞋类商品
ACCESSORIES	配饰	配饰类商品

2. 季节 (season)

编码	名称	描述
SS	春夏	春季和夏季
FW	秋冬	秋季和冬季

3. 波段 (wave) - 用于商品上市计划

编码	名称	描述
W1	第一波段	第一波段商品
W2	第二波段	第二波段商品

4. 面料 (fabric) - 用于商品材质分类

编码	名称	描述
COTTON	棉	棉质面料
POLYESTER	涤纶	涤纶面料
WOOL	羊毛	羊毛面料

5. 颜色色系 (color_family)

编码	名称	描述
RED	红色系	红色系列
BLUE	蓝色系	蓝色系列
BLACK	黑色系	黑色系列

6. 尺码组 (size_group)

编码	名称	描述
XS-S	超小-小号	超小号到小号
M-L	中号-大号	中号到大号
XL-XXL	加大-特大号	加大号到特大号

使用说明：

维度代码字段直接存储维度编码，无需外键关联
WHERE条件示例：WHERE season_code = 'SS' AND category_code = 'CLOTHING'
对于商品表未直接存储的维度（如wave、fabric），可通过维度表独立查询，但不需要与商品表关联
维度表作为独立数据字典，提供编码与名称的映射关系

多步骤查询支持

维度筛选优先：复杂查询建议先筛选维度代码，再关联商品数据
中间表创建：可作为筛选条件的源表，创建中间表保存筛选的商品ID
中间表格式：{userid}{datetime}_step{n}_filtered_products
中间表关键字段：product_id, product_code, product_name, category_code, category_name, brand_code, brand_name, color_code, size_code, season_code, current_price, product_status
维度筛选步骤：
1. 直接使用维度编码筛选商品：WHERE category_code = ‘CLOTHING’ AND season_code = ‘SS’
2. 如需获取维度名称：可单独查询master_product_dimension表，但不需要与商品表关联
3. 创建中间表保存筛选结果
4. 关联业务数据：用中间表商品ID关联查询销售、库存等业务数据
示例流程：用户查询”2024年春夏系列服装类商品的销售数据” →
1. 筛选season_code=‘SS’ AND year=2024
2. 筛选category_code=‘CLOTHING’
3. 创建中间表包含符合条件的商品ID
4. 用中间表关联bill_sales_retail查询销售数据
性能优化：对于大量商品筛选，建议先按核心维度(category, season)缩小范围，再关联其他条件

SKILL.md 7.4KB Verlauf Originalformat