30113c51b5
修复内容： 1. 租户管理日期格式问题 - 问题：新增租户时过期时间字段报错 Cannot deserialize Date - 解决：SysTenantBo.expireTime 添加 @JsonFormat 和 @DateTimeFormat 注解 - 影响：租户管理功能可正常保存带过期时间的数据 2. 更新项目进度文档 - 记录本周完成的租户管理修复、局域网访问配置等关键成果 - 更新已解决问题列表 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
HZHub 汇智中台
基于 HZHub-AI 构建的企业级业务中台系统
项目简介
HZHub（汇智中台）是面向企业级市场的业务中台系统，集成 AI 能力与 ERP 数据适配，支持多门户接入。
系统架构
┌─────────────────────────────────────────────────────────────────────────┐
│ 前端接入层 │
├─────────────────┬─────────────────┬─────────────────────────────────────┤
│ 管理后台 │ 公司门户 │ 经销商门户 │
│ (hzhub-admin) │ (hzhub-portal- │ (hzhub-portal-dealer) │
│ · 模型管理 │ company) │ · 企业微信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-company/ # 公司门户（复用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）
cd hzhub-deploy
docker-compose up -d
启动完成后访问：
- 🌐 管理后台: http://localhost:5666
- 🔧 AI服务API: http://localhost:6039
- 🔄 n8n工作流: http://localhost:5678
服务清单
| 服务名 | 容器名 | 端口 | 说明 |
|---|---|---|---|
| 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服务发现 |
本地开发启动
后端服务
# AI服务
cd hzhub-ai/hzhub-admin
mvn spring-boot:run -Dspring-boot.run.profiles=dev
前端开发
# 管理后台
cd hzhub-admin
pnpm install
pnpm dev
前端生产构建
cd hzhub-admin
# 先构建依赖包
pnpm build
# 再构建前端
pnpm --filter=@vben/web-antd build:prod
常用命令
# 查看所有服务状态
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
文档
开源协议
MIT License
创建时间
2026-03-26