3f643ef31f
## 新增功能 ### 商机中心 (/opportunity) - Stats统计卡片（商机总数、金额、赢单、转化率） - Pipeline商机管道（阶段Tab：全部/线索/谈判中/方案/赢单） - 商机列表真实数据渲染（来自crm_opportunity表） - 商机卡片详情（经销商、负责人、金额、概率） - Pipeline计数实时更新 ### 线索中心 (/lead) - 线索列表完整功能（CRUD） - 线索详情Drawer（基础信息 + 跟进记录Timeline） - 新建线索（含ERP客户关联、手机号验证） - 添加跟进记录（跟进方式、内容、下次时间） - 分配负责人（用户选择器，显示真实姓名） - 线索转经销商（自动创建商机） - 删除线索（逻辑删除） ## 后端开发 ### 数据库表 - crm_lead（线索表） - crm_lead_follow（线索跟进记录表） - crm_dealer（经销商表） - crm_opportunity（商机表） - crm_opportunity_follow（商机跟进记录表） - 数据字典初始化 ### API接口 - 线索管理：CRUD、详情、跟进、分配、转化 - 商机管理：列表查询 - 用户选择器：员工门户专用API ### 核心功能 - 线索转化自动创建经销商和商机 - 负责人翻译显示真实姓名（修复） - 手机号前后端双重格式验证（修复） ## 前端开发 ### 页面架构改进 - 商机中心：保留原CRM设计风格（Stats + Pipeline） - 线索中心：独立页面（完整线索管理） - 左侧菜单：独立菜单项（商机中心、线索中心） ### API模块 - src/api/crm/：线索和商机API类型定义和调用方法 - src/api/user/：用户选择器API ### 样式设计 - 商机中心：100%保持原CRM Pipeline设计风格 - 使用CSS变量系统（var(--radius-lg), var(--shadow-sm)等） - Pipeline Tab白色圆角设计 - 商机卡片阴影和hover效果 - 头像堆叠显示 ## 配置修改 - Gateway路由：添加CRM模块路由配置 - Gateway路由：添加system模块路由配置 - Aside菜单：拆分商机中心和线索中心 ## Bug修复 - 修复负责人显示手机号问题（UserNameTranslationImpl返回昵称） - 修复手机号格式验证缺失（前后端双重验证） - 修复商机管道设计风格不一致（完整复制原CRM样式） ## 文档 - CRM销售模块详细设计说明书V3.md - CRM线索转化API契约 - CRM线索转化开发计划 - CRM线索转化测试指引 - CRM线索管理测试指引 - CRM商机管理测试指引 - CRM架构改进报告 - CRM Bug修复报告 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
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）
cd hzhub-deploy
docker-compose up -d
启动完成后访问：
- 🌐 管理后台: http://localhost:5666
- 🚀 员工门户: http://localhost:5137
- 🔧 AI服务API: http://localhost:6039
- 🔄 n8n工作流: http://localhost:5678
本地开发启动（后台运行）
项目提供了便捷的后台运行管理脚本：
# 一键启动所有服务
cd /data/hzhub
./start-all.sh
# 查看所有服务状态
./status-all.sh
# 一键停止所有服务
./stop-all.sh
或分别启动各服务：
# 启动后端服务
cd hzhub-ai
./start.sh # 启动
./status.sh # 查看状态
./logs.sh # 查看日志
./stop.sh # 停止
# 启动管理后台
cd hzhub-admin
./start.sh
# 启动员工门户
cd hzhub-portal-employee
./start.sh
📖 详细说明请查看 服务管理文档
服务清单
| 服务名 | 容器名 | 端口 | 说明 |
|---|---|---|---|
| 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