商品中心使用手册
一、模块概述
商品中心（菜单 ID：2001）是智富 ERP 中负责商品主数据与商品扩展属性管理的模块。它统一维护商品的分类、品牌、基础资料，以及三类关键的扩展属性，为后续的采购、销售、库存业务提供结构化的商品数据支撑。
商品中心包含以下子菜单：
| 子菜单 | 路由组件 | 说明 |
|---|---|---|
| 商品分类 | /base/productCategory |
维护分类树，并在此配置分类属性与销售属性 |
| 商品品牌 | /base/productBrand |
维护商品品牌 |
| 商品分类属性 | /base/productProperty |
维护分类属性定义（原"商品属性"） |
| 商品管理 | /base/product、/base/productForm |
维护商品档案（基础信息、图片、SKU、组合商品） |
| 仓位商品管理 | /base/stockCellProduct |
维护商品与仓库仓位的关联 |
| 商品销售属性 | /base/productSaleProperty |
维护销售属性定义 |
二、三种核心属性总览
商品中心的三种属性承担不同的业务角色：
| 属性类型 | 业务意义 | 核心作用 |
|---|---|---|
| 商品分类属性 | 描述性扩展字段 | 为不同分类的商品补充结构化、可筛选的描述信息（如颜色、材质、保质期） |
| 商品销售属性 | SKU 生成维度 | 定义商品的销售规格维度（如颜色、尺码、版本），是拆分 SKU 的基础 |
| 仓位商品属性（仓位商品管理） | 位置关联 | 记录"哪个商品放在哪个仓库的哪个仓位"，支撑库存、拣货、盘点 |
说明：用户常说的"仓位商品属性"，在系统中对应的菜单名为 仓位商品管理，其本质是"商品 ↔ 仓位"的关联关系，而非字段型属性。
三、商品分类属性
3.1 意义
商品分类属性用于为不同的商品分类定义描述性的自定义字段。例如：
- 服装类商品需要"颜色"、"尺码"字段；
- 食品类商品需要"保质期"、"产地"字段；
- 数码类商品需要"内存"、"颜色"字段。
通过分类属性，系统无需为每种字段修改数据库表结构，即可让不同分类的商品录入结构化、可检索的扩展信息。
3.2 数据模型
| 表名 | 实体 | 作用 |
|---|---|---|
base_data_product_property |
ProductProperty | 属性定义（编码、名称、录入类型、属性类别、数据类型等） |
base_data_product_property_item |
ProductPropertyItem | 属性的可选值（属性值管理） |
base_data_product_category_property |
ProductCategoryProperty | 属性与分类的绑定关系 |
base_data_product_property_relation |
ProductPropertyRelation | 商品实际填写的属性值 |
3.3 关键字段与枚举
录入类型（columnType） —— 决定商品填写该属性时如何录入：
| 值 | 含义 | 说明 |
|---|---|---|
| 1 | 多选 | 从属性值中勾选多个 |
| 2 | 单选 | 从属性值中选一个 |
| 3 | 手动录入 | 自由填写，需指定数据类型 |
属性类别（propertyType） —— 决定属性的适用范围：
| 值 | 含义 | 说明 |
|---|---|---|
| 1 | 通用属性 | 可被任意分类绑定使用 |
| 2 | 指定分类属性 | 仅绑定到创建时指定的分类 |
| 3 | 无 | 暂不归类 |
数据类型（columnDataType） —— 仅"手动录入"（录入类型=3）时需指定：
| 值 | 含义 |
|---|---|
| 1 | 整数型 |
| 2 | 浮点型 |
| 3 | 字符型 |
| 4 | 日期型 |
| 5 | 时间型 |
| 6 | 日期时间型 |
是否必填（isRequired） —— 商品填写该属性时是否强制。
3.4 使用方法
第一步：维护属性定义（商品分类属性菜单）
- 进入「商品中心 → 商品分类属性」，点击「新增」。
- 填写编号、名称；设置是否必填、录入类型、属性类别。
- 若录入类型为「手动录入」，需再选择数据类型。
- 若录入类型为「多选」或「单选」，保存后通过「属性值管理」维护可选项（每个选项有编号、名称）。
第二步：将属性绑定到分类（商品分类菜单）
- 进入「商品中心 → 商品分类」，找到目标叶子分类（无子分类的分类）。
- 点击该分类的「分类属性配置」。
- 有两种绑定方式：
- 新增分类属性：直接在当前分类下新建一个"指定分类属性"，自动绑定到该分类；
- 选择已有：从已有的"通用属性"中勾选并绑定。
第三步：商品录入时填写属性值
- 新增/编辑商品时，系统根据商品所选的分类，自动加载该分类绑定的分类属性。
- 按录入类型填写：多选勾选多个属性值、单选选择一个、手动录入按数据类型录入。
- 填写结果保存在
base_data_product_property_relation表中。
3.5 注意事项
- 分类属性只能挂在叶子分类上；存在子分类的分类不能配置属性。
- 已配置分类属性（或已关联商品）的分类，不允许再新增子分类。
- 已被商品引用的属性无法删除。
- 独立菜单"商品分类属性"中属性类别仅支持「通用属性」与「无」；「指定分类属性」通过在分类页的"新增分类属性"创建。
- 录入类型在修改时不可更改。
四、商品销售属性
4.1 意义
商品销售属性用于定义商品的销售规格维度（如颜色、尺码、版本、规格），是拆分 SKU 的基础。通过销售属性，一个商品可以按维度组合出多个可独立定价、独立管理的 SKU。
4.2 数据模型
| 表名 | 实体 | 作用 |
|---|---|---|
base_data_product_sale_property_definition |
ProductSalePropertyDefinition | 销售属性定义（编码、名称、备注） |
base_data_product_sale_property_item |
ProductSalePropertyItem | 销售属性的可选值 |
base_data_product_category_sale_property_relation |
ProductCategorySalePropertyRelation | 销售属性与分类的绑定关系 |
4.3 关键字段
与分类属性不同，销售属性只需编号、名称、备注，没有录入类型、是否必填、数据类型等字段。销售属性的可选值统一通过「属性值管理」维护。
4.4 使用方法
第一步：维护销售属性定义（商品销售属性菜单）
- 进入「商品中心 → 商品销售属性」，点击「新增」。
- 填写编号、名称、备注。
- 保存后通过「属性值管理」维护可选值（如颜色属性下的"红 / 蓝 / 黑"）。
第二步：将销售属性绑定到分类（商品分类菜单）
- 进入「商品中心 → 商品分类」，找到目标叶子分类。
- 点击该分类的「销售属性配置」。
- 绑定方式与分类属性一致：「新增销售属性」或「选择已有」。
第三步：商品录入时生成 SKU
- 商品按分类绑定的销售属性，在 SKU 信息区域拆分出对应 SKU 组合。
- 每个 SKU 可独立设置采购价、销售价、零售价、主图、一品多码等。
4.5 注意事项
- 已被分类绑定的销售属性无法删除。
- 销售属性同样只能绑定到叶子分类。
五、仓位商品属性（仓位商品管理）
5.1 意义
"仓位商品管理"用于维护**"商品 ↔ 仓库 ↔ 仓位"**的关联关系，即记录某个商品存放在哪个仓库的哪个具体仓位。它为库存管理、拣货、盘点提供物理位置依据。
仓位分为两类，用于区分货品存放方式：
| 仓位类别（cellType） | 含义 |
|---|---|
| 1 | 货架仓位 |
| 2 | 存储仓位 |
5.2 数据模型
| 表名 | 实体 | 作用 |
|---|---|---|
base_data_stock_cell |
StockCell | 仓位定义（编码、名称、仓位类别、所属仓库） |
base_data_stock_cell_product |
StockCellProduct | 商品与仓位的关联关系 |
5.3 使用方法
第一步：维护仓位（仓库/门店中心）
- 在仓库（门店中心）详情中打开「仓位管理」，点击「新增」。
- 填写仓位编号（可自动生成）、名称，选择仓位类别（货架仓位/存储仓位）。
- 保存后仓位即挂靠在当前仓库下。
第二步：关联商品（仓位商品管理菜单）
- 进入「商品中心 → 仓位商品管理」。
- 按仓库、仓库名称、仓位编号、仓位名称、仓位类别查询仓位列表。
- 对某个仓位点击「商品管理」，在弹出的商品管理窗口中勾选要放入该仓位的商品；也可点击「管理所有商品」进行全局关联。
- 关联关系保存在
base_data_stock_cell_product表中。
5.4 注意事项
- 仓位编号在同一仓库内唯一。
- 一个商品可关联到多个仓位，一个仓位也可存放多个商品。
六、三者的区别与联系
| 维度 | 商品分类属性 | 商品销售属性 | 仓位商品属性 |
|---|---|---|---|
| 本质 | 描述性自定义字段 | SKU 生成维度 | 位置关联 |
| 挂载点 | 绑定到分类 | 绑定到分类 | 绑定到仓位 |
| 填写/生效位置 | 商品档案（属性值） | 商品 SKU | 商品 ↔ 仓位 |
| 是否有值字典 | 有（多选/单选需属性值） | 有（属性值） | 无（直接关联商品） |
| 典型用途 | 描述、检索、筛选 | 拆分 SKU、差异化定价 | 库存定位、拣货盘点 |
一句话总结：
- 分类属性回答"这个商品有什么描述特征"；
- 销售属性回答"这个商品可以按什么维度拆分售卖"；
- 仓位属性回答"这个商品实际放在哪里"。