主题
10 商品管理
版本：v3.0
所属端：后台管理
文档状态：已交付
1. 概述
1.1 背景与目标
商品管理是后台运营的核心模块，承载了商品从创建到下架的完整生命周期。运营人员通过本模块完成商品分类体系搭建、品牌管理、属性规格定义、商品信息录入、上下架控制等日常工作。
本模块的设计目标：
- 建立清晰的商品分类体系（两级树形结构）
- 支持品牌信息的完整管理
- 支持灵活的属性和规格定义，适配不同品类
- 提供高效的商品录入和编辑体验（含多规格SKU）
- 支持批量操作，提升运营效率
- 提供运费模板配置能力
1.2 目标用户
| 角色 | 使用场景 |
|---|---|
| 超级管理员 | 全部商品管理权限 |
| 商品管理员 | 商品增删改查、分类/品牌/属性管理 |
| 运营人员 | 商品查看、上下架、推荐设置 |
1.3 功能范围
| 功能模块 | 说明 | 优先级 |
|---|---|---|
| 商品分类管理 | 两级分类树的增删改查 | P0 |
| 品牌管理 | 品牌信息的增删改查 | P0 |
| 属性分类管理 | 定义属性模板（如"手机参数"） | P0 |
| 属性管理 | 在属性分类下定义具体属性和规格 | P0 |
| 商品列表 | 多条件筛选、搜索、分页 | P0 |
| 商品新增/编辑 | 完整商品信息录入（含多规格SKU） | P0 |
| 批量操作 | 批量上/下架、设为新品、设为推荐 | P1 |
| 运费模板 | 配置不同地区的运费规则 | P1 |
2. 功能详细设计
2.1 商品分类管理
页面结构
以树形列表展示两级分类结构。每个分类节点展示：分类名称、商品数量、导航栏显示状态、操作按钮（编辑/删除）。顶部有"新增分类"按钮。
编辑弹窗包含：上级分类选择、分类名称、排序值、是否显示、是否导航栏显示、分类图标、搜索关键词、描述。
业务规则
| 编号 | 规则描述 |
|---|---|
| BR-AP-01 | 分类最多两级：一级分类和二级分类 |
| BR-AP-02 | 一级分类无上级，二级分类必须指定上级 |
| BR-AP-03 | 删除分类时，若存在子分类或关联商品，则拒绝删除 |
| BR-AP-04 | "导航栏显示"控制该分类是否在前台首页分类导航中展示 |
| BR-AP-05 | "是否显示"控制该分类是否在前台可见 |
2.2 品牌管理
页面结构
品牌列表页支持关键词搜索和分页。每条品牌记录展示：品牌名称、首字母、Logo、排序、显示状态、关联商品数。支持新增/编辑/删除操作。
编辑表单包含：品牌名称、首字母、品牌Logo、专区大图、品牌故事、排序、是否显示。
业务规则
| 编号 | 规则描述 |
|---|---|
| BR-AP-10 | 品牌名称不可重复 |
| BR-AP-11 | 删除品牌时，若存在关联商品，则拒绝删除 |
| BR-AP-12 | 首字母用于品牌索引和快速定位 |
2.3 属性管理
页面结构
分为两层：属性分类（模板）→ 具体属性。
- 属性分类列表：如"手机参数模板"、"服装参数模板"
- 属性列表：某模板下的具体属性，分为"规格"和"参数"两种类型
业务规则
| 编号 | 规则描述 |
|---|---|
| BR-AP-20 | 属性分为两类：规格（用于SKU选择，如颜色/容量）和参数（用于详情展示，如屏幕尺寸） |
| BR-AP-21 | 属性的录入方式：手工录入或从预设列表选择 |
| BR-AP-22 | 商品分类关联属性分类后，该分类下的商品自动继承对应属性模板 |
| BR-AP-23 | 删除属性分类时，若已被商品分类关联，则拒绝删除 |
2.4 商品列表
页面结构
商品列表页顶部为筛选区域（关键词搜索、品牌筛选、分类筛选、上下架状态筛选），下方为商品表格，支持分页。
表格列：商品图片、商品名称、价格、货号、品牌、分类、销量、库存、排序、上架状态、新品标记、推荐标记、创建时间、操作。
业务规则
| 编号 | 规则描述 |
|---|---|
| BR-AP-30 | 支持按关键词（商品名称/货号）模糊搜索 |
| BR-AP-31 | 支持按品牌、分类、上下架状态组合筛选 |
| BR-AP-32 | 已删除商品不在列表中展示 |
2.5 商品新增/编辑
页面结构
商品编辑为多步骤表单，包含以下信息区块：
- 基本信息：商品名称、副标题、品牌、分类、货号、描述
- 价格与库存：销售价、原价、库存、库存预警值、单位、重量
- 规格与SKU：选择规格值组合，为每个SKU设定价格、库存、编码
- 商品图片：主图、画册图片（多张）
- 商品详情：富文本编辑器录入图文详情
- 商品参数：根据属性模板填写参数值
- 营销设置：新品标记、推荐标记、排序
- 服务与积分：服务标签、赠送积分、赠送成长值
- 运费模板：选择关联的运费模板
业务规则
| 编号 | 规则描述 |
|---|---|
| BR-AP-40 | 商品名称、品牌、分类、销售价为必填项 |
| BR-AP-41 | 多规格商品：选择规格值后自动生成SKU组合，每个SKU独立设定价格和库存 |
| BR-AP-42 | 商品总库存 = 所有SKU库存之和（多规格时） |
| BR-AP-43 | 新增商品默认为下架状态，需手动上架 |
| BR-AP-44 | 编辑已上架商品时，修改即时生效 |
| BR-AP-45 | 删除商品为逻辑删除，前台不再展示 |
2.6 批量操作
业务规则
| 编号 | 规则描述 |
|---|---|
| BR-AP-50 | 支持批量上架/下架（切换发布状态） |
| BR-AP-51 | 支持批量设为/取消新品 |
| BR-AP-52 | 支持批量设为/取消推荐 |
| BR-AP-53 | 批量操作前需勾选目标商品，未勾选时操作按钮禁用 |
2.7 运费模板
业务规则
| 编号 | 规则描述 |
|---|---|
| BR-AP-60 | 运费模板定义不同地区的配送费用规则 |
| BR-AP-61 | 商品关联运费模板后，前台下单时按模板计算运费 |
| BR-AP-62 | 未关联运费模板的商品默认免运费 |
3. 接口能力
| 能力名称 | 说明 | 是否需登录 |
|---|---|---|
| 分类树查询 | 返回两级分类层级结构 | 是 |
| 分类增删改 | 维护商品分类 | 是 |
| 品牌分页查询 | 支持关键词搜索 | 是 |
| 品牌全量查询 | 用于下拉选择 | 是 |
| 品牌增删改 | 维护品牌信息 | 是 |
| 属性分类列表 | 返回所有属性模板 | 是 |
| 属性列表 | 返回某模板下的属性/规格 | 是 |
| 商品列表查询 | 多条件筛选+分页 | 是 |
| 商品详情 | 返回完整编辑信息 | 是 |
| 商品增删改 | 商品全生命周期管理 | 是 |
| 批量状态操作 | 批量上/下架、新品、推荐 | 是 |
| 运费模板管理 | 运费模板增删改查 | 是 |
4. 核心数据实体
| 实体 | 业务含义 | 关键属性 |
|---|---|---|
| 商品分类 | 商品的品类归属（两级） | 名称、层级、上级分类、图标、显示状态、导航状态、排序 |
| 品牌 | 商品的品牌归属 | 名称、首字母、Logo、专区大图、品牌故事、显示状态 |
| 属性分类 | 属性模板（如"手机参数"） | 名称 |
| 属性 | 具体的规格或参数定义 | 名称、类型（规格/参数）、录入方式、可选值、排序 |
| 商品（SPU） | 标准产品单元 | 名称、副标题、品牌、分类、价格、库存、图片、详情、状态 |
| SKU | 具体规格组合 | 编码、价格、库存、规格数据、图片 |
| 运费模板 | 配送费用规则 | 名称、计费方式、各地区费用 |
实体关系：商品分类关联属性分类；商品归属品牌和分类；商品包含多个SKU；商品关联运费模板。
5. 验收标准
| 编号 | 验收条件 |
|---|---|
| AC-AP-01 | 分类树正确展示两级结构，增删改正常 |
| AC-AP-02 | 有子分类或商品时删除分类被拒绝 |
| AC-AP-03 | 品牌增删改查正常，有商品关联时删除被拒绝 |
| AC-AP-04 | 属性分类和属性管理正常 |
| AC-AP-05 | 商品列表筛选和搜索功能正确 |
| AC-AP-06 | 商品新增流程完整（基本信息→规格→图片→详情→参数） |
| AC-AP-07 | 多规格商品SKU生成正确，价格库存独立 |
| AC-AP-08 | 批量上/下架、新品、推荐操作正常 |
| AC-AP-09 | 商品删除后前台不再展示 |
| AC-AP-10 | 运费模板配置正常，前台下单时运费计算正确 |