产品管理

概述

本文档描述了Mall电商系统的产品管理组件。产品管理模块为管理员提供了创建、更新、查询和管理产品及其相关信息（如分类、属性、SKU、定价和促销设置）的功能。

有关品牌管理的信息，请参阅品牌与分类管理。有关详细的产品属性处理，请参阅产品属性管理。

核心组件

产品管理模块由多个关键组件组成，它们协同工作以提供全面的产品管理能力。

来源

产品数据结构

Mall中的产品实体非常全面，包含各种相关实体，共同构成了一个完整的产品数据模型。

来源

产品创建流程

在Mall系统中创建产品涉及多个步骤和相关实体。以下是产品创建的详细工作流程

来源

产品管理操作

产品管理模块提供了贯穿产品生命周期的全面操作。

核心产品管理功能

操作	端点	描述
创建产品	`POST /product/create`	创建新产品，包含所有相关信息，如SKU、价格和属性
更新产品	`POST /product/update/{id}`	更新现有产品及其相关信息
获取产品详情	`GET /product/updateInfo/{id}`	检索产品详情以进行编辑
列出产品	`GET /product/list`	检索带过滤选项的产品列表（分页）
简单列表	`GET /product/simpleList`	按名称或产品代码搜索产品
更新审核状态	`POST /product/update/verifyStatus`	更新产品审核状态（待定、已批准、已拒绝）
更新发布状态	`POST /product/update/publishStatus`	更新产品发布状态（已发布或未发布）
更新推荐状态	`POST /product/update/recommendStatus`	标记产品为推荐或非推荐
更新新品状态	`POST /product/update/newStatus`	标记产品为新品或非新品
更新删除状态	`POST /product/update/deleteStatus`	软删除或恢复产品

来源

产品更新流程

更新产品需要仔细处理相关实体。系统必须删除并重新插入相关记录以维护数据完整性。

来源

产品分类管理

产品分类以层级结构组织，便于更好地组织和导航产品。

分类数据结构

来源

分类管理操作

操作	端点	描述
创建分类	`POST /productCategory/create`	创建新的产品分类
更新分类	`POST /productCategory/update/{id}`	更新现有产品分类
列出分类	`GET /productCategory/list/{parentId}`	按父ID检索分类列表（分页）
获取分类	`GET /productCategory/{id}`	按ID检索单个分类
删除分类	`POST /productCategory/delete/{id}`	删除产品分类
更新导航状态	`POST /productCategory/update/navStatus`	更新分类导航显示状态
更新显示状态	`POST /productCategory/update/showStatus`	更新分类通用显示状态
带子分类列表	`GET /productCategory/list/withChildren`	检索所有分类及其子分类

来源

mall-admin/src/main/java/com/macro/mall/controller/PmsProductCategoryController.java31-117

分类管理流程

在创建或更新产品分类时，系统会处理基本分类信息以及它与产品属性的关系。

来源

SKU管理

库存单位 (SKU) 代表产品的特定变体，具有独特的属性（如颜色、尺寸）和自身的库存跟踪。

SKU数据处理

在产品创建和更新过程中，系统会以特殊方式处理SKU

对于新SKU，系统会在未提供时生成唯一的SKU代码。
在更新过程中，系统会识别新、已更新和已删除的SKU。
SKU代码遵循特定格式：YYYYMMDD + 4位产品ID + 3位索引。

来源

产品状态管理

产品管理系统允许管理员控制产品的各种状态标志，从而影响它们在商店中的显示和处理方式。

产品状态类型

状态类型	描述	端点
审核状态	控制产品审批状态	`POST /product/update/verifyStatus`
发布状态	控制产品是否对客户可见	`POST /product/update/publishStatus`
推荐状态	控制产品是否出现在推荐部分	`POST /product/update/recommendStatus`
新品状态	控制产品是否标记为新品	`POST /product/update/newStatus`
删除状态	软删除功能	`POST /product/update/deleteStatus`

每个状态更新操作都接受产品ID列表和新状态值，允许同时对多个产品进行批量操作。

来源

产品系统管理若干相关实体，这些实体增强了产品信息和功能。

会员价格：不同会员等级的特殊定价。
价格阶梯：基于数量的折扣（多买多优惠）。
满减优惠：基于门槛的折扣（满X减Y）。
产品属性值：自定义属性和规格。
专题关联：与促销专题/主题的关联。
优待区域关联：与优待区域的关联。

所有这些相关实体都通过通用的relateAndInsertList辅助方法进行管理，该方法负责正确设置产品ID和批量插入。

来源

与其他模块的集成

产品管理模块与多个其他系统组件集成，以提供完整的功能。

系统集成点

产品分类：产品被组织到分类中，分类是单独管理的。
产品属性：产品具有属性（规格型和参数型），这些属性是单独定义的。
品牌管理：产品与品牌相关联。
搜索模块：产品在创建或更新时需要被索引到搜索引擎中。
订单管理：产品通过SKU与订单连接。
促销管理：产品参与各种促销活动。

产品是Mall系统的核心实体，几乎连接到所有其他主要组件。

来源

结论

产品管理模块是Mall电商系统的核心组件，为产品、分类和相关信息提供了全面的管理能力。该模块的设计支持灵活且详细的产品配置，通过SKU支持复杂定价模型、库存跟踪和产品变体。将产品相关功能分离到独立的控制器和服务中，确保了代码结构良好且易于维护。