ZKMall商城开源本地部署指南
1. 开发环境配置
以下是开发工具的最低版本要求。在继续之前，请务必安装所有必需的依赖项。
| 工具 | 版本 |
|---|---|
| JDK | 17 |
| MySQL | 5.7.3+ |
| Redis | 5.0+ |
| Maven | 3.9.5+ |
| NodeJS | 20.18.0+ |
1.1 安装资源
如需详细的安装指南，您可以参考以下教程：
- JDK: 菜鸟教程 Java 环境搭建
- MySQL: 菜鸟教程 MySQL 安装
- Maven: 菜鸟教程 Maven 安装
- Redis: 菜鸟教程 Redis 安装
- Git: 菜鸟教程 Git 安装与设置
- NodeJS: 菜鸟教程 NodeJS 安装
安装完成后，根据需要配置并启动 Redis 服务。
拉取项目
- zkmall-b2b2c：提供小程序/后台 Vue 连接所需的 API 接口。
- 后台接口 ：https://gitee.com/zkmall/b2b2c
2. 后端API项目 (zkmall-b2b2c)
zkmall-b2b2c 项目提供小程序/后台 Vue 连接所需的 API 接口。
- 仓库地址: https://gitee.com/zkmall/b2b2c
2.1 数据库配置与导入
2.1.1 MySQL 配置
导入数据库之前，请修改您的 my.cnf 配置文件（MySQL 5.7.3+ 版本需要配置）：
[mysqld]
# 默认使用“mysql_native_password”插件认证
# 如果使用的是mysql 8.0 需要设置 mysql_native_password，不然有些工具连不上
default_authentication_plugin=mysql_native_password
# 关闭 only_full_group_by
sql_mode=STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION
修改完成后，重启 MySQL 服务。
2.1.2 数据库导入
数据库的 SQL 文件请联系管理员获取。
2.1.3 应用配置
根据各个模块的 application.yml 文件以配置数据库连接及其他设置。
默认application-xx-open.yml(商家端同理)
2.1.4 XXL-JOB
项目目前使用的定时任务框架是 xxl-job。
2.2 Lombok 插件安装
Lombok 是一在 Java 开发过程中为了简化冗余和样板式代码（如 getter、setter）而出现的插件。项目中使用了这个插件，您需要安装该插件以便项目正常启动。
- 安装指南 (IntelliJ IDEA): IntelliJ IDEA 下使用 Lombok
2.3 启动后端项目
- 启动 Redis: 确保 Redis 正在运行，通常在
6379端口。 - 启动 MySQL: 确保您的 MySQL 服务已启动。
- 启动
xxl-job-admin: 启动xxl-job定时任务（可选）。 - 启动项目模块:
CereshopBusinessApplication: 启动商家端后台接口。CereshopAppApplication: 启动项目前端接口。CereshopAdminApplication: 启动项目平台端前端接口。
3. 前端项目
前端由三个独立的 Vue3 和 uni-app 项目组成。
- b2b2c-admin: 平台管理员使用的前端项目 (Vue3)。
- 仓库地址: https://gitee.com/zkmall/b2b2c-admin
- b2b2c-merchant: 商户后台管理员使用的前端项目 (Vue3)。
- 仓库地址: https://gitee.com/zkmall/b2b2c-merchant
- b2b2c-uniapp: H5/小程序前端项目 (uni-app)。
- 仓库地址: https://gitee.com/zkmall/b2b2c-uniapp
3.1 安装依赖
在您的终端中，进入每个前端项目的根目录，并运行以下命令安装依赖：
npm install
3.2 配置后端连接
建议使用 WebStorm 或 VS Code 进行前端开发。
修改每个前端项目中的 .env.development 文件以连接您的后端 API。
b2b2c-merchant 的示例配置（平台端和 Uni-app 类似）：
假设您的 Java 后端运行在 http://192.168.111.1:9004。您可以通过在命令行中输入 ipconfig 来找到您的本地 IP 地址。端口 9004 只是一个示例，应与您的 Java 项目 application.yml 中配置的端口一致。
# 如需添加更多环境变量，请以 VITE_APP_ 开头声明
# 在代码中使用 import.meta.env.VITE_APP_XXX 获取指定变量# 环境配置标识
NODE_ENV = 'development'# 统一接口域名
VITE_BASE_URL = 'http://192.168.111.1:9004'
3.3 运行前端项目
配置好后端连接后，您可以启动前端开发服务器。
npm run dev
3.4 Uni-app H5 端口配置
对于 b2b2c-uniapp 项目，您可以在 manifest.json 中配置 H5 开发服务器的端口：
"h5": {"devServer": {"port": 8080}
}
4. 其它
更换文件上传方式（已商家端为例）
配置阿里云oss密钥
更换依赖
