客资管理系统实施总结
创建时间：2026-04-14
作者：AI助手
状态：实施完成
一、需求概述
根据客户需求，实现一个完整的客资管理系统，具备以下功能：
| 功能 |
描述 |
| 客资派单 |
管理员可以直接派单客资给业务员 |
| 全民推荐 |
任何人都可以推荐客户赚取推荐费 |
| 推荐人报备 |
注册用户可以报备客户（推荐人报备） |
| 实时跟进 |
实时查看跟进情况和成交状态 |
| 多管理员 |
支持多管理员设置 |
| 数据统计导出 |
生成统计报表功能 |
二、实施成果
2.1 Java后端 (/Users/gxwebsoft/JAVA/mp-java)
数据库变更
文件: docs/sql/customer_lead_system.sql
| 表名 |
说明 |
cms_contact_lead |
扩展现有客资表，添加派单、推荐人等字段 |
lead_dispatch |
派单记录表 |
lead_follow_log |
跟进记录表 |
lead_referral |
推荐人关系表（全民推荐） |
sys_user_role_extend |
用户角色扩展表（多管理员） |
lead_statistics |
数据统计汇总表 |
lead_referral_settlement |
推荐费结算记录表 |
v_lead_full_info |
客资完整信息视图 |
新增实体类
| 文件路径 |
说明 |
cms/entity/CustomerLeadEntity.java |
客资管理扩展实体 |
cms/entity/LeadDispatch.java |
派单记录实体 |
cms/entity/LeadFollowLog.java |
跟进记录实体 |
cms/entity/LeadReferral.java |
推荐关系实体 |
cms/entity/LeadStatistics.java |
统计实体 |
common/system/entity/UserRoleExtend.java |
用户角色扩展实体 |
新增参数类
| 文件路径 |
说明 |
cms/param/CustomerLeadParam.java |
客资查询参数 |
cms/param/LeadDispatchParam.java |
派单请求参数 |
cms/param/LeadFollowParam.java |
跟进请求参数 |
cms/param/LeadReferralParam.java |
推荐人报备参数 |
新增Mapper
| 文件路径 |
说明 |
cms/mapper/CustomerLeadMapper.java |
客资管理Mapper |
cms/mapper/LeadDispatchMapper.java |
派单记录Mapper |
cms/mapper/LeadFollowLogMapper.java |
跟进记录Mapper |
cms/mapper/LeadReferralMapper.java |
推荐关系Mapper |
新增Service
| 文件路径 |
说明 |
cms/service/CustomerLeadService.java |
客资管理服务接口 |
cms/service/impl/CustomerLeadServiceImpl.java |
客资管理服务实现 |
cms/service/LeadReferralService.java |
推荐人服务接口 |
cms/service/impl/LeadReferralServiceImpl.java |
推荐人服务实现 |
新增Controller
| 文件路径 |
说明 |
cms/controller/CustomerLeadController.java |
客资管理控制器 |
cms/controller/LeadReferralController.java |
推荐人控制器 |
API端点
| 接口 |
方法 |
说明 |
/customer/lead/page |
GET |
分页查询客资列表 |
/customer/lead/detail/{leadId} |
GET |
获取客资详情 |
/customer/lead/create |
POST |
创建客资 |
/customer/lead/update |
PUT |
更新客资信息 |
/customer/lead/status/{leadId} |
PUT |
更新客资状态 |
/customer/lead/dispatch |
POST |
派单给业务员 |
/customer/lead/dispatch/batch |
POST |
批量派单 |
/customer/lead/follow |
POST |
添加跟进记录 |
/customer/lead/follow/history/{leadId} |
GET |
获取跟进历史 |
/customer/lead/statistics |
GET |
获取统计数据 |
/customer/lead/export |
GET |
导出客资数据 |
/customer/lead/unassigned |
GET |
获取未分配客资 |
/lead/referral/anonymous |
POST |
匿名用户报备 |
/lead/referral/user |
POST |
注册用户报备 |
/lead/referral/page |
GET |
推荐人推荐记录 |
/lead/referral/stats/{userId} |
GET |
推荐人统计 |
2.2 Vue后台管理端 (/Users/gxwebsoft/VUE/mp-vue)
新增API
| 文件路径 |
说明 |
api/cms/customerLead/model.ts |
类型定义 |
api/cms/customerLead/index.ts |
API接口 |
新增页面
| 文件路径 |
说明 |
views/cms/customerLead/index.vue |
客资管理列表页面 |
功能特性：
- 客资列表（分页、筛选、搜索）
- 统计卡片（总客资、待跟进、已成交、成交金额）
- 新增/编辑客资
- 派单给业务员（支持批量派单）
- 添加跟进记录
- 查看跟进历史
- 客资详情弹窗
2.3 微信小程序端 (/Users/gxwebsoft/VUE/template-10582)
新增API
| 文件路径 |
说明 |
api/shop/referral.ts |
推荐人API |
新增页面
| 文件路径 |
说明 |
dealer/referral/index.config.ts |
页面配置 |
dealer/referral/index.tsx |
推荐人报备页面 |
dealer/referral/index.scss |
页面样式 |
功能特性：
- 推荐人统计（总推荐、待确认、有效、待结算金额）
- 推荐新客户表单
- 推荐记录列表
- 状态追踪
首页入口
在分销商首页 /dealer/index.tsx 添加了「推荐客户」入口
三、数据字典
客资状态
| 值 |
文本 |
说明 |
| 0 |
待跟进 |
新客资，未分配或未联系 |
| 1 |
跟进中 |
正在跟进 |
| 2 |
已成交 |
客户已付款 |
| 3 |
无效 |
商机流失 |
客资来源
| 值 |
文本 |
说明 |
| form |
表单 |
网站/小程序表单提交 |
| website |
网站 |
网站表单 |
| miniapp |
小程序 |
小程序表单 |
| referral |
推荐人 |
推荐人报备 |
| admin |
管理员录入 |
后台手动添加 |
跟进方式
| 值 |
文本 |
说明 |
| 1 |
电话 |
电话沟通 |
| 2 |
微信 |
微信联系 |
| 3 |
上门 |
上门拜访 |
| 4 |
短信 |
短信通知 |
| 5 |
其他 |
其他方式 |
推荐状态
| 值 |
文本 |
说明 |
| 0 |
待确认 |
等待管理员确认 |
| 1 |
有效 |
推荐有效 |
| 2 |
无效 |
推荐无效 |
| 3 |
已结算 |
推荐费已结算 |
四、部署说明
4.1 数据库部署
4.2 后端部署
- 重新编译Java项目
- 部署到应用服务器
- 确保Mapper XML文件正确部署
4.3 前端部署
- Vue后台：
npm run build 部署dist目录
- 小程序：使用Taro构建并上传
五、后续优化建议
- 权限细化：根据实际业务需求，配置细粒度的按钮权限
- 数据看板：开发可视化数据大屏
- 消息通知：接入微信模板消息，实时推送派单/跟进通知
- 小程序入口：在首页增加「全民推荐」独立入口（非分销商专属）
- 推荐海报：生成带参数的推广海报，方便分享传播
- 佣金结算：完善佣金提现流程
六、注意事项
- SQL执行顺序：先执行数据库变更SQL，再部署后端代码
- Mapper XML：需要创建对应的Mapper XML文件
- 权限配置：在后台管理系统中配置对应的菜单和按钮权限
- 推荐费配置：可后续在配置表中添加推荐费比例等配置项
文档生成时间：2026-04-14
赵忠林
db5ca691d7