AI_Team/hzhub
4
0
Fork 0
Code Issues Pull Requests Actions Packages Projects 1 Releases Wiki Activity

refactor: 将 RuoYi 标记替换为 HZHub

Browse Source
This commit is contained in:
大壮
2026-03-27 06:42:14 +00:00
parent 849adec937
commit f115a793a7
988 changed files with 4836 additions and 4590 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
docs/README.md
View File

@@ -1,6 +1,6 @@
# HZHub 汇智中台
> 基于 RuoYi-AI 构建的企业级业务中台系统
> 基于 HZHub-AI 构建的企业级业务中台系统
## 项目概述
@@ -56,7 +56,7 @@ HZHub（汇智中台）是面向企业级市场的业务中台系统，集成 AI
```
foshanhuiya/hzhub/
├── hzhub-ai/ # AI服务（基于ruoyi-ai，Spring Boot 4.0）
├── hzhub-ai/ # AI服务（基于hzhub-ai，Spring Boot 4.0）
├── hzhub-erp/ # ERP服务（Spring Boot 4.0）
├── hzhub-gateway/ # API网关（Spring Boot 4.0）
├── hzhub-admin/ # 管理后台前端

6
docs/architecture/README.md
View File

@@ -4,7 +4,7 @@
### 1.1 项目背景
HZHub（汇智中台）是基于 RuoYi-AI 构建的企业级业务中台系统，旨在：
HZHub（汇智中台）是基于 HZHub-AI 构建的企业级业务中台系统，旨在：
- 对内包装对接 ERP 系统
- 对外打通企业微信
- 提供 AI 能力赋能业务
@@ -90,7 +90,7 @@ public interface ErpApi {
### 4.2 AI 服务接口
复用 ruoyi-ai 提供的接口，通过网关暴露。
复用 hzhub-ai 提供的接口，通过网关暴露。
## 5. 部署架构
@@ -115,7 +115,7 @@ public interface ErpApi {
|------|------|---------|
| SQL Server 2008 R2 驱动兼容性 | ERP 服务无法启动 | 预留双数据源，可切换 |
| Spring Boot 4.0 较新 | 第三方库适配问题 | 优先使用官方 starter |
| ruoyi-ai 早期阶段 | API 可能变化 | 复制代码而非 fork，自主可控 |
| hzhub-ai 早期阶段 | API 可能变化 | 复制代码而非 fork，自主可控 |
## 7. 后续待办

46
docs/learnings/01-ruoyi-ai-backend-review.md
View File

@@ -1,7 +1,7 @@
# RuoYi-AI 后端项目审查报告
# HZHub-AI 后端项目审查报告
> 审查时间：2026-03-26
> 项目路径：/data/ruoyi-ai/ruoyi-ai/
> 项目路径：/data/hzhub-ai/hzhub-ai/
---
@@ -11,7 +11,7 @@
| 属性 | 内容 |
|------|------|
| 项目名称 | RuoYi-AI |
| 项目名称 | HZHub-AI |
| 定位 | 企业级AI助手平台 |
| 版本 | 3.0.0 |
| 技术栈 | Spring Boot 3.5.8 + Spring AI + LangChain4j |
@@ -33,20 +33,20 @@
### 2.1 整体架构
```
ruoyi-ai/
hzhub-ai/
├── pom.xml # 父POM，版本统一管理
├── ruoyi-admin/ # 管理后台模块（Spring Boot启动类）
├── ruoyi-common/ # 公共组件库（25个子模块）
│ ├── ruoyi-common-core # 核心工具类
│ ├── ruoyi-common-chat # AI相关公共类
│ ├── ruoyi-common-satoken # Sa-Token认证
│ ├── ruoyi-common-redis # Redis封装
│ ├── ruoyi-common-mybatis # MyBatis Plus封装
├── hzhub-admin/ # 管理后台模块（Spring Boot启动类）
├── hzhub-common/ # 公共组件库（25个子模块）
│ ├── hzhub-common-core # 核心工具类
│ ├── hzhub-common-chat # AI相关公共类
│ ├── hzhub-common-satoken # Sa-Token认证
│ ├── hzhub-common-redis # Redis封装
│ ├── hzhub-common-mybatis # MyBatis Plus封装
│ └── ... # 其他公共模块
├── ruoyi-extend/ # 扩展模块
└── ruoyi-modules/ # 业务模块
├── hzhub-extend/ # 扩展模块
└── hzhub-modules/ # 业务模块
├── ruoyi-chat/ # AI核心模块（聊天、知识库、MCP）
├── ruoyi-aiflow/ # 流程编排模块
├── hzhub-aiflow/ # 流程编排模块
├── ruoyi-workflow/ # 工作流模块
├── ruoyi-system/ # 系统管理模块
└── ruoyi-generator/ # 代码生成器
@@ -55,9 +55,9 @@ ruoyi-ai/
### 2.2 模块依赖关系
```
ruoyi-admin (启动模块)
├── ruoyi-modules/* (业务模块)
│ └── ruoyi-common/* (公共组件)
hzhub-admin (启动模块)
├── hzhub-modules/* (业务模块)
│ └── hzhub-common/* (公共组件)
```
**设计特点**：
@@ -149,7 +149,7 @@ public interface SqlAgent extends Agent {
2. **工具声明**：明确可用工具及其使用顺序
3. **类型安全**：通过接口定义输入输出
### 4.2 ruoyi-aiflow 模块（流程编排）
### 4.2 hzhub-aiflow 模块（流程编排）
#### 4.2.1 架构设计
@@ -256,7 +256,7 @@ MCP工具类型：
```xml
<dependency>
<groupId>com.ruoyi</groupId>
<artifactId>ruoyi-common-tenant</artifactId>
<artifactId>hzhub-common-tenant</artifactId>
</dependency>
```
@@ -266,7 +266,7 @@ MCP工具类型：
### 7.1 架构设计借鉴
| 方面 | RuoYi-AI实践 | HZHub应用 |
| 方面 | HZHub-AI实践 | HZHub应用 |
|------|-------------|-----------|
| 模块化 | 25个common子模块 | 提取ERP适配公共组件 |
| 多模块 | modules独立部署 | AI/ERP/Gateway分离 |
@@ -298,7 +298,7 @@ hzhub-ai/
├── modules/
│ ├── hzhub-chat/ # AI聊天（复用ruoyi-chat）
│ ├── hzhub-erp/ # ERP服务（新增）
│ └── hzhub-aiflow/ # 流程编排（复用ruoyi-aiflow）
│ └── hzhub-aiflow/ # 流程编排（复用hzhub-aiflow）
└── hzhub-admin/ # 启动模块
```
@@ -316,7 +316,7 @@ hzhub-ai/
### 8.2 升级建议
1. **保持RuoYi-AI版本**：使用当前稳定版3.5.8
1. **保持HZHub-AI版本**：使用当前稳定版3.5.8
2. **独立ERP服务**：避免双数据源复杂性
3. **逐步迁移**：先复用chat模块，再扩展ERP功能
@@ -334,7 +334,7 @@ hzhub-ai/
### 9.2 下一步行动
1. 复用 `ruoyi-chat` 模块作为 `hzhub-ai` 基础
2. 复用 `ruoyi-aiflow` 模块作为流程编排引擎
2. 复用 `hzhub-aiflow` 模块作为流程编排引擎
3. 开发 `hzhub-erp` 模块，参考SQL Agent模式
4. 整合三个模块，构建HZHub完整后端

14
docs/learnings/02-ruoyi-admin-frontend-review.md
View File

@@ -1,7 +1,7 @@
# RuoYi-Admin 管理后台审查报告
# HZHub-Admin 管理后台审查报告
> 审查时间：2026-03-26
> 项目路径：/data/ruoyi-ai/ruoyi-admin/
> 项目路径：/data/hzhub-ai/hzhub-admin/
---
@@ -11,7 +11,7 @@
| 属性 | 内容 |
|------|------|
| 项目名称 | RuoYi-AI Admin |
| 项目名称 | HZHub-AI Admin |
| 定位 | 企业级AI助手平台 - 管理后台 |
| 技术栈 | Vue 3 + Vben Admin + Ant Design Vue |
| 构建工具 | Vite + pnpm + Turbo |
@@ -32,7 +32,7 @@
### 2.1 Monorepo架构
```
ruoyi-admin/ # 根目录
hzhub-admin/ # 根目录
├── apps/ # 应用目录
│ └── web-antd/ # Ant Design Vue版本（主应用）
├── packages/ # 共享包目录
@@ -254,7 +254,7 @@ const [BasicTable, tableApi] = useVbenVxeGrid({
### 6.1 架构设计借鉴
| 方面 | RuoYi-Admin实践 | HZHub应用 |
| 方面 | HZHub-Admin实践 | HZHub应用 |
|------|-----------------|-----------|
| Monorepo | pnpm workspace + Turbo | hzhub-admin采用同样结构 |
| 组件封装 | useVbenVxeGrid通用表格 | 复用或参考实现ERP表格 |
@@ -344,7 +344,7 @@ pnpm check:type
1. **复用Vben生态**：直接使用@vben/*包，减少重复开发
2. **渐进式迁移**：先复用系统管理，再扩展ERP功能
3. **保持结构一致**：遵循ruoyi-admin的目录规范
3. **保持结构一致**：遵循hzhub-admin的目录规范
---
@@ -359,7 +359,7 @@ pnpm check:type
### 9.2 下一步行动
1. 复用 `ruoyi-admin` 作为 `hzhub-admin` 基础
1. 复用 `hzhub-admin` 作为 `hzhub-admin` 基础
2. 保留系统管理、权限控制等通用功能
3. 改造AI管理模块为ERP管理模块
4. 复用流程编排设计器，增加ERP业务节点

14
docs/learnings/03-ruoyi-web-user-frontend-review.md
View File

@@ -1,7 +1,7 @@
# RuoYi-Web 用户前端审查报告
# HZHub-Web 用户前端审查报告
> 审查时间：2026-03-26
> 项目路径：/data/ruoyi-ai/ruoyi-web/
> 项目路径：/data/hzhub-ai/hzhub-portal/
---
@@ -11,7 +11,7 @@
| 属性 | 内容 |
|------|------|
| 项目名称 | RuoYi-Web |
| 项目名称 | HZHub-Web |
| 定位 | 企业级AI助手平台 - 用户前端 |
| 技术栈 | Vue 3 + TypeScript + Element Plus X |
| 构建工具 | Vite 6.x |
@@ -32,7 +32,7 @@
### 2.1 整体架构
```
ruoyi-web/
hzhub-portal/
├── src/
│ ├── api/ # API接口定义
│ ├── assets/ # 静态资源
@@ -74,7 +74,7 @@ ruoyi-web/
### 2.2 与Admin的差异
| 方面 | ruoyi-admin | ruoyi-web |
| 方面 | hzhub-admin | hzhub-portal |
|------|-------------|-----------|
| 架构 | Monorepo (多包) | Single Repo (单包) |
| UI库 | Ant Design Vue | Element Plus X |
@@ -266,7 +266,7 @@ async function runWorkflow() {
### 6.1 架构设计借鉴
| 方面 | RuoYi-Web实践 | HZHub应用 |
| 方面 | HZHub-Web实践 | HZHub应用 |
|------|---------------|-----------|
| 单包架构 | 简单清晰，适合用户端 | hzhub-portal采用同样结构 |
| 组件封装 | ModelSelect、FilesSelect等 | 复用或参考实现ERP组件 |
@@ -379,7 +379,7 @@ pnpm lint
### 9.2 下一步行动
1. 复用 `ruoyi-web` 的组件和模式
1. 复用 `hzhub-portal` 的组件和模式
2. 改造AI聊天为ERP智能助手对话
3. 开发公司门户和经销商门户
4. 集成AI能力到业务流程中

66
docs/learnings/04-summary-analysis.md
View File

@@ -1,7 +1,7 @@
# RuoYi-AI 三项目综合分析报告
# HZHub-AI 三项目综合分析报告
> 分析时间：2026-03-26
> 分析对象：ruoyi-ai（后端）、ruoyi-admin（管理后台）、ruoyi-web（用户前端）
> 分析对象：hzhub-ai（后端）、hzhub-admin（管理后台）、hzhub-portal（用户前端）
---
@@ -11,9 +11,9 @@
```
┌─────────────────────────────────────────────────────────────────┐
│ RuoYi-AI 生态系统 │
│ HZHub-AI 生态系统 │
├─────────────────┬─────────────────┬─────────────────────────────┤
│ ruoyi-web │ ruoyi-admin │ ruoyi-ai │
│ hzhub-portal │ hzhub-admin │ hzhub-ai │
│ (用户前端) │ (管理后台) │ (后端服务) │
├─────────────────┼─────────────────┼─────────────────────────────┤
│ · AI对话界面 │ · 系统管理 │ · 多模型接入 │
@@ -34,7 +34,7 @@
### 1.2 技术栈对比
| 层级 | ruoyi-web | ruoyi-admin | ruoyi-ai |
| 层级 | hzhub-portal | hzhub-admin | hzhub-ai |
|------|-----------|-------------|----------|
| **框架** | Vue 3 | Vue 3 | Spring Boot 3.5.8 |
| **UI库** | Element Plus X | Ant Design Vue | - |
@@ -49,7 +49,7 @@
## 二、各项目深度分析
### 2.1 ruoyi-ai（后端）- 核心引擎
### 2.1 hzhub-ai（后端）- 核心引擎
**架构评分**：⭐⭐⭐⭐⭐（5/5）
@@ -68,11 +68,11 @@
| 模块 | 价值 | HZHub复用度 |
|------|------|-------------|
| ruoyi-chat | AI聊天、知识库、MCP | 90% |
| ruoyi-aiflow | 流程编排引擎 | 90% |
| hzhub-aiflow | 流程编排引擎 | 90% |
| ruoyi-system | 系统管理 | 80% |
| ruoyi-common | 公共组件库 | 85% |
| hzhub-common | 公共组件库 | 85% |
### 2.2 ruoyi-admin（管理后台）- 配置中心
### 2.2 hzhub-admin（管理后台）- 配置中心
**架构评分**：⭐⭐⭐⭐⭐（5/5）
@@ -95,7 +95,7 @@
| 知识库管理 | 文档、片段管理 | 85% |
| MCP工具管理 | 工具、市场 | 80% |
### 2.3 ruoyi-web（用户前端）- 交互界面
### 2.3 hzhub-portal（用户前端）- 交互界面
**架构评分**：⭐⭐⭐⭐（4/5）
@@ -124,13 +124,13 @@
### 3.1 复用矩阵
| RuoYi资产 | HZHub目标 | 复用策略 | 工作量 |
| HZHub资产 | HZHub目标 | 复用策略 | 工作量 |
|-----------|-----------|----------|--------|
| ruoyi-chat模块 | hzhub-ai | 直接复用 | 低 |
| ruoyi-aiflow模块 | hzhub-ai | 直接复用 | 低 |
| hzhub-aiflow模块 | hzhub-ai | 直接复用 | 低 |
| ruoyi-system模块 | hzhub-admin | 直接复用 | 低 |
| ruoyi-admin整体 | hzhub-admin | 改造AI模块为ERP模块 | 中 |
| ruoyi-web组件 | hzhub-portal-* | 复用组件，改造业务 | 中 |
| hzhub-admin整体 | hzhub-admin | 改造AI模块为ERP模块 | 中 |
| hzhub-portal组件 | hzhub-portal-* | 复用组件，改造业务 | 中 |
| SQL Agent | hzhub-erp | 改造为SQL Server版 | 高 |
### 3.2 推荐技术路线
@@ -139,25 +139,25 @@
HZHub 技术栈决策：
后端 (hzhub-ai / hzhub-erp / hzhub-gateway)
├── Spring Boot 3.5.8（与ruoyi-ai一致，暂不用4.0）
├── Spring Boot 3.5.8（与hzhub-ai一致，暂不用4.0）
├── LangChain4j 1.11.0
├── MyBatis Plus 3.5.14
├── Sa-Token 1.44.0
└── 复用ruoyi-ai的common模块
└── 复用hzhub-ai的common模块
管理后台 (hzhub-admin)
├── Vue 3 + TypeScript
├── Vben Admin（复用ruoyi-admin架构）
├── Vben Admin（复用hzhub-admin架构）
├── Ant Design Vue
├── pnpm workspace + Turbo
└── 复用ruoyi-admin的packages
└── 复用hzhub-admin的packages
门户前端 (hzhub-portal-company / hzhub-portal-dealer)
├── Vue 3 + TypeScript
├── Element Plus X（复用ruoyi-web组件）
├── Element Plus X（复用hzhub-portal组件）
├── UnoCSS
├── Pinia
└── 复用ruoyi-web的组件模式
└── 复用hzhub-portal的组件模式
```
### 3.3 开发优先级
@@ -165,7 +165,7 @@ HZHub 技术栈决策：
| 优先级 | 模块 | 依赖 | 预计工期 |
|--------|------|------|----------|
| P0 | hzhub-ai | 复用ruoyi-chat | 1周 |
| P0 | hzhub-admin | 复用ruoyi-admin | 1周 |
| P0 | hzhub-admin | 复用hzhub-admin | 1周 |
| P1 | hzhub-erp | 自研SQL Server适配 | 2-3周 |
| P1 | hzhub-portal-company | 复用+改造 | 2周 |
| P2 | hzhub-portal-dealer | 复用+改造 | 2周 |
@@ -178,7 +178,7 @@ HZHub 技术栈决策：
### 4.1 后端架构决策
**决策1：Spring Boot版本**
- 选择：3.5.8（与ruoyi-ai一致）
- 选择：3.5.8（与hzhub-ai一致）
- 理由：稳定性优先，4.0升级成本未知
**决策2：ERP服务独立**
@@ -197,7 +197,7 @@ HZHub 技术栈决策：
**决策2：门户前端框架**
- 选择：Element Plus X
- 理由：ruoyi-web组件可直接复用
- 理由：hzhub-portal组件可直接复用
**决策3：样式方案**
- 选择：Admin用Tailwind，门户用UnoCSS
@@ -207,7 +207,7 @@ HZHub 技术栈决策：
**决策1：向量数据库**
- 选择：Milvus
- 理由：ruoyi-ai原生支持，性能优秀
- 理由：hzhub-ai原生支持，性能优秀
**决策2：ERP数据源**
- 选择：直连SQL Server 2008 R2
@@ -244,8 +244,8 @@ HZHub 技术栈决策：
**任务**：
1. 创建Gitea仓库，初始化项目结构
2. 复制ruoyi-ai代码到hzhub-ai
3. 复制ruoyi-admin代码到hzhub-admin
2. 复制hzhub-ai代码到hzhub-ai
3. 复制hzhub-admin代码到hzhub-admin
4. 验证基础功能运行
**产出**：
@@ -298,7 +298,7 @@ HZHub 技术栈决策：
## 七、总结
### 7.1 RuoYi-AI价值评估
### 7.1 HZHub-AI价值评估
| 维度 | 评分 | 说明 |
|------|------|------|
@@ -308,17 +308,17 @@ HZHub 技术栈决策：
| 可复用性 | ⭐⭐⭐⭐⭐ | 模块化设计，易于复用 |
| 社区活跃度 | ⭐⭐⭐⭐ | 较新项目，发展迅速 |
**总体评价**：RuoYi-AI是构建HZHub的**理想基础**，可以大幅缩短开发周期（估计节省3-4个月）。
**总体评价**：HZHub-AI是构建HZHub的**理想基础**，可以大幅缩短开发周期（估计节省3-4个月）。
### 7.2 HZHub建设路径
```
基于RuoYi-AI构建HZHub的核心策略：
基于HZHub-AI构建HZHub的核心策略：
1. 复用为主（70%）
- 直接复用ruoyi-chat、ruoyi-aiflow
- 直接复用ruoyi-admin系统管理
- 复用ruoyi-web组件
- 直接复用ruoyi-chat、hzhub-aiflow
- 直接复用hzhub-admin系统管理
- 复用hzhub-portal组件
2. 改造为辅（20%）
- 改造AI模块为ERP模块
@@ -334,7 +334,7 @@ HZHub 技术栈决策：
### 7.3 下一步行动
1. **立即执行**：创建Gitea仓库，初始化项目
2. **本周完成**：复制ruoyi-ai和ruoyi-admin代码
2. **本周完成**：复制hzhub-ai和hzhub-admin代码
3. **下周开始**：ERP服务开发
4. **持续进行**：文档更新和团队培训

2
docs/project/changes/architecture-changes.md
View File

@@ -26,7 +26,7 @@
- 数据存储层（MySQL + Milvus + SQL Server）
**变更原因**：
项目启动，基于RuoYi-AI三项目进行架构设计。
项目启动，基于HZHub-AI三项目进行架构设计。
**技术选型**：
- 后端：Spring Boot 3.5.8 + LangChain4j 1.11.0

4
docs/project/plan/master-plan.md
View File

@@ -57,8 +57,8 @@
**任务清单**：
- [x] 创建Gitea仓库
- [x] 初始化hzhub-ai（复用ruoyi-ai）
- [x] 初始化hzhub-admin（复用ruoyi-admin）
- [x] 初始化hzhub-ai（复用hzhub-ai）
- [x] 初始化hzhub-admin（复用hzhub-admin）
- [ ] 配置开发环境
- [ ] 启动基础设施（MySQL、Redis、Milvus）
- [ ] 验证AI服务运行

2
docs/project/plan/phase-1.md
View File

@@ -112,7 +112,7 @@ Day 11-14: 测试和文档（依赖前端）
| 风险 | 可能性 | 影响 | 对策 |
|------|--------|------|------|
| Milvus部署失败 | 中 | 高 | 使用Docker Compose简化部署 |
| ruoyi-ai启动失败 | 中 | 高 | 检查依赖版本，查看日志 |
| hzhub-ai启动失败 | 中 | 高 | 检查依赖版本，查看日志 |
| 端口冲突 | 高 | 中 | 提前规划端口，准备备用端口 |
| 网络问题 | 中 | 中 | 准备离线安装包 |

16
docs/project/progress/weekly/2026-03-26-week1.md
View File

@@ -11,7 +11,7 @@
| 任务 | 计划 | 实际 | 状态 |
|------|------|------|------|
| RuoYi-AI三项目审查 | 3.26 | 3.26 | ✅ 已完成 |
| HZHub-AI三项目审查 | 3.26 | 3.26 | ✅ 已完成 |
| 架构设计文档 | 3.26 | 3.26 | ✅ 已完成 |
| 系统架构图 | 3.26 | 3.26 | ✅ 已完成 |
| 代码初始化 | 3.26 | 3.26 | ✅ 已完成 |
@@ -20,22 +20,22 @@
### 关键成果
1. **完成三项目深度审查**
- ruoyi-ai（后端）：Spring Boot + LangChain4j，AI能力完整
- ruoyi-admin（管理后台）：Vue 3 + Vben Admin，组件丰富
- ruoyi-web（用户前端）：Vue 3 + Element Plus X，流式处理成熟
- hzhub-ai（后端）：Spring Boot + LangChain4j，AI能力完整
- hzhub-admin（管理后台）：Vue 3 + Vben Admin，组件丰富
- hzhub-portal（用户前端）：Vue 3 + Element Plus X，流式处理成熟
2. **确定技术路线**
- 复用70% + 改造20% + 自研10%
- Spring Boot 3.5.8（与ruoyi-ai一致）
- Spring Boot 3.5.8（与hzhub-ai一致）
- 管理后台：Vben Admin + Ant Design Vue
- 门户：Element Plus X
3. **完成代码初始化**
- hzhub-ai（复用ruoyi-ai）
- hzhub-admin（复用ruoyi-admin）
- hzhub-ai（复用hzhub-ai）
- hzhub-admin（复用hzhub-admin）
- hzhub-erp（新建）
- hzhub-gateway（新建）
- hzhub-portal-company/dealer（复用ruoyi-web）
- hzhub-portal-company/dealer（复用hzhub-portal）
4. **建立项目管理文档**
- 总体计划（8周，4个阶段）