线索管理模块 - 前端界面
📁 文件结构
crm/clue/
├── index.vue # 线索列表主页面
├── form.vue # 新增/编辑线索弹窗
├── followForm.vue # 添加跟进记录弹窗
├── convertForm.vue # 转为客户确认弹窗
├── assignForm.vue # 批量分配线索弹窗
├── detail.vue # 线索详情页面
└── README.md # 本文件
🎯 功能说明
1. 线索列表页面 (index.vue)
主要功能:
- ✅ 多视图切换:我的线索、全部线索、待跟进、今日新增、已转化
- ✅ 高级筛选:线索姓名、公司、手机号、来源、等级、状态、行业、日期范围
- ✅ 批量操作:批量分配、批量删除
- ✅ 导入导出:支持Excel导入导出
- ✅ 快捷操作:查看详情、编辑、添加跟进、转为客户、删除
权限标识:
crm:clue:list- 线索列表查询crm:clue:query- 线索详情查询crm:clue:add- 新增线索crm:clue:edit- 修改线索crm:clue:remove- 删除线索crm:clue:export- 导出线索crm:clue:import- 导入线索crm:clue:assign- 批量分配crm:clue:follow- 添加跟进记录crm:clue:convert- 转为客户
2. 新增/编辑表单 (form.vue)
表单分组:
- 基本信息:线索姓名、称呼、手机号、固定电话、公司名称、职位、邮箱、客户网站
- 详细信息:线索来源、线索等级、所属行业、预算范围、省市区、详细地址
- 需求信息:意向产品、预计购买时间、需求描述
- 分配信息:负责人、下次联系时间、备注
表单校验:
- 线索姓名:必填
- 手机号:必填,11位数字,格式校验
- 线索来源:必填
- 邮箱:邮箱格式校验
3. 添加跟进记录 (followForm.vue)
功能特点:
- ✅ 跟进方式选择(电话、微信、邮件、拜访、其他)
- ✅ 富文本跟进内容输入(10-1000字)
- ✅ 下次联系时间快捷选项(今天、明天、3天后、7天后)
- ✅ 附件上传(最多10个文件,单个最大10MB)
- ✅ 自动更新线索的最后跟进时间和跟进次数
4. 转为客户确认 (convertForm.vue)
转化流程:
- 显示线索信息预览
- 自动填充客户名称(从线索公司继承)
- 自动填充联系人姓名(从线索姓名继承)
- 填写转化原因(最少20字)
- 确认转化
转化后自动执行:
- 创建客户档案
- 创建主要联系人
- 复制跟进记录
- 线索标记为"已转化"
- 发送通知给负责人
5. 批量分配 (assignForm.vue)
功能说明:
- 选择新负责人
- 填写分配原因(最少10字)
- 支持批量分配多个线索
- 自动发送通知给新负责人
6. 线索详情页 (detail.vue)
页面布局:
- 左侧栏:
- 基本信息卡片
- 线索信息卡片
- 需求信息卡片
- 跟进统计卡片
- 右侧栏:
- 跟进记录时间线
- 操作日志(开发中)
- 附件管理(开发中)
功能特点:
- ✅ 一键拨号、发邮件
- ✅ 逾期提醒(下次联系时间逾期显示红色)
- ✅ 转化条件判断(满足条件显示"立即转化"按钮)
- ✅ 跟进记录时间线展示
- ✅ 可编辑/删除自己的跟进记录
📦 使用的字典
本模块使用以下数据字典,需要在系统中配置:
crm_clue_source- 线索来源crm_clue_level- 线索等级crm_clue_status- 线索状态crm_budget- 预算范围crm_follow_type- 跟进方式crm_title- 称呼crm_industry- 行业分类
详细字典数据请参考:crm/sql/crm/12-CRM字典数据汇总.md
🔧 依赖说明
全局方法
useDict()- 字典数据获取方法getToken()- 获取认证Token$modal- 全局消息提示方法$download- 文件下载方法$router- 路由对象$store- Vuex状态管理
引用的API
listUser()- 查询用户列表(from@/api/system/user)- 其他线索相关API(from
@/api/crm/clue)
UI组件
- Element Plus 组件库
- 项目公共组件:
<dict-tag>- 字典标签组件<pagination>- 分页组件<right-toolbar>- 右侧工具栏组件
🚀 使用说明
1. 配置路由
在路由配置中添加:
{
path: '/crm/clue',
component: Layout,
redirect: '/crm/clue/index',
meta: { title: '线索管理', icon: 'user' },
children: [
{
path: 'index',
component: () => import('@/views/crm/clue/index.vue'),
name: 'ClueIndex',
meta: { title: '线索列表', icon: 'list' }
},
{
path: 'detail',
component: () => import('@/views/crm/clue/detail.vue'),
name: 'ClueDetail',
meta: { title: '线索详情', activeMenu: '/crm/clue/index' },
hidden: true
}
]
}
2. 配置菜单权限
在后台管理系统的"系统管理 -> 菜单管理"中添加以下菜单和权限:
菜单:
- 线索管理(crm/clue)
权限标识:
crm:clue:list # 线索列表查询
crm:clue:query # 线索详情查询
crm:clue:add # 新增线索
crm:clue:edit # 修改线索
crm:clue:remove # 删除线索
crm:clue:export # 导出线索
crm:clue:import # 导入线索
crm:clue:assign # 批量分配
crm:clue:follow # 添加跟进记录
crm:clue:convert # 转为客户
3. 配置数据字典
执行SQL脚本配置字典数据:
mysql -u root -p your_database < crm/sql/crm/12-CRM字典数据汇总.md
或通过系统界面手动配置(系统管理 -> 字典管理)。
⚠️ 注意事项
1. TypeScript类型错误
代码中可能会出现一些TypeScript的类型错误提示,这是正常的,因为:
useDict、getToken等全局方法需要在项目的类型声明文件中定义$modal、$download等全局属性需要扩展 Vue 的类型定义
这些方法在运行时是可用的,不影响实际使用。
2. 已转化线索的限制
已转化的线索(isConverted === 1):
- ❌ 不能编辑
- ❌ 不能删除
- ❌ 不能添加跟进记录
- ❌ 不能再次转化
- ✅ 可以查看详情
- ✅ 可以查看跟进记录
3. 权限控制
所有按钮都使用 v-hasPermi 指令进行权限控制,确保用户只能看到和操作有权限的功能。
4. 数据校验
- 手机号唯一性校验在后端实现
- 前端只做格式校验
- 导入时会进行重复检查
🎨 样式风格
本模块遵循项目整体风格规范:
- 使用 Element Plus 组件库
- 卡片式布局
- 响应式设计
- 操作按钮使用图标+文字(列表页操作栏只用图标)
- 统一的颜色和间距
📝 开发规范
- 组件命名:使用 PascalCase 命名法
- 文件命名:使用 camelCase 命名法
- API请求:统一使用
@/utils/request中的 request 方法 - 错误处理:使用 try-catch 捕获异常
- 代码注释:关键功能添加注释说明
- TypeScript:严格使用类型定义
🔄 后续优化
以下功能待后续完善:
- 操作日志功能
- 附件管理功能
- 线索评分功能
- 线索统计分析页面
- 线索评分规则配置
- 编辑跟进记录功能
- 智能分配算法
- 自动提醒功能
📞 技术支持
如有问题,请参考:
- 项目需求文档:
docs/01-线索管理模块需求.md - API接口文档:
API/01-线索管理API接口.md - 数据库设计:
crm/sql/crm/01-crm_clue.sql - 原型图:
crm/yuanxing/01-线索管理原型图.md(相对仓库根目录)
开发完成时间:2025-10-03
开发者:AI Assistant
版本:v1.0