# shop-mall

**Repository Path**: zhbdream/shop-mall

## Basic Information

- **Project Name**: shop-mall
- **Description**: 基于若依的自营商城开源样板（管理后台 ShopAdmin + uni-app 移动端 shopApp），含堂食扫码扩展。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-07-27
- **Last Updated**: 2026-07-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Shop — 自营商城（管理后台 + 移动端）

基于 **若依（RuoYi）** 二次开发的开源商城样板，包含：

| 目录 | 说明 |
|------|------|
| [`ShopAdmin/`](ShopAdmin/) | Java 后端 + Thymeleaf 管理后台 + 移动端 REST API |
| [`shopApp/`](shopApp/) | uni-app 移动端（H5 / 微信小程序） |

支持自营商城下单、会员、营销、库存，以及堂食/桌台扫码点餐扩展。

## 界面预览

更多截图见 [`ShopAdmin/doc/界面截图.md`](ShopAdmin/doc/界面截图.md)。

### 管理后台

| 工作台 | 商品管理 | 订单管理 |
|:---:|:---:|:---:|
| ![工作台](ShopAdmin/doc/img/PC后台/pc-工作台.png) | ![商品管理](ShopAdmin/doc/img/PC后台/pc-商品管理.png) | ![订单管理](ShopAdmin/doc/img/PC后台/pc-商品订单管理.png) |

| 堂食看板 | 门店桌台 | 客服聊天 |
|:---:|:---:|:---:|
| ![堂食看板](ShopAdmin/doc/img/PC后台/pc-商品堂食看板.png) | ![桌台](ShopAdmin/doc/img/PC后台/pc-门店桌台管理.png) | ![客服](ShopAdmin/doc/img/PC后台/pc-客服聊天.png) |

### 移动端

| 首页 | 分类 | 商品详情 | 购物车 |
|:---:|:---:|:---:|:---:|
| <img src="ShopAdmin/doc/img/移动端/商城首页.png" width="180" alt="首页" /> | <img src="ShopAdmin/doc/img/移动端/商城分类.png" width="180" alt="分类" /> | <img src="ShopAdmin/doc/img/移动端/商城-产品详情.png" width="180" alt="详情" /> | <img src="ShopAdmin/doc/img/移动端/商城-购物车.png" width="180" alt="购物车" /> |

| 订单 | 我的 | 登录 | 客服 |
|:---:|:---:|:---:|:---:|
| <img src="ShopAdmin/doc/img/移动端/商城-订单列表.png" width="180" alt="订单" /> | <img src="ShopAdmin/doc/img/移动端/商城-我的.png" width="180" alt="我的" /> | <img src="ShopAdmin/doc/img/移动端/商城-登录.png" width="180" alt="登录" /> | <img src="ShopAdmin/doc/img/移动端/商城客服聊天.png" width="180" alt="客服" /> |

## 技术栈一览

- **后端**：Java 17、Spring Boot、MyBatis、Shiro、JWT、MySQL 8、阿里云 OSS、t-io WebSocket  
- **前端**：uni-app（Vue 3）、TypeScript  

## 快速开始

### 1. 数据库

```sql
CREATE DATABASE shop DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
```

导入脱敏演示库：

```bash
mysql -u root -p shop < ShopAdmin/sql/shop.sql
```

说明见 [`ShopAdmin/sql/README.md`](ShopAdmin/sql/README.md)。

### 2. 后端

```bash
cd ShopAdmin
# 复制本地配置并填写密钥（勿提交）
cp shop-admin/src/main/resources/application-local.yml.example \
   shop-admin/src/main/resources/application-local.yml

mvn clean package -DskipTests
# 启动时启用 local profile，或改用环境变量
java -jar shop-admin/target/shop-admin.jar --spring.profiles.active=druid,local
```

默认管理后台：`http://localhost/`（账号见 SQL 说明）。详细步骤见 [`ShopAdmin/README.md`](ShopAdmin/README.md)。

### 3. 移动端

```bash
cd shopApp
npm install
# 修改 config/index.ts 中的 baseUrl，或参考 config/index.example.ts
npm run dev:h5
# 微信小程序：在 HBuilderX / 微信开发者工具中打开，并填写 manifest.json 的 appid
```

详见 [`shopApp/README.md`](shopApp/README.md)。

## 功能概览

- 商品 / SKU / 分类 / 标签 / 评价  
- 购物车、订单、地址、售后  
- Banner、优惠券、秒杀、搜索运营  
- 会员登录（短信 mock / 密码）、收藏、余额充值  
- 在线客服（WebSocket）  
- 供应商、采购、库存流水  
- 酒馆堂食：门店、桌台扫码、点餐与结算（支付可 mock）  

## 开源前须知

- 仓库内配置与 SQL 已脱敏；**生产密钥请用环境变量或 `application-local.yml`**，勿提交。  
- 短信、部分微信支付默认 **mock**，需自行对接短信服务商与微信商户。  
- 基于若依 MIT 二次开发，请保留若依版权声明。  

## 文档

| 文档 | 路径 |
|------|------|
| 后端说明 | [ShopAdmin/README.md](ShopAdmin/README.md) |
| 移动端说明 | [shopApp/README.md](shopApp/README.md) |
| 界面截图 | [ShopAdmin/doc/界面截图.md](ShopAdmin/doc/界面截图.md) |
| 数据库脚本 | [ShopAdmin/sql/README.md](ShopAdmin/sql/README.md) |
| 安全说明 | [SECURITY.md](SECURITY.md) |
| 设计文档 | [ShopAdmin/doc/](ShopAdmin/doc/) |

## 许可证

本项目采用 [MIT License](LICENSE)。后端基于 [RuoYi](https://gitee.com/y_project/RuoYi)（MIT）二次开发，详见 `ShopAdmin/LICENSE` 与根目录 `NOTICE`。