# my-sales

**Repository Path**: gotfocus/my-sales

## Basic Information

- **Project Name**: my-sales
- **Description**: 这是一个功能完整的多端购物系统，包含用户端、商家端、骑手端和PC管理后台四个前端应用，以及一个统一的后端服务。系统支持完整的购物流程，包括：
- 用户浏览商品、加入购物车、下单支付
- 商家管理商品、处理订单
- 骑手接单、配送商品
- 管理员后台管理
- **Primary Language**: Java
- **License**: MulanPSL-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-31
- **Last Updated**: 2026-06-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 多端购物系统

## 项目简介

这是一个功能完整的多端购物系统，包含用户端、商家端、骑手端和PC管理后台四个前端应用，以及一个统一的后端服务。系统支持完整的购物流程，包括：
- 用户浏览商品、加入购物车、下单支付
- 商家管理商品、处理订单
- 骑手接单、配送商品
- 管理员后台管理

## 项目结构

```
.
├── backend/                 # 后端服务（Spring Boot）
│   ├── src/
│   │   ├── main/
│   │   │   ├── java/com/mallsystem/
│   │   │   │   ├── controller/      # 控制器层
│   │   │   │   ├── service/         # 服务层
│   │   │   │   ├── mapper/          # 数据访问层
│   │   │   │   ├── entity/          # 实体类
│   │   │   │   ├── dto/             # 数据传输对象
│   │   │   │   ├── config/          # 配置类
│   │   │   │   ├── interceptor/     # 拦截器
│   │   │   │   ├── annotation/      # 自定义注解
│   │   │   │   ├── common/          # 公共类
│   │   │   │   ├── exception/       # 异常处理
│   │   │   │   └── util/            # 工具类
│   │   │   └── resources/
│   │   │       ├── mapper/          # MyBatis XML映射
│   │   │       ├── application.yml  # 配置文件
│   │   │       └── schema.sql       # 数据库初始化脚本
│   │   └── test/                    # 测试代码
│   └── pom.xml
├── frontend/               # 前端项目
│   ├── user/               # 用户端（Vue3 + Vant）
│   ├── merchant/           # 商家端（Vue3 + Vant）
│   ├── rider/              # 骑手端（Vue3 + Vant）
│   └── admin/              # 管理后台（Vue3 + Element Plus）
├── docs/                   # 项目文档
│   ├── database-design.md  # 数据库设计文档
│   ├── api-docs.md         # API接口文档
│   ├── deployment-guide.md # 系统部署指南
│   └── operations-guide.md # 运维指南
└── README.md
```

## 技术栈

### 后端

- Spring Boot 2.7.18
- MyBatis-Plus 3.5.5
- MySQL 8.0
- JWT 认证
- Lombok
- Hutool 工具库

### 前端

- Vue 3.3.4
- Vue Router 4.2.4
- Pinia 2.1.6（状态管理）
- Vite 4.4.9（构建工具）
- Axios 1.5.0（HTTP客户端）
- Vant 4.6.6（移动端UI）
- Element Plus 2.3.14（管理后台UI）

## 功能特性

### 用户端
- 用户注册/登录
- 商品浏览与搜索
- 购物车管理
- 订单创建与支付
- 订单查看与确认收货
- 商品评价

### 商家端
- 店铺管理
- 商品发布与管理
- 订单处理（发货）
- 销售数据查看

### 骑手端
- 接单管理
- 配送状态更新
- 配送记录查询

### 管理后台
- 用户管理
- 店铺审核
- 商品管理
- 订单监控
- 数据统计

## 快速开始

### 环境要求

- JDK 1.8+
- Maven 3.6+
- MySQL 8.0+
- Node.js 14+

### 数据库准备

1. 创建数据库：
```sql
CREATE DATABASE mall_system DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
```

2. 修改配置文件 `backend/src/main/resources/application.yml` 中的数据库连接信息。

### 后端启动

```bash
cd backend
mvn clean install -DskipTests
mvn spring-boot:run
```
后端服务将在 `http://localhost:8080` 启动

### 前端启动

#### 用户端
```bash
cd frontend/user
npm install
npm run dev
```
访问：`http://localhost:3000`

#### 商家端
```bash
cd frontend/merchant
npm install
npm run dev
```
访问：`http://localhost:3001`

#### 骑手端
```bash
cd frontend/rider
npm install
npm run dev
```
访问：`http://localhost:3002`

#### 管理后台
```bash
cd frontend/admin
npm install
npm run dev
```
访问：`http://localhost:3003`

## 测试账号

系统预置了以下测试账号（密码均为 `123456`）：

| 角色 | 用户名 | 说明 |
|------|--------|------|
| 管理员 | admin | 系统超级管理员 |
| 商家 | merchant1 | 测试商家账号 |
| 用户 | user1 | 测试普通用户 |
| 骑手 | rider1 | 测试骑手账号 |

## 文档

完整的项目文档请查看 `docs/` 目录：

- [数据库设计文档](docs/database-design.md) - 数据库表结构、ER图、数据字典
- [API接口文档](docs/api-docs.md) - RESTful API接口说明
- [部署指南](docs/deployment-guide.md) - 系统部署步骤、Docker配置
- [运维指南](docs/operations-guide.md) - 日常运维、备份恢复、监控告警

## 开发规范

- 后端代码使用中文注释
- 遵循RESTful API设计规范
- 使用 @Slf4j 注解进行日志记录
- 使用统一的响应格式 Result<T>
- 代码提交前请运行测试确保功能正常

## 部署

详细部署步骤请参考 [部署指南](docs/deployment-guide.md)。

## 许可证

MIT License