# 电商项目开发小组

**Repository Path**: wang110110/mall-plus

## Basic Information

- **Project Name**: 电商项目开发小组
- **Description**: （电商）商城项目商城项目商城项目
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 273
- **Created**: 2026-04-14
- **Last Updated**: 2026-05-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# Mall-Plus 电商平台

Mall-Plus 是一个基于 Spring Boot 构建的综合性电商平台系统，支持多端应用（管理端、买家端），涵盖商品管理、订单处理、会员管理、店铺运营、促销活动等核心电商功能。

## 项目架构

```
mall-plus/
├── mall-admin-web/      # 管理端后台服务
├── mall-consumer-web/  # 买家端服务
├── mall-common-web/    # 公共接口服务
├── mall-common/        # 公共基础模块
├── mall-member/        # 会员与店铺模块
├── mall-order/         # 订单与支付模块
└── mall-product/       # 商品管理模块
```

## 技术栈

- **框架**: Spring Boot 2.x
- **数据库**: MySQL
- **缓存**: Redis
- **搜索引擎**: Elasticsearch
- **消息队列**: RabbitMQ
- **ORM**: MyBatis-Plus
- **API文档**: Swagger2

## 模块说明

### mall-admin-web 管理端后台
提供后台管理系统接口，包括：
- 商品管理（商品、分类、品牌、规格、参数）
- 订单管理（订单、售后、结算单）
- 会员管理（会员、店铺、店员）
- 促销活动（优惠券、秒杀活动）
- 系统设置（菜单、角色、部门配置）

### mall-consumer-web 买家端
面向消费者的移动端/H5接口服务：
- 购物车
- 订单创建与支付
- 商品浏览与搜索
- 会员评价
- 优惠券领取
- 收货地址管理

### mall-common-web 公共接口
文件管理与基础数据服务：
- 文件上传（支持阿里云、华为云、腾讯云OSS）
- 地区数据查询
- 站点基础信息

### mall-common 公共模块
公共基础组件：
- 常量与枚举定义
- 工具类（日期、加密、HTTP请求等）
- 公共模型与异常处理
- 事件与消息定义

### mall-member 会员模块
会员与店铺管理：
- 会员账号管理
- 店铺入驻与审核
- 店员管理与角色
- 运费模板
- 物流配置

### mall-order 订单模块
订单与支付核心：
- 购物车
- 订单创建与处理
- 支付与收银台
- 售后处理
- 结算与对账
- 订单评价

### mall-product 商品模块
商品管理核心：
- 商品基本信息
- 商品分类
- 品牌管理
- 规格与参数
- 商品审核上下架

## 主要特性

- **微服务架构**: 模块解耦，独立部署
- **分布式事务**: 基于消息队列的最终一致性
- **缓存策略**: 多级缓存，支持高并发
- **搜索功能**: Elasticsearch 商品检索
- **支付集成**: 微信/支付宝支付支持
- **OSS存储**: 支持多种云存储方案

## 快速开始

### 环境要求

- JDK 11+
- Maven 3.6+
- MySQL 5.7+
- Redis 5.0+
- RabbitMQ 3.8+

### 构建运行

```bash
# 克隆项目
git clone https://gitee.com/wang110110/mall-plus.git

# 构建项目
mvn clean package -DskipTests

# 运行各个模块（需要先配置数据库和Redis）
java -jar mall-admin-web/target/mall-admin-web.jar
java -jar mall-consumer-web/target/mall-consumer-web.jar
```

### Docker部署

```bash
# 构建Docker镜像
docker build -t mall-plus/mall-admin-web -f mall-admin-web/Dockerfile mall-admin-web/
docker build -t mall-plus/mall-consumer-web -f mall-consumer-web/Dockerfile mall-consumer-web/
docker build -t mall-plus/mall-common-web -f mall-common-web/Dockerfile mall-common-web/
```

## 配置说明

各模块配置文件位于 `src/main/resources/` 目录：
- `application.yml` - 主配置文件
- `application-dev.yml` - 开发环境配置
- `application-test.yml` - 测试环境配置
- `application-local.yml` - 本地环境配置

## API文档

启动服务后访问 Swagger 文档：
- 管理端: `http://localhost:8080/swagger-ui.html`
- 买家端: `http://localhost:8081/swagger-ui.html`

## 目录结构规范

```
src/main/java/com/jzo2o/mall/
├── [模块名]/
│   ├── controller/   # 控制层
│   ├── service/     # 业务层
│   ├── mapper/      # 数据访问层
│   ├── model/      # 数据模型
│   │   ├── domain/   # 实体类
│   │   ├── dto/      # 数据传输对象
│   │   └── enums/    # 枚举定义
│   └── config/      # 配置类
```

## 参与贡献

欢迎提交 Pull Request，请确保代码符合项目规范。

## 许可证

本项目仅供学习交流使用。