278e507e8a
- 新增 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>
241 lines
7.8 KiB
Markdown
241 lines
7.8 KiB
Markdown
# HZHub 汇智中台
|
||
|
||
> 基于 HZHub-AI 构建的企业级业务中台系统
|
||
|
||
## 项目简介
|
||
|
||
HZHub（汇智中台）是面向企业级市场的业务中台系统，集成 AI 能力与 ERP 数据适配，支持多门户接入。
|
||
|
||
## 系统架构
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────────────────┐
|
||
│ 前端接入层 │
|
||
├─────────────────┬─────────────────┬─────────────────────────────────────┤
|
||
│ 管理后台 │ 员工门户 │ 经销商门户 │
|
||
│ (hzhub-admin) │ (hzhub-portal- │ (hzhub-portal-dealer) │
|
||
│ · 模型管理 │ employee) │ · 企业微信H5 │
|
||
│ · 知识库配置 │ · 企业微信H5 │ · 自助开单 │
|
||
│ · 智能体编排 │ · 审批流程 │ · 自助对账/发货 │
|
||
│ · 系统管理 │ · 经销商管理 │ · 进销存 │
|
||
│ │ · 销售CRM │ · 营销素材库 │
|
||
│ │ · BI报表 │ · AI素材生成 │
|
||
│ │ · AI应用集成 │ │
|
||
└────────┬────────┴────────┬────────┴──────────────────┬──────────────────┘
|
||
│ │ │
|
||
└─────────────────┴──────────────────────────┘
|
||
│
|
||
┌─────────┴─────────┐
|
||
│ API网关层 │
|
||
│ (HZHub-Gateway) │
|
||
│ · 统一鉴权 │
|
||
│ · 路由转发 │
|
||
│ · 限流熔断 │
|
||
└─────────┬─────────┘
|
||
│
|
||
┌────────────────────┼────────────────────┐
|
||
│ │ │
|
||
┌────┴────┐ ┌────┴────┐ ┌────┴────┐
|
||
│ HZHub │ │ HZHub │ │ n8n │
|
||
│ -AI │ │ -ERP │ │ (工作流) │
|
||
│ (AI服务) │ │ (ERP服务)│ │ │
|
||
├─────────┤ ├─────────┤ └─────────┘
|
||
│·Spring │ │·Spring │
|
||
│ Boot 3.x│ │ Boot 3.x│
|
||
│·Spring │ │·JDBC │
|
||
│ AI 2.0 │ │·SQL Svr │
|
||
│·LangChain│ │ 2008 R2 │
|
||
│ 4j │ │·双数据源│
|
||
│·MySQL │ │ 预留 │
|
||
│·Milvus │ │ │
|
||
│·RAG/智能体│ │ │
|
||
└─────────┘ └─────────┘
|
||
```
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
hzhub/
|
||
├── hzhub-ai/ # AI服务（复用hzhub-ai）
|
||
├── hzhub-erp/ # ERP服务（新建）
|
||
├── hzhub-gateway/ # API网关（新建）
|
||
├── hzhub-admin/ # 管理后台（复用hzhub-admin）
|
||
├── hzhub-portal-employee/ # 员工门户（复用hzhub-portal）
|
||
├── hzhub-portal-dealer/ # 经销商门户（复用hzhub-portal）
|
||
├── hzhub-deploy/ # 部署配置
|
||
│ └── docker-compose.yml
|
||
└── docs/ # 项目文档
|
||
├── README.md
|
||
├── architecture/
|
||
│ ├── README.md
|
||
│ ├── hzhub-architecture.png
|
||
│ └── hzhub-architecture-cn.png
|
||
└── learnings/
|
||
├── 01-hzhub-ai-backend-review.md
|
||
├── 02-hzhub-admin-frontend-review.md
|
||
├── 03-hzhub-portal-user-frontend-review.md
|
||
└── 04-summary-analysis.md
|
||
```
|
||
|
||
## 技术栈
|
||
|
||
| 层级 | 技术选型 |
|
||
|------|---------|
|
||
| 前端 | Vue 3 + TypeScript |
|
||
| 管理后台UI | Ant Design Vue (Vben Admin) |
|
||
| 门户UI | Element Plus X |
|
||
| 网关 | Spring Cloud Gateway |
|
||
| AI服务 | Spring Boot 3.5.8 + LangChain4j 1.11.0 |
|
||
| ERP服务 | Spring Boot 3.x + JDBC |
|
||
| 向量数据库 | Weaviate 1.25.0 |
|
||
| 关系数据库 | MySQL 8.0 |
|
||
| 缓存 | Redis 7 |
|
||
| 工作流 | n8n |
|
||
| 对象存储 | MinIO |
|
||
| 部署 | Docker Compose |
|
||
|
||
## 项目状态
|
||
|
||
- ✅ 基础设施 Docker 化 (MySQL, Redis, Weaviate, n8n, MinIO)
|
||
- ✅ AI服务 Docker 化 (hzhub-ai)
|
||
- ✅ 前端管理后台 Docker 化 (hzhub-admin)
|
||
- ⏳ ERP服务 (开发中)
|
||
- ⏳ API网关 (开发中)
|
||
- ⏳ 员工门户 (待配置)
|
||
- ⏳ 经销商门户 (待配置)
|
||
|
||
## 快速开始
|
||
|
||
### 环境准备
|
||
|
||
- Docker & Docker Compose
|
||
- JDK 17+ (本地开发)
|
||
- Node.js 22+ (本地开发)
|
||
- pnpm 10+ (本地开发)
|
||
- Maven 3.9+ (本地开发)
|
||
|
||
### 一键启动（Docker Compose）
|
||
|
||
```bash
|
||
cd hzhub-deploy
|
||
docker-compose up -d
|
||
```
|
||
|
||
启动完成后访问：
|
||
- 🌐 管理后台: http://localhost:5666
|
||
- 🚀 员工门户: http://localhost:5137
|
||
- 🔧 AI服务API: http://localhost:6039
|
||
- 🔄 n8n工作流: http://localhost:5678
|
||
|
||
### 本地开发启动（后台运行）
|
||
|
||
项目提供了便捷的后台运行管理脚本：
|
||
|
||
```bash
|
||
# 一键启动所有服务
|
||
cd /data/hzhub
|
||
./start-all.sh
|
||
|
||
# 查看所有服务状态
|
||
./status-all.sh
|
||
|
||
# 一键停止所有服务
|
||
./stop-all.sh
|
||
```
|
||
|
||
或分别启动各服务：
|
||
|
||
```bash
|
||
# 启动后端服务
|
||
cd hzhub-ai
|
||
./start.sh # 启动
|
||
./status.sh # 查看状态
|
||
./logs.sh # 查看日志
|
||
./stop.sh # 停止
|
||
|
||
# 启动管理后台
|
||
cd hzhub-admin
|
||
./start.sh
|
||
|
||
# 启动员工门户
|
||
cd hzhub-portal-employee
|
||
./start.sh
|
||
```
|
||
|
||
📖 详细说明请查看 [服务管理文档](./SERVICE_MANAGEMENT.md)
|
||
|
||
### 服务清单
|
||
|
||
| 服务名 | 容器名 | 端口 | 说明 |
|
||
|--------|--------|------|------|
|
||
| hzhub-admin | hzhub-deploy-hzhub-admin | 5666 | 管理后台前端(Nginx) |
|
||
| hzhub-ai | hzhub-deploy-hzhub-ai | 6039 | AI后端服务(Spring Boot) |
|
||
| mysql | hzhub-mysql | 3306 | MySQL 8.0数据库 |
|
||
| redis | hzhub-redis | 6379 | Redis 7缓存 |
|
||
| weaviate | hzhub-weaviate | 28080 | Weaviate向量数据库 |
|
||
| n8n | hzhub-n8n | 5678 | n8n工作流引擎 |
|
||
| minio | hzhub-deploy-minio-1 | 9000 | MinIO对象存储 |
|
||
| etcd | hzhub-deploy-etcd-1 | 2379 | etcd服务发现 |
|
||
|
||
### 本地开发启动
|
||
|
||
#### 后端服务
|
||
|
||
```bash
|
||
# AI服务
|
||
cd hzhub-ai/hzhub-admin
|
||
mvn spring-boot:run -Dspring-boot.run.profiles=dev
|
||
```
|
||
|
||
#### 前端开发
|
||
|
||
```bash
|
||
# 管理后台
|
||
cd hzhub-admin
|
||
pnpm install
|
||
pnpm dev
|
||
```
|
||
|
||
#### 前端生产构建
|
||
|
||
```bash
|
||
cd hzhub-admin
|
||
# 先构建依赖包
|
||
pnpm build
|
||
# 再构建前端
|
||
pnpm --filter=@vben/web-antd build:prod
|
||
```
|
||
|
||
### 常用命令
|
||
|
||
```bash
|
||
# 查看所有服务状态
|
||
docker-compose ps
|
||
|
||
# 查看服务日志
|
||
docker-compose logs -f hzhub-ai
|
||
docker-compose logs -f hzhub-admin
|
||
|
||
# 重启服务
|
||
docker-compose restart hzhub-ai
|
||
|
||
# 停止所有服务
|
||
docker-compose down
|
||
|
||
# 停止并删除数据卷（谨慎使用）
|
||
docker-compose down -v
|
||
```
|
||
|
||
## 文档
|
||
|
||
- [架构设计](./docs/architecture/README.md)
|
||
- [学习报告](./docs/learnings/)
|
||
|
||
## 开源协议
|
||
|
||
MIT License
|
||
|
||
## 创建时间
|
||
|
||
2026-03-26
|