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

**Repository Path**: michael4j/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**: 12
- **Created**: 2025-06-13
- **Last Updated**: 2025-06-13

## 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** 开源技术 QQ 群：**984772612**

## 🛡️ 授权许可
- ZKMall官网: https://mallzk.com
- 除开源版本外，**ZKMall** 还提供企业商业版本的高级版商城，欲知详情，请访问[zkmall商城官网产品列表](https://mallzk.com/price.html)。
- 本商城使用 **AGPLv3** 开源协议，请务必遵守 AGPLv3 的相关条款，如需要商用授权联系作者获取商业授权
- 企业版**高级版**源码购买,商用授权，请联系商务微信。
-    <img src="doc/zkmall/img.png" width="150" height="150"/>

## 🔗 整个项目链接
* **b2b2c:** Java 后端项目，提供小程序/后台 Vue 连接所需的 API 接口。
* **JAVA 后台:** [https://gitee.com/zkmall/b2b2c](https://gitee.com/zkmall/b2b2c)
* **b2b2c-admin:** 平台管理员使用的前端项目 (Vue3)。
* **平台端 (Admin):** [https://gitee.com/zkmall/b2b2c-admin](https://gitee.com/zkmall/b2b2c-admin)
* **b2b2c-merchant:** 商户后台管理员使用的前端项目 (Vue3)。
* **商家端 (Merchant):** [https://gitee.com/zkmall/b2b2c-merchant](https://gitee.com/zkmall/b2b2c-merchant)
* **b2b2c-uniapp:** H5/小程序前端项目 (uni-app)。
* **uni-app (H5/小程序):** [https://gitee.com/zkmall/b2b2c-uniapp](https://gitee.com/zkmall/b2b2c-uniapp)


## 🛠️ 启动教程

### 1. 需要下载的项目(必须)

* **平台端 (Admin):** [https://gitee.com/zkmall/b2b2c-admin](https://gitee.com/zkmall/b2b2c-admin)

### 📦 目录结构

```
├── 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 配置                     
```

### 2. 环境准备(必须)

| 工具    | 版本         |
| ------- |------------|
| Node.js | 20.18.0 以上 |

如果不了解怎么安装nodejs的，可以参考   [新手nodejs相关安装教程](https://www.runoob.com/nodejs/nodejs-install-setup.html)

***注意,注意,注意***  项目要求使用 [pnpm](https://www.pnpm.cn/)  包管理工具

使用编辑器打开项目，在根目录执行以下命令安装依赖

### 3.检查接口地址(必须)

检查 `b2b2c-admin-web` 下的 `.env.development` 文件中配置的 `VITE_BASE_URL` 配置项，确保该地址指向了正确的后端服务地址。
[.env.development](.env.development)
![api.png](doc/img/api.png)

VITE_BASE_URL = '后端接口的地址'
```
本地部署后端
VITE_BASE_URL = 'http://127.0.0.1:9003'

不懂后端的直接使用开源仓库后台地址
VITE_BASE_URL = 'https://ceres.zkthink.com/adminapi'
```

### 4.安装依赖启动项目(必须)
**前端服务启动:**

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

Bash

- `b2b2c-uniapp`


```
先加载依赖包命令
pnpm i
```

```
然后根据下面操作在HBuilderX运行
```
![run.png](doc/img/run.png)
运行成功
![run-dev.png](doc/img/run-dev.png)



## 📸 运行相关截图

### 用户移动端
![h5-1.jpg](doc/img/h5/h5-1.jpg)
![h5-2.jpg](doc/img/h5/h5-2.jpg)

### 用户PC端
<img src="doc/img/pc/pc-1.jpg" width = '33%'>
<img src="doc/img/pc/pc-2.jpg" width = '33%'>
<img src="doc/img/pc/pc-3.jpg" width = '33%'>
<img src="doc/img/pc/pc-4.jpg" width = '33%'>
<img src="doc/img/pc/pc-5.jpg" width = '33%'>
<img src="doc/img/pc/pc-6.jpg" width = '33%'>


### 💬 提交反馈

- **在项目使用过程遇到任何问题.可以在群里进行反馈**
- ZKMall 开源技术 QQ 群：**984772612**
- SpringBoot 版本商城，请点击 https://gitee.com/zkmall/b2b2c 查看主项目。
- 更多内容请查看主项目：https://gitee.com/zkmall/

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

## 感谢Star，Fork,我们会时刻更新~

#### 参与贡献

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

## 更多信息请查看官网 [https://mallzk.com](https://mallzk.com)

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

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