ZKMall商城开源本地部署指南

1. 开发环境配置

以下是开发工具的最低版本要求。在继续之前，请务必安装所有必需的依赖项。

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 启动后端项目

1. 启动 Redis: 确保 Redis 正在运行，通常在 6379 端口。
2. 启动 MySQL: 确保您的 MySQL 服务已启动。
3. 启动 xxl-job-admin: 启动 xxl-job 定时任务（可选）。
4. 启动项目模块:
   • 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密钥

更换依赖