Files

- 新增 hzhub-portal-employee 员工门户前端项目（基于 Vue3 + Element Plus）
- 后端登录接口增加返回 nickName 字段
- 移除 KnowledgeInfoController 的 @SaCheckPermission 注解
- 删除 hzhub-portal-company 旧门户项目
- 更新项目文档和架构说明
- 添加后台运行管理脚本（start-all.sh / status-all.sh / stop-all.sh）
- 更新 docker-compose 配置

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

2026-04-13 03:47:33 +00:00

10 KiB

Raw Permalink Blame History

HZHub-AI 三项目综合分析报告

分析时间：2026-03-26 分析对象：hzhub-ai（后端）、hzhub-admin（管理后台）、hzhub-portal（用户前端）

一、整体架构总览

1.1 三项目关系图

┌─────────────────────────────────────────────────────────────────┐
│                        HZHub-AI 生态系统                         │
├─────────────────┬─────────────────┬─────────────────────────────┤
│   hzhub-portal     │   hzhub-admin   │        hzhub-ai             │
│   (用户前端)     │   (管理后台)     │        (后端服务)            │
├─────────────────┼─────────────────┼─────────────────────────────┤
│ · AI对话界面    │ · 系统管理      │ · 多模型接入                │
│ · 知识库问答    │ · 模型配置      │ · RAG知识库                 │
│ · 工作流执行    │ · 知识库管理    │ · MCP工具框架               │
│ · 智能体交互    │ · 流程编排设计  │ · 流程编排引擎              │
│                 │ · MCP工具管理   │ · 多智能体框架              │
│                 │ · 工作流管理    │ · 企业微信SDK               │
└─────────────────┴─────────────────┴─────────────────────────────┘
         │                │                    │
         └────────────────┴────────────────────┘
                              │
                    ┌─────────┴─────────┐
                    │    数据存储层       │
                    │  MySQL + Milvus   │
                    └───────────────────┘

1.2 技术栈对比

层级	hzhub-portal	hzhub-admin	hzhub-ai
框架	Vue 3	Vue 3	Spring Boot 3.5.8
UI库	Element Plus X	Ant Design Vue	-
样式	UnoCSS	Tailwind CSS	-
状态	Pinia	Pinia	-
请求	hook-fetch	@vben/request	Spring AI
AI	SSE流式	流程设计器	LangChain4j
构建	Vite	Vite + Turbo	Maven
架构	Single Repo	Monorepo	多模块Maven

二、各项目深度分析

2.1 hzhub-ai（后端）- 核心引擎

架构评分：⭐⭐⭐⭐⭐（5/5）

优势：

模块化设计清晰（25个common子模块）
AI能力完整（模型接入、RAG、Agent、工作流）
技术栈先进（LangChain4j、Spring AI）
扩展性强（MCP协议、流程编排）

不足：

Spring Boot版本实际为3.5.8（非宣称的4.0）
SQL Server支持需自行开发
文档有些地方不够详细

核心资产：

模块	价值	HZHub复用度
ruoyi-chat	AI聊天、知识库、MCP	90%
hzhub-aiflow	流程编排引擎	90%
ruoyi-system	系统管理	80%
hzhub-common	公共组件库	85%

2.2 hzhub-admin（管理后台）- 配置中心

架构评分：⭐⭐⭐⭐⭐（5/5）

优势：

Monorepo架构先进（pnpm + Turbo）
Vben生态丰富（@vben/*包）
组件封装规范（useVbenVxeGrid等）
权限控制完善

不足：

学习曲线较陡（Vben生态复杂）
构建依赖较多
定制需要理解Monorepo机制

核心资产：

功能	价值	HZHub复用度
系统管理	用户、角色、菜单	95%
流程编排设计器	@vue-flow/core	90%
知识库管理	文档、片段管理	85%
MCP工具管理	工具、市场	80%

2.3 hzhub-portal（用户前端）- 交互界面

架构评分：⭐⭐⭐⭐（4/5）

优势：

架构简洁（Single Repo）
Element Plus X组件专业（Sender等）
流式响应处理成熟
代码易于理解

不足：

功能相对单一（主要是聊天）
单包架构扩展性有限
与Admin技术栈不一致（Element Plus vs Ant Design）

核心资产：

组件	价值	HZHub复用度
ModelSelect	模型选择器	90%
FilesSelect	文件选择器	90%
Sender	聊天输入组件	85%
流式处理	SSE实现	95%

三、HZHub整合策略

3.1 复用矩阵

HZHub资产	HZHub目标	复用策略	工作量
ruoyi-chat模块	hzhub-ai	直接复用	低
hzhub-aiflow模块	hzhub-ai	直接复用	低
ruoyi-system模块	hzhub-admin	直接复用	低
hzhub-admin整体	hzhub-admin	改造AI模块为ERP模块	中
hzhub-portal组件	hzhub-portal-*	复用组件，改造业务	中
SQL Agent	hzhub-erp	改造为SQL Server版	高

3.2 推荐技术路线

HZHub 技术栈决策：

后端 (hzhub-ai / hzhub-erp / hzhub-gateway)
├── Spring Boot 3.5.8（与hzhub-ai一致，暂不用4.0）
├── LangChain4j 1.11.0
├── MyBatis Plus 3.5.14
├── Sa-Token 1.44.0
└── 复用hzhub-ai的common模块

管理后台 (hzhub-admin)
├── Vue 3 + TypeScript
├── Vben Admin（复用hzhub-admin架构）
├── Ant Design Vue
├── pnpm workspace + Turbo
└── 复用hzhub-admin的packages

门户前端 (hzhub-portal-employee / hzhub-portal-dealer)
├── Vue 3 + TypeScript
├── Element Plus X（复用hzhub-portal组件）
├── UnoCSS
├── Pinia
└── 复用hzhub-portal的组件模式

3.3 开发优先级

优先级	模块	依赖	预计工期
P0	hzhub-ai	复用ruoyi-chat	1周
P0	hzhub-admin	复用hzhub-admin	1周
P1	hzhub-erp	自研SQL Server适配	2-3周
P1	hzhub-portal-employee	复用+改造	2周
P2	hzhub-portal-dealer	复用+改造	2周
P2	流程编排ERP节点	扩展aiflow	1周

四、关键设计决策

4.1 后端架构决策

决策1：Spring Boot版本

选择：3.5.8（与hzhub-ai一致）
理由：稳定性优先，4.0升级成本未知

决策2：ERP服务独立

选择：独立hzhub-erp服务
理由：隔离SQL Server 2008 R2兼容性风险

决策3：AI服务复用

选择：直接复用ruoyi-chat
理由：功能完整，改造成本低

4.2 前端架构决策

决策1：管理后台框架

选择：Vben Admin（Ant Design Vue）
理由：功能强大，生态完善

决策2：门户前端框架

选择：Element Plus X
理由：hzhub-portal组件可直接复用

决策3：样式方案

选择：Admin用Tailwind，门户用UnoCSS
理由：与各自复用源码保持一致

4.3 数据库决策

决策1：向量数据库

选择：Milvus
理由：hzhub-ai原生支持，性能优秀

决策2：ERP数据源

选择：直连SQL Server 2008 R2
理由：无WebService接口，需JDBC直连

五、风险评估

5.1 技术风险

风险	等级	缓解措施
SQL Server 2008 R2兼容性	高	预留双数据源，可切换
LangChain4j API变化	中	锁定版本1.11.0
前端技术栈不一致	中	文档化两套UI规范
企业微信多实体对接	中	抽象配置层

5.2 项目风险

风险	等级	缓解措施
工期估算不准	中	分阶段交付，每阶段验收
ERP数据结构不明	高	先做数据架构调研
团队学习成本	中	文档+培训

六、实施建议

6.1 第一阶段（1-2周）

目标：搭建基础框架

任务：

创建Gitea仓库，初始化项目结构
复制hzhub-ai代码到hzhub-ai
复制hzhub-admin代码到hzhub-admin
验证基础功能运行

产出：

可运行的基础框架
开发环境搭建文档

6.2 第二阶段（3-4周）

目标：ERP服务开发

任务：

开发hzhub-erp服务（SQL Server连接）
实现基础数据查询API
开发SQL Agent（SQL Server版）
集成到hzhub-admin

产出：

ERP服务可用
基础数据查询功能

6.3 第三阶段（5-6周）

目标：门户开发

任务：

开发hzhub-portal-employee
开发hzhub-portal-dealer
集成AI组件到门户
企业微信对接

产出：

公司门户可用
经销商门户可用

6.4 第四阶段（7-8周）

目标：流程编排与优化

任务：

扩展流程编排ERP节点
性能优化
安全加固
文档完善

产出：

完整业务流程跑通
上线准备就绪

七、总结

7.1 HZHub-AI价值评估

维度	评分	说明
技术先进性	⭐⭐⭐⭐⭐	Spring AI、LangChain4j、流程编排
代码质量	⭐⭐⭐⭐⭐	规范清晰，文档完善
功能完整性	⭐⭐⭐⭐⭐	AI能力全覆盖
可复用性	⭐⭐⭐⭐⭐	模块化设计，易于复用
社区活跃度	⭐⭐⭐⭐	较新项目，发展迅速

总体评价：HZHub-AI是构建HZHub的理想基础，可以大幅缩短开发周期（估计节省3-4个月）。

7.2 HZHub建设路径

基于HZHub-AI构建HZHub的核心策略：

1. 复用为主（70%）
   - 直接复用ruoyi-chat、hzhub-aiflow
   - 直接复用hzhub-admin系统管理
   - 复用hzhub-portal组件

2. 改造为辅（20%）
   - 改造AI模块为ERP模块
   - 改造SQL Agent为SQL Server版
   - 改造门户为业务门户

3. 自研补充（10%）
   - ERP数据适配层
   - 企业微信多实体对接
   - 业务流程节点

7.3 下一步行动

立即执行：创建Gitea仓库，初始化项目
本周完成：复制hzhub-ai和hzhub-admin代码
下周开始：ERP服务开发
持续进行：文档更新和团队培训

分析完成时间：2026-03-26 09:15 UTC 分析师：大壮

10 KiB Raw Permalink Blame History Unescape Escape

HZHub-AI 三项目综合分析报告

一、整体架构总览

1.1 三项目关系图

1.2 技术栈对比

二、各项目深度分析

2.1 hzhub-ai（后端）- 核心引擎

2.2 hzhub-admin（管理后台）- 配置中心

2.3 hzhub-portal（用户前端）- 交互界面

三、HZHub整合策略

3.1 复用矩阵

3.2 推荐技术路线

3.3 开发优先级

四、关键设计决策

4.1 后端架构决策

4.2 前端架构决策

4.3 数据库决策

五、风险评估

5.1 技术风险

5.2 项目风险

六、实施建议

6.1 第一阶段（1-2周）

6.2 第二阶段（3-4周）

6.3 第三阶段（5-6周）

6.4 第四阶段（7-8周）

七、总结

7.1 HZHub-AI价值评估

7.2 HZHub建设路径

7.3 下一步行动

10 KiB

Raw Permalink Blame History