# ds-project

**Repository Path**: tji/ds-project

## Basic Information

- **Project Name**: ds-project
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-20
- **Last Updated**: 2026-04-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 多商户电商平台

<div align="center">

**基于 Spring Boot 3.x + Vue 3 + Uni-app 的多商户电商解决方案**

</div>

## 项目概览

本项目是一套完整的多商户电商平台解决方案，包含：

| 端 | 技术栈 | 说明 |
|---|--------|------|
| 后端 | Java 17 + Spring Boot 3.2 + MyBatis-Plus | RESTful API |
| 管理后台 | Vue 3 + Element Plus + TypeScript | PC端运营管理 |
| 用户端 | Uni-app + uView UI | 小程序 + APP |
| 商户端 | Uni-app + uView UI | 小程序 + APP（第二阶段） |

## 项目结构

```
E:\GSD\ds-project\
├── doc/                          # 项目文档
│   ├── 01-产品需求文档/
│   ├── 02-技术方案设计/
│   ├── 03-数据库设计/
│   ├── 04-接口设计/
│   └── 05-运维文档/
│
├── ktmall-backend/               # 后端项目
│   ├── multi-merchant-common/   # 公共模块
│   ├── multi-merchant-system/    # 系统模块
│   ├── multi-merchant-user/      # 用户模块
│   ├── multi-merchant-merchant/  # 商户模块
│   ├── multi-merchant-goods/     # 商品模块
│   ├── multi-merchant-order/     # 订单模块
│   ├── multi-merchant-marketing/ # 营销模块
│   ├── multi-merchant-pay/       # 支付模块
│   └── ktmall-app/               # 启动模块
│
├── ktmall-admin/                # 后台管理端（Vue3）
├── ktmall-user-app/              # 用户端（Uni-app）
├── ktmall-merchant-app/          # 商户端（Uni-app）
└── README.md                    # 项目说明
```

## 快速开始

### 1. 环境要求

| 工具 | 版本要求 |
|------|----------|
| JDK | 17+ |
| Maven | 3.8+ |
| MySQL | 8.0 |
| Redis | 6.x+ |
| Node.js | 16+ |
| HBuilderX | 最新版 |
| 微信开发者工具 | 最新版 |

### 2. 后端启动

```bash
# 1. 创建数据库
mysql -u root -p < doc/03-数据库设计/db_init.sql

# 2. 修改配置
# 编辑 ktmall-backend/ktmall-app/src/main/resources/application-dev.yml

# 3. 编译项目
cd ktmall-backend
mvn clean install -DskipTests

# 4. 启动项目
cd ktmall-app
mvn spring-boot:run
```

访问 http://localhost:8080/doc.html 查看 API 文档

### 3. 管理后台启动

```bash
cd ktmall-admin
npm install
npm run dev
```

访问 http://localhost:5173

### 4. 用户端启动

```bash
cd ktmall-user-app
npm install
npm run dev:mp-weixin
```

使用微信开发者工具打开 `dist/dev/mp-weixin`

### 5. 商户端启动

```bash
cd ktmall-merchant-app
npm install
npm run dev:mp-weixin
```

## 技术亮点

- **Spring Boot 3.x** - 最新版本， GraalVM 支持
- **MyBatis-Plus** - CRUD 增强，分页插件
- **JWT** - 无状态认证，支持 Token 刷新
- **Redis** - 缓存加速，接口防刷
- **Druid** - 数据库连接池，SQL 监控
- **Vue 3 Composition API** - 组合式 API
- **Uni-app** - 一套代码，多端运行

## 功能模块

### 后台管理端
- [x] 登录/权限管理
- [x] 商户管理（审核、列表、分类）
- [x] 商品管理（审核、列表、分类）
- [x] 订单管理（列表、退款）
- [x] 营销管理（优惠券、秒杀、满减）
- [x] 数据统计
- [ ] 系统管理（完善中）

### 用户端
- [x] 登录注册（账号密码、短信验证码、微信）
- [x] 首页（轮播图、分类、热门商品）
- [x] 商品分类
- [x] 商品详情
- [x] 购物车
- [x] 订单流程
- [x] 个人中心
- [ ] 支付功能（开发中）
- [ ] 优惠券（开发中）

### 商户端
- [x] 商户首页
- [ ] 登录（开发中）
- [ ] 商品管理（开发中）
- [ ] 订单管理（开发中）
- [ ] 数据统计（开发中）

## 数据库

共 24 张核心业务表，详见 `doc/03-数据库设计/db_init.sql`

## 接口统计

| 模块 | 接口数 |
|------|--------|
| 用户端 | ~45 |
| 商户端 | ~20 |
| 管理后台 | ~55 |
| **总计** | **~120** |

## License

Private Project - All Rights Reserved