PoJie/ruoyi-modules/ruoyi-mall/ruoyi-mall-product/README.md

# 商品中心模块 (ruoyi-mall-product)

## 模块简介

`ruoyi-mall-product` 是商城系统的商品中心模块，负责商品全生命周期管理，包括商品(SPU)、SKU、分类、品牌等核心功能。

## 功能特性

### 1. 商品管理 (SPU)

- ✅ 商品CRUD操作
- ✅ 商品上架/下架
- ✅ 商品浏览量和销量统计
- ✅ 商品详情管理

### 2. SKU管理

- ✅ SKU CRUD操作
- ✅ 库存管理
- ✅ 库存扣减和恢复
- ✅ 规格属性管理

### 3. 商品分类管理 ✅

- ✅ 分类树形结构查询（支持三级分类）
- ✅ 分类CRUD操作（列表、详情、新增、修改、删除）
- ✅ 分类排序
- ✅ 分类导出功能
- ⏳ 分类图标管理（字段已支持，需前端集成文件上传功能）

### 4. 品牌管理 ✅

- ✅ 品牌CRUD操作（列表、详情、新增、修改、删除）
- ✅ 品牌描述管理
- ✅ 品牌排序
- ✅ 品牌状态管理（启用/禁用）
- ✅ 品牌导出功能
- ⏳ 品牌Logo上传（字段已支持，需前端集成文件上传功能）

## 数据库表

- `mall_product` - 商品表
- `mall_sku` - SKU表
- `mall_category` - 商品分类表
- `mall_brand` - 品牌表
- `mall_attribute_template` - 属性模板表
- `mall_attribute` - 属性表
- `mall_attribute_value` - 属性值表
- `mall_product_attribute` - 商品属性关联表

详细表结构请参考：`script/sql/ry_mall.sql`

## 模块结构

```
org.dromara.mall.product
├── controller
│   ├── admin          // 管理端API
│   │   ├── AdminMallCategoryController.java
│   │   ├── AdminMallBrandController.java
│   │   ├── AdminMallAttributeTemplateController.java
│   │   ├── AdminMallAttributeController.java
│   │   ├── AdminMallAttributeValueController.java
│   │   └── AdminMallProductAttributeController.java
│   └── app            // 用户端API
│       ├── AppMallCategoryController.java
│       └── AppMallBrandController.java
├── domain
│   ├── MallCategory.java
│   ├── MallBrand.java
│   ├── MallAttributeTemplate.java
│   ├── MallAttribute.java
│   ├── MallAttributeValue.java
│   ├── MallProductAttribute.java
│   ├── bo             // 业务对象
│   │   ├── MallCategoryBo.java
│   │   ├── MallBrandBo.java
│   │   ├── MallAttributeTemplateBo.java
│   │   ├── MallAttributeBo.java
│   │   ├── MallAttributeValueBo.java
│   │   └── MallProductAttributeBo.java
│   └── vo             // 视图对象
│       ├── MallCategoryVo.java
│       ├── MallBrandVo.java
│       ├── MallAttributeTemplateVo.java
│       ├── MallAttributeVo.java
│       ├── MallAttributeValueVo.java
│       └── MallProductAttributeVo.java
├── mapper
│   ├── MallCategoryMapper.java
│   ├── MallBrandMapper.java
│   ├── MallAttributeTemplateMapper.java
│   ├── MallAttributeMapper.java
│   ├── MallAttributeValueMapper.java
│   └── MallProductAttributeMapper.java
├── service
│   ├── MallCategoryService.java
│   ├── MallBrandService.java
│   ├── MallAttributeTemplateService.java
│   ├── MallAttributeService.java
│   ├── MallAttributeValueService.java
│   ├── MallProductAttributeService.java
│   └── impl
│       ├── MallCategoryServiceImpl.java
│       ├── MallBrandServiceImpl.java
│       ├── MallAttributeTemplateServiceImpl.java
│       ├── MallAttributeServiceImpl.java
│       ├── MallAttributeValueServiceImpl.java
│       └── MallProductAttributeServiceImpl.java
├── enums              // 枚举类
│   └── AttributeType.java
└── config
    └── MallProductAutoConfiguration.java
```

## 依赖模块

- `ruoyi-common-*` - 通用工具模块

## API接口

### 管理端接口

#### 商品分类管理 (`/mall/product/category`)

- `GET /mall/product/category/list` - 查询商品分类列表（分页）
- `GET /mall/product/category/tree` - 查询商品分类树形列表
- `GET /mall/product/category/{id}` - 获取商品分类详情
- `POST /mall/product/category` - 新增商品分类
- `PUT /mall/product/category` - 修改商品分类
- `DELETE /mall/product/category/{ids}` - 删除商品分类
- `POST /mall/product/category/export` - 导出商品分类列表

#### 品牌管理 (`/mall/product/brand`)

- `GET /mall/product/brand/list` - 查询品牌列表（分页）
- `GET /mall/product/brand/{id}` - 获取品牌详情
- `POST /mall/product/brand` - 新增品牌
- `PUT /mall/product/brand` - 修改品牌
- `DELETE /mall/product/brand/{ids}` - 删除品牌
- `POST /mall/product/brand/export` - 导出品牌列表

### 移动端接口

#### 商品分类 (`/app/mall/product/category`)

- `GET /app/mall/product/category/tree` - 查询商品分类树形列表（仅启用分类）

#### 品牌 (`/app/mall/product/brand`)

- `GET /app/mall/product/brand/list` - 查询品牌列表（仅启用品牌）

#### 属性模板管理 (`/mall/product/attribute/template`)

- `GET /mall/product/attribute/template/list` - 查询属性模板列表（分页）
- `GET /mall/product/attribute/template/{id}` - 获取属性模板详情
- `POST /mall/product/attribute/template` - 新增属性模板
- `PUT /mall/product/attribute/template` - 修改属性模板
- `DELETE /mall/product/attribute/template/{ids}` - 删除属性模板
- `POST /mall/product/attribute/template/export` - 导出属性模板列表

#### 属性管理 (`/mall/product/attribute`)

- `GET /mall/product/attribute/list` - 查询属性列表（分页）
- `GET /mall/product/attribute/{id}` - 获取属性详情
- `GET /mall/product/attribute/template/{templateId}` - 根据模板ID查询属性列表
- `POST /mall/product/attribute` - 新增属性
- `PUT /mall/product/attribute` - 修改属性
- `DELETE /mall/product/attribute/{ids}` - 删除属性
- `POST /mall/product/attribute/export` - 导出属性列表

#### 属性值管理 (`/mall/product/attribute/value`)

- `GET /mall/product/attribute/value/list` - 查询属性值列表（分页）
- `GET /mall/product/attribute/value/{id}` - 获取属性值详情
- `GET /mall/product/attribute/value/attribute/{attributeId}` - 根据属性ID查询属性值列表
- `POST /mall/product/attribute/value` - 新增属性值
- `PUT /mall/product/attribute/value` - 修改属性值
- `DELETE /mall/product/attribute/value/{ids}` - 删除属性值
- `POST /mall/product/attribute/value/export` - 导出属性值列表

#### 商品属性关联管理 (`/mall/product/attribute/product`)

- `GET /mall/product/attribute/product/{id}` - 获取商品属性关联详情
- `GET /mall/product/attribute/product/product/{productId}` - 根据商品ID查询商品属性关联列表
- `POST /mall/product/attribute/product` - 新增商品属性关联
- `POST /mall/product/attribute/product/batch` - 批量新增商品属性关联
- `POST /mall/product/attribute/product/product/{productId}` - 保存商品属性关联（先删除旧的，再插入新的）
- `PUT /mall/product/attribute/product` - 修改商品属性关联
- `DELETE /mall/product/attribute/product/{ids}` - 删除商品属性关联
- `DELETE /mall/product/attribute/product/product/{productId}` - 根据商品ID删除商品属性关联

### 5. 商品属性管理 ✅

- ✅ 属性模板管理
    - ✅ 属性模板CRUD操作
    - ✅ 属性模板绑定分类（可选）
    - ✅ 属性模板导出功能
- ✅ 属性管理
    - ✅ 属性CRUD操作
    - ✅ 属性类型管理（文本、数字、日期、枚举）
    - ✅ 属性绑定模板（可选）
    - ✅ 属性必填设置
    - ✅ 属性导出功能
- ✅ 属性值管理
    - ✅ 属性值CRUD操作
    - ✅ 属性值绑定属性
    - ✅ 属性值排序
    - ✅ 属性值导出功能
- ✅ 商品属性关联
    - ✅ 商品关联属性值
    - ✅ 批量保存商品属性
    - ✅ 根据商品ID查询属性
    - ✅ 支持枚举类型属性值选择
    - ✅ 支持文本/数字/日期类型自定义值

## 待实现功能
    - [ ] 规格模板定义
    - [ ] 规格值管理
    - [ ] 规格模板与商品关联
- [ ] 商品搜索功能
    - [ ] 全文搜索（集成Elasticsearch或类似方案）
    - [ ] 商品筛选（按分类、品牌、价格等）