feat(customer-lead): 实现完整客资管理系统及全民推荐功能

- 新增客资管理系统数据库变更脚本，扩展客资表及新增派单、推荐关系等多张表
- 实现客资派单、跟进、统计、导出等核心业务逻辑，支持多管理员配置
- 开发Java后端实体、参数、Mapper和服务，实现完整业务流程接口
- 提供客资管理相关REST API，涵盖分页查询、详情、状态更新、派单、跟进和统计等
- 新增全民推荐模块，支持匿名及注册用户报备推荐客户，并提供推荐记录管理
- 开发推荐人相关API接口，支持推荐码生成与查询，推荐确认及结算功能
- Vue后台新增客资管理页面，实现客资列表、派单、跟进、详情查看等功能
- 微信小程序端新增推荐客户页面，支持推荐记录展示和推荐状态跟踪
- 完善数据字典和部署说明，涵盖状态说明、来源类型和跟进方式
- 提出后续优化建议，包括权限细化、数据看板、消息通知以及推荐海报功能等

docs/ai/customer-lead-system-summary.md

@@ -0,0 +1,230 @@
+# 客资管理系统实施总结
+
+> 创建时间：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 数据库部署
+```bash
+# 执行SQL脚本
+mysql -u root -p your_database < docs/sql/customer_lead_system.sql
+```
+
+### 4.2 后端部署
+1. 重新编译Java项目
+2. 部署到应用服务器
+3. 确保Mapper XML文件正确部署
+
+### 4.3 前端部署
+1. Vue后台：`npm run build` 部署dist目录
+2. 小程序：使用Taro构建并上传
+
+---
+
+## 五、后续优化建议
+
+1. **权限细化**：根据实际业务需求，配置细粒度的按钮权限
+2. **数据看板**：开发可视化数据大屏
+3. **消息通知**：接入微信模板消息，实时推送派单/跟进通知
+4. **小程序入口**：在首页增加「全民推荐」独立入口（非分销商专属）
+5. **推荐海报**：生成带参数的推广海报，方便分享传播
+6. **佣金结算**：完善佣金提现流程
+
+---
+
+## 六、注意事项
+
+1. **SQL执行顺序**：先执行数据库变更SQL，再部署后端代码
+2. **Mapper XML**：需要创建对应的Mapper XML文件
+3. **权限配置**：在后台管理系统中配置对应的菜单和按钮权限
+4. **推荐费配置**：可后续在配置表中添加推荐费比例等配置项
+
+---
+
+*文档生成时间：2026-04-14*