# 微服务商城

**Repository Path**: sun_zhengxun/cloud-mall

## Basic Information

- **Project Name**: 微服务商城
- **Description**: 微服务商城
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-12-16
- **Last Updated**: 2026-08-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# 商城

#### 介绍
基于微服务架构的电商平台系统。系统后端采用 Spring Cloud 技术栈，实现了商品管理、订单处理、会员服务、营销活动、仓储物流等核心电商功能，前端管理后台基于 Vue.js 和 Element UI 构建。

#### 软件架构

*   **核心框架**: Spring Boot + Spring Cloud
*   **服务发现与配置**: Nacos
*   **数据库 ORM**: MyBatis-Plus
*   **API 网关**: Spring Cloud Gateway
*   **前端技术**: Vue.js + Element UI
*   **文件存储**: 阿里云 OSS (通过 mall-third-party 模块集成)

#### 模块说明

项目采用模块化设计，各模块职责独立，通过 API 进行通信：

*   **`mall-common`**: 公共基础模块。提供系统级工具类（如分页 `PageUtils`、响应封装 `R`）、通用异常处理、以及 `HTMLFilter` 和 `SQLFilter` 等安全防护组件。
*   **`mall-gateway`**: API 网关。统一处理外部请求的路由、鉴权及跨域配置（`MallCorsConfiguration`）。
*   **`mall-product` (商品服务)**:
    *   管理商品分类（`Category`）、品牌（`Brand`）、属性（`Attr`）。
    *   处理 SKU（库存量单位）和 SPU（标准产品单位）的核心数据。
    *   管理商品评价（`SpuComment`）及回复。
*   **`mall-order` (订单服务)**:
    *   处理订单全生命周期流程（`Order`, `OrderItem`）。
    *   管理订单设置（`OrderSetting`）、支付信息（`PaymentInfo`）及退款流程（`RefundInfo`, `OrderReturnApply`）。
*   **`mall-member` (会员服务)**:
    *   管理用户信息（`MemberEntity`）、会员等级（`MemberLevel`）。
    *   处理用户收货地址（`MemberReceiveAddress`）、积分（`IntegrationChangeHistory`）及成长值（`GrowthChangeHistory`）。
    *   集成 Feign 客户端调用优惠券服务。
*   **`mall-coupon` (营销服务)**:
    *   优惠券管理（`Coupon`）及领取历史（`CouponHistory`）。
    *   满减优惠（`SkuFullReduction`, `SkuLadder`）及会员专享价（`MemberPrice`）。
    *   秒杀活动管理（`SeckillPromotion`, `SeckillSession`, `SeckillSkuRelation`）。
    *   首页内容管理（`HomeAdv`, `HomeSubject`）。
*   **`mall-ware` (仓储服务)**:
    *   仓库信息管理（`WareInfo`）。
    *   库存管理（`WareSku`）及库存锁定。
    *   采购单管理（`Purchase`, `PurchaseDetail`）。
    *   库存工作单处理（`WareOrderTask`, `WareOrderTaskDetail`）。
*   **`mall-third-party` (第三方服务)**:
    *   集成阿里云 OSS，用于处理文件上传（`OssController`）。
*   **`mall-web` (前端管理)**:
    *   基于 renren-fast-vue 模板的 Vue.js 项目，提供可视化操作界面。

#### 安装教程

1.  **环境准备**
    *   确保开发环境已安装 JDK 1.8+。
    *   安装 Maven 3.x。
    *   安装 Node.js (建议 v14.x+) 和 npm/yarn。
    *   准备 MySQL 数据库。
    *   准备并启动 Nacos 服务（用于配置中心和服务注册）。

2.  **数据库初始化**
    *   创建数据库（例如 `cloud_mall`）。
    *   导入项目 SQL 文件（请查阅项目根目录或各模块下的 `.sql` 文件）。

3.  **修改配置**
    *   修改各模块（如 `mall-product`, `mall-order` 等）下的 `src/main/resources/application.yml`。
    *   配置数据库连接信息（URL, 用户名, 密码）。
    *   配置 Nacos 地址 (`spring.cloud.nacos.config.server-addr` 和 `spring.cloud.nacos.discovery.server-addr`)。

4.  **启动后端服务**
    *   使用 IDE 或 Maven 命令依次启动各个服务模块（建议顺序：common -> gateway -> product -> order -> member -> coupon -> ware -> third-party）。

5.  **启动前端**
    *   进入 `mall_web` 目录。
    *   执行 `npm install` 安装项目依赖。
    *   执行 `npm run dev` 启动开发服务器。
    *   访问浏览器地址（通常是 `http://localhost:8001`）进入管理后台。

#### 使用说明

1.  **后台管理**:
    *   使用管理员账号登录前端系统。
    *   在 **商品** 模块维护商品分类和品牌。
    *   在 **营销** 模块创建优惠券和秒杀活动。
    *   在 **订单** 和 **库存** 模块跟踪订单状态和库存变动。
2.  **API 调用**:
    *   所有后端服务均通过网关暴露 API，基础路径通常为 `http://网关IP:端口/服务名/接口路径`。
    *   例如调用商品列表接口：`GET /mall-product/product/spuinfo/list`。

#### 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request