# ZKMALL-B2B2C多商户-Uniapp用户端

**Repository Path**: zhenxi126/b2b2c-uniapp

## Basic Information

- **Project Name**: ZKMALL-B2B2C多商户-Uniapp用户端
- **Description**: ZKMALL商城-B2B2C多商户用户端、基于Uniapp + Vue3技术栈构建，系统采用前后端分离架构，支持 PC、H5、小程序、APP、多端统一部署，集成了商品、SKU、订单、完整下单、微信支付、营销推广、等核心功能模块，助力企业快速搭建高性能、为企业级电商平台提供一站式解决方案。
- **Primary Language**: TypeScript
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 69
- **Created**: 2025-05-29
- **Last Updated**: 2025-05-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ZKMALL-B2B2C多商户-Uniapp用户端
<a href="https://mallzk.com" target="_blank"><img src="doc/img/banner.png"/></a>

**ZKMall** 是一款基于当前流行技术组合 **SpringBoot3 + MybatisPlus + Shiro + JWT + XXL-Job + Redisson + Redis + Mysql + Vue3 + UniApp** **前后端分离 B2B2C多商户 Java电商系统**。系统功能全面，包含**商城、SKU、运费模板、素材库、小程序直播、拼团、砍价、商户管理、秒杀、优惠券、积分、分销、会员、充值、多门店等功能B2B2C电商商城系统，采用主流的互联网技术架构、全新的UI设计、支持集群部署、拥有完整的订单流程等，代码完全开源，没有任何二次封装，是一个非常适合二次开发的电商平台系统。
ZKMall 致力于为企业打造一个功能完整、易于维护且马上可以投入经营的 B2B2C JAVA商城系统模板,开箱即用。
#### 介绍
前端 框架与库
Vue3 + uni-app + axios + uview-ui

后台管理系统包含：
* **平台管理:** 系统设置、权限管理、数据统计等。
* **店铺管理:** 店铺入驻、店铺信息管理、店铺装修等。
* **商品管理:** 商品发布、编辑、分类、规格、库存管理等。
* **订单管理:** 订单创建、支付、发货、售后管理等。
* **规格管理:** 商品规格、属性管理。
* **权限管理:** 完善的角色和权限控制。
* **营销中心:** 拼团、砍价、秒杀、优惠券、积分、分销等多种营销工具。
* **会员管理:** 会员等级、积分管理、充值管理等。
* **物流管理:** 运费模板管理。
* **内容管理:** 素材库、文章管理等。
* **直播管理:** 小程序直播功能。
* **门店管理:** 多门店管理功能。
* 
## 演示地址
* **PC体验访问链接:** [https://shop.mallzk.com](https://shop.mallzk.com)
* **H5体验访问链接:** [https://shop.mallzk.com/h5](https://shop.mallzk.com/h5)

手机号注册即可
## 🛡️ 授权许可

除开源版本外，ZKMall 还提供商业版本的商城，欲知详情，请访问[商城官网](https://mallzk.com)。

本商城使用 **AGPLv3** 开源协议，请务必遵守 AGPLv3 的相关条款，或者联系作者获取商业授权：[https://mallzk.com](https://mallzk.com)

## 🔗 项目链接

* **JAVA 后台:** [https://gitee.com/zkmall/b2b2c](https://gitee.com/zkmall/b2b2c)
* **平台端 (Admin):** [https://gitee.com/zkmall/b2b2c-admin](https://gitee.com/zkmall/b2b2c-admin)
* **商家端 (Merchant):** [https://gitee.com/zkmall/b2b2c-merchant](https://gitee.com/zkmall/b2b2c-merchant)
* **uni-app (H5/小程序):** [https://gitee.com/zkmall/b2b2c-uniapp](https://gitee.com/zkmall/b2b2c-uniapp)

## 🛠️ 部署教程

### 1. 需要下载的项目

* **b2b2c:** Java 后端项目，提供小程序/后台 Vue 连接所需的 API 接口。
* **b2b2c-admin:** 后台管理员使用的前端项目 (Vue)。
* **b2b2c-merchant:** 后台商户管理员使用的前端项目 (Vue)。
* **b2b2c-uniapp:** H5/小程序前端项目 (uni-app)。

### 2. 环境准备

| 工具    | 版本    |
| ------- | ------- |
| JDK     | 17      |
| MySQL   | 8.0+    |
| Maven   | 3.8.3+  |
| Redis   | 5.0.0   |
| Node.js | 20.18.0 |

### 3. 后端服务配置 (b2b2c)

本地开发建议修改 `src/main/resources/application-admin-local.yml` 配置文件。

![输入图片说明](doc/img/image-20250518181218747.png)



接下来需要配置**快递信息**、**前后端加解密**、**管理员电话**以及**调用 App 刷新商品中间表信息的校验码**。

![输入图片说明](doc/img/wps1.jpg)

**配置说明:**

* **快递信息配置 (编号 1 和 2):** 您可以选择**快递鸟**或**快递100**进行配置。

  * **快递鸟:** 在 `cere_platform_express` 表中插入一条数据，`plat_user_id` 随意填写数字，`express_type` 填写 `1`。
  * **快递100:** 在 `cere_platform_express` 表中插入一条数据，`express_type` 填写 `2`。

* **RSA 秘钥配置 (编号 3):** 填写生成的 RSA 密钥，用于前后端数据加密解密。您可以使用 [https://apiked.com/rsa](https://apiked.com/rsa) 生成。

 ![输入图片说明](doc/img/wps2.jpg)

  请填写红色框框里的内容，**务必去除换行符**。

* **超级管理员电话配置 (编号 4):** 填写您的手机号码，用于开启超级管理员模式。只有在超级管理员授权的情况下，才能查看用户的完整手机号或用户名等敏感信息。

* **App 服务校验码配置 (编号 5):** 随机填写一个密码即可，用于调用 App 服务的刷新商品接口时的校验。

请根据您的实际需求修改配置文件。

**服务启动:**

```bash
# zkmall-admin
运行 com.shop.zkmall.admin.CereshopAdminApplication#main

# zkmall-app
运行 com.shop.zkmall.app.CereshopAppApplication#main

# zkmall-business
运行 com.shop.zkmall.business.CereshopBusinessApplication#main
```

### 4. 前端服务配置

配置以下两个模块的加解密配置：

- `b2b2c-admin-web`
- `b2b2c-merchant-web`

配置文件路径：`src/utils/rsaEncrypt.js`

修改对应的 `publicKey` 为您在 https://apiked.com/rsa 生成的 RSA 密钥中的 `publicKey`。

**前端服务启动:**

以下服务请在相应的模块目录下执行命令：

Bash

```
npm install
npm run dev
```

- `b2b2c-admin-web`
- `b2b2c-merchant-web`

**uni-app 服务启动:**

对于 `b2b2c-uniapp` 项目，请使用 **HBuilderX** 打开，然后在项目根目录下运行 `npm install`，之后在 HBuilderX 中进行编译并启动。

### 📦 目录结构

```
├── component             	   # 全局组件     
├── components                 # 全局组件
├── config                 	   # 项目配置文件
├── hooks                 	   # 自定义 Hooks 函数
├── mixins                 	   # Mixin 文件
├── public                     # 静态资源	  
├── pages                      # 页面组件   
├── static                     # 静态资源 
├── store                      # 状态管理代码
├── style                      # 全局样式文件
├── uni_modules                # uni-app 插件     
├── utils                      # 工具函数
├── zwx_category_page1         # 自定义页面目录1            
├── zwx_category_page2         # 自定义页面目录2          
├── App.vue               	   # 项目入口组件    
├── cereshop.ico               # 网站图标 
├── index.html                 # H5 端入口文件 
├── main.js                    # 项目入口 JS
├── manifest.json              # 项目配置文件   
├── package.json               # package.json   
├── pages.json                 # 页面路由配置文件
├── tsconfig.json              # TypeScript 配置文件
├── uni.scss                   # 全局 SCSS 样式文件
├── version.md                 # 版本说明文件	
└── vue.config.js              # vue-cli 配置                     
```


### 💬 提交反馈

- ZKMall 官网: https://mallzk.com
- 商业版源码购买，请联系商务微信。
- ZKMall 开源技术 QQ 群：**984772612**
- SpringBoot 版本商城，请点击 https://gitee.com/zkmall/b2b2c 查看主项目。
- 更多内容请查看主项目：https://gitee.com/zkmall/

感谢您的关注和使用 ZKMall！如有任何问题或建议，欢迎交流。

#### 参与贡献

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


#### 特技

1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
2.  Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
3.  你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
4.  [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
5.  Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
6.  Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)