shuolol/PoJie
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
master
PoJie/ruoyi-modules/ruoyi-mall/README.md
T
shuolol b236048a24 first commit
2026-02-22 12:12:02 +08:00

7.6 KiB
Raw Permalink Blame History

电商模块 (ruoyi-mall)

模块简介

ruoyi-mall 是 PoJie 项目的电商核心业务模块，提供完整的电商功能，包括商品管理、购物车、订单管理、支付集成等。

模块结构

根据模块结构规划，ruoyi-mall 采用子模块拆分的方式，包含以下子模块：

  • ruoyi-mall-product - 商品中心 (SPU, SKU, 分类, 品牌, 属性)
  • ruoyi-mall-trade - 交易中心 (购物车, 订单, 售后)
  • ruoyi-mall-promotion - 营销中心 (活动, 拼团, 秒杀, 砍价)
  • ruoyi-mall-coupon - 优惠券中心 (独立拆分，便于复用)
  • ruoyi-mall-statistics - 统计中心 (交易分析, 会员分析)

各子模块详细说明请参考对应的 README.md 文件。

功能特性

1. 商品管理

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

2. SKU管理

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

3. 购物车管理

  • ✅ 添加/删除购物车
  • ✅ 购物车数量修改
  • ✅ 购物车选中状态管理
  • ✅ 购物车详情查询（包含商品和SKU信息）

4. 订单管理

  • ✅ 订单创建
  • ✅ 订单查询（列表、详情）
  • ✅ 订单取消
  • ✅ 订单状态管理
  • ✅ 订单支付集成

5. 支付集成

  • ✅ 与支付中心（ruoyi-pay）集成
  • ✅ 支付回调处理
  • ✅ 支付状态同步

数据库表

商品中心 (ruoyi-mall-product)

  • mall_product - 商品表
  • mall_sku - SKU表
  • mall_category - 商品分类表
  • mall_brand - 品牌表

交易中心 (ruoyi-mall-trade)

  • mall_cart - 购物车表
  • mall_order - 订单表
  • mall_order_item - 订单明细表
  • mall_after_sale - 售后申请表
  • mall_order_evaluate - 订单评价表
  • mall_order_coupon - 订单优惠券使用记录表

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

配置说明

在 application.yml 中添加以下配置：

ruoyi:
  mall:
    pay-app-id: 1  # 支付应用ID
    pay-notify-url: https://your-domain.com/app/mall/pay/notify  # 支付回调地址

API接口

移动端接口

商品接口

  • GET /app/mall/product/list - 查询商品列表
  • GET /app/mall/product/{id} - 查询商品详情
  • GET /app/mall/product/{productId}/skus - 查询商品SKU列表

商品分类接口

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

品牌接口

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

购物车接口

  • GET /app/mall/cart/list - 查询购物车列表
  • GET /app/mall/cart/detail/list - 查询购物车详情列表（包含商品信息）
  • POST /app/mall/cart - 添加购物车
  • PUT /app/mall/cart - 修改购物车
  • DELETE /app/mall/cart/{ids} - 删除购物车
  • DELETE /app/mall/cart/clear - 清空购物车
  • PUT /app/mall/cart/selected/{id} - 更新选中状态
  • PUT /app/mall/cart/selected/batch - 批量更新选中状态

订单接口

  • POST /app/mall/order/submit - 提交订单并发起支付
  • GET /app/mall/order/list - 查询订单列表
  • GET /app/mall/order/{id} - 查询订单详情
  • PUT /app/mall/order/cancel/{id} - 取消订单
  • POST /app/mall/order/pay/notify - 支付回调（由支付中心调用）

优惠券接口

  • GET /app/mall/coupon/available/list - 查询可领取的优惠券列表
  • GET /app/mall/coupon/{id} - 获取优惠券详情
  • GET /app/mall/coupon/user/list - 查询用户优惠券列表
  • GET /app/mall/coupon/user/available/list - 查询用户可用优惠券列表
  • GET /app/mall/coupon/user/{id} - 获取用户优惠券详情
  • POST /app/mall/coupon/user/receive/{couponId} - 领取优惠券

管理端接口

商品管理

  • GET /mall/product/list - 查询商品列表
  • GET /mall/product/{id} - 查询商品详情
  • POST /mall/product - 新增商品
  • PUT /mall/product - 修改商品
  • DELETE /mall/product/{ids} - 删除商品
  • PUT /mall/product/status/{id} - 上架/下架商品

商品分类管理

  • 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} - 删除商品分类

优惠券管理

  • GET /mall/coupon/list - 查询优惠券列表（分页）
  • GET /mall/coupon/{id} - 获取优惠券详情
  • POST /mall/coupon - 新增优惠券
  • PUT /mall/coupon - 修改优惠券
  • DELETE /mall/coupon/{ids} - 删除优惠券
  • POST /mall/coupon/export - 导出优惠券列表
  • PUT /mall/coupon/changeStatus/{id} - 启用/禁用优惠券

用户优惠券管理

  • GET /mall/coupon/user/list - 查询用户优惠券列表（分页）
  • GET /mall/coupon/user/{id} - 获取用户优惠券详情
  • DELETE /mall/coupon/user/{ids} - 删除用户优惠券
  • POST /mall/coupon/user/export - 导出用户优惠券列表
  • POST /mall/product/category/export - 导出商品分类列表

品牌管理

  • 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 - 导出品牌列表

SKU管理

  • GET /mall/sku/list - 查询SKU列表
  • GET /mall/sku/{id} - 查询SKU详情
  • GET /mall/sku/product/{productId} - 根据商品ID查询SKU列表
  • POST /mall/sku - 新增SKU
  • PUT /mall/sku - 修改SKU
  • DELETE /mall/sku/{ids} - 删除SKU

订单管理

  • GET /mall/order/list - 查询订单列表
  • GET /mall/order/{id} - 查询订单详情
  • PUT /mall/order - 修改订单
  • DELETE /mall/order/{ids} - 删除订单
  • PUT /mall/order/delivery/{id} - 订单发货

业务流程

订单提交流程

  1. 用户选择商品（从购物车或直接购买）
  2. 调用 /app/mall/order/submit 提交订单
  3. 系统创建订单和订单明细
  4. 调用支付中心创建支付单
  5. 返回支付参数给前端
  6. 前端调起支付
  7. 支付成功后，支付中心回调 /app/mall/order/pay/notify
  8. 系统更新订单状态并扣减库存

购物车流程

  1. 用户浏览商品，选择SKU
  2. 调用 /app/mall/cart 添加到购物车
  3. 如果购物车中已存在该SKU，则更新数量
  4. 用户可以在购物车中修改数量、选中状态
  5. 提交订单时，从购物车获取商品信息
  6. 订单创建成功后，删除购物车中的商品

依赖模块

  • ruoyi-pay - 支付中心模块
  • ruoyi-common-* - 通用工具模块

注意事项

  1. 库存管理：订单支付成功后才扣减库存，避免超卖
  2. 幂等性：支付回调需要保证幂等处理
  3. 地址管理：当前版本地址信息简化处理，后续可扩展地址表
  4. 订单号生成：使用时间戳+随机字符串生成唯一订单号

待完善功能

商品中心

  • 商品属性管理
  • 商品规格模板
  • 商品搜索功能

交易中心

  • ✅ 订单评价功能
  • ✅ 售后管理功能（退款、退货、换货）
  • 地址管理模块（可考虑集成到会员模块）
  • 订单优惠券使用记录

营销中心

  • 营销活动管理
  • 拼团功能
  • 秒杀功能
  • 砍价功能

优惠券中心

  • 优惠券管理
  • 用户优惠券功能
  • 优惠券统计

统计中心

  • 交易分析
  • 会员分析
  • 商品分析
  • 营销分析
Reference in New Issue View Git Blame Copy Permalink