Phase 0: 环境搭建指南

前置条件

JDK 1.8+
Maven 3.6+
MySQL 5.7+ / 8.0+
Redis 6+
Git

Step 1: 设置 Lilishop 源码工作树

# 进入 enagic 项目目录
cd /mnt/e/workspace/enagic/代码/enagic-lilishop

# 创建 Lilishop 源码工作树（不复制文件，只建立 git 关联）
git worktree add ../lilishop-worktree /mnt/e/workspace/iwt/lilishop

# 确认工作树创建成功
git worktree list

预期输出：

/mnt/e/workspace/enagic/代码/enagic-lilishop   38f3a1c [master]
/mnt/e/workspace/enagic/代码/lilishop-worktree  abc1234 master

Step 2: 初始化数据库

# 登录 MySQL
mysql -u root -p

# 创建数据库（如果尚未创建）
CREATE DATABASE IF NOT EXISTS lilishop DEFAULT CHARACTER SET utf8mb4;

# 执行 Enagic DDL
SOURCE /mnt/e/workspace/enagic/代码/enagic-lilishop/enagic-plugin/DB/enagic_init.sql;

Step 3: 构建 Lilishop 源码

cd /mnt/e/workspace/enagic/代码/lilishop-worktree

# 编译所有模块（跳过测试以加快速度）
mvn clean install -DskipTests -q

# 预期输出：BUILD SUCCESS（如果依赖完整）

Step 4: 集成 enagic-plugin

方式 A：在 Lilishop pom.xml 中添加模块（推荐）

cd /mnt/e/workspace/iwt/lilishop

# 将 enagic-plugin 目录链接到 Lilishop 模块目录
cp -r /mnt/e/workspace/enagic/代码/enagic-lilishop/enagic-plugin ./

# 在 Lilishop pom.xml 的 <modules> 中添加
# <module>enagic-plugin</module>

# 编辑 pom.xml
# 在 </modules> 前添加：
#     <module>enagic-plugin</module>

方式 B：通过 Maven 依赖引用

cd /mnt/e/workspace/enagic/代码/enagic-lilishop/enagic-plugin

# 安装 enagic-plugin 到本地 Maven 仓库
mvn clean install -DskipTests -q

# 然后在 Lilishop 的 pom.xml dependencies 中添加：
# <dependency>
#     <groupId>com.enagic</groupId>
#     <artifactId>enagic-entity</artifactId>
#     <version>1.0.0</version>
# </dependency>
# <dependency>
#     <groupId>com.enagic</groupId>
#     <artifactId>enagic-api</artifactId>
#     <version>1.0.0</version>
# </dependency>
# ... 其他模块同理

Step 5: 重新构建并验证

cd /mnt/e/workspace/iwt/lilishop

# 完整编译
mvn clean compile -DskipTests

# 如果无编译错误，说明集成成功

Step 6: 配置并启动

# 复制配置文件
cp /mnt/e/workspace/enagic/代码/enagic-lilishop/enagic-plugin/config/application-enagic.yml \
   /path/to/lilishop/config/application.yml

# 编辑配置（填写数据库、AI API Key 等）
vim /path/to/lilishop/config/application.yml

# 启动 Lilishop
java -jar /path/to/lilishop/lilishop.jar

Step 7: 验证集成

# 验证 API 是否注册成功
curl http://localhost:8080/enagic/buyer/ai/hot-questions

# 预期返回 JSON

常见问题

编译报错：找不到 com.dan 包

→ 说明 Lilishop 源码未正确编译。执行 mvn clean install -DskipTests 安装所有 Lilishop 模块。

编译报错：找不到 enagic-entity

→ 先 cd enagic-plugin && mvn install -DskipTests 安装 enagic 模块。

数据库报错：表已存在

→ DDL 中使用 DROP TABLE IF EXISTS，重新执行不会冲突。如果报错外键约束，执行 SET FOREIGN_KEY_CHECKS = 0; 后重试。

Redis 未连接

→ 确保 Redis 服务启动，且 application.yml 中的 Redis 配置正确。

目录结构（集成后）

/path/to/lilishop/
├── lilishop.jar                    # Lilishop 主 JAR
├── config/
│   └── application.yml             # 配置文件（含 enagic 配置）
├── lib/                            # 外部依赖 JAR
│   └── (enagic-*.jar)              # 如果用方式 B 部署
├── enagic-plugin/                   # Enagic 插件（方式 A）
│   ├── enagic-entity/
│   ├── enagic-api/
│   ├── enagic-admin/
│   └── enagic-consumer/
└── ... Lilishop 原目录

PHASE0_SETUP.md 3.9 KB Permalink History Raw