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 啟動后端項目

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密鑰

更換依賴