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

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. **持续进行**：文档更新和团队培训