Files
hzhub/docs
大壮 3f643ef31f feat: 完成CRM商机和线索管理模块开发
## 新增功能

### 商机中心 (/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>
2026-05-20 09:46:59 +00:00
..

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 4.0│         │ Boot 4.0│
    │·Spring  │         │·JDBC    │
    │ AI 2.0  │         │·SQL Svr │
    │·LangChain│        │ 2008 R2 │
    │ 4j      │         │·双数据源│
    │·MySQL   │         │ 预留    │
    │·Milvus  │         │         │
    │·RAG/智能体│        │         │
    └─────────┘         └─────────┘

项目结构

foshanhuiya/hzhub/
├── hzhub-ai/              # AI服务基于hzhub-aiSpring Boot 4.0
├── hzhub-erp/             # ERP服务Spring Boot 4.0
├── hzhub-gateway/         # API网关Spring Boot 4.0
├── hzhub-admin/           # 管理后台前端
├── hzhub-portal-employee/  # 公司门户前端
├── hzhub-portal-dealer/   # 经销商门户前端
└── hzhub-deploy/          # 部署脚本与配置

技术栈

层级 技术选型
前端 Vue 3 + Element Plus
网关 Spring Cloud Gateway
AI服务 Spring Boot 4.0 + Spring AI 2.0 + LangChain4j
ERP服务 Spring Boot 4.0 + JDBC
向量数据库 Milvus
关系数据库 MySQL 8.0 + SQL Server 2008 R2
工作流 n8n
部署 Docker Compose

文档索引

创建时间

2026-03-26