Files
shanxia2.0/web-admin/src/views/crm/clue
2026-06-21 09:19:07 +08:00
..
2026-06-21 09:19:07 +08:00
2026-06-01 08:21:21 +08:00
2026-06-01 08:21:21 +08:00
2026-06-01 08:21:21 +08:00
2026-06-21 09:19:07 +08:00
2026-06-06 19:44:18 +08:00
2026-06-06 19:44:18 +08:00
2026-06-06 19:44:18 +08:00
2026-06-21 09:19:07 +08:00
2026-06-01 08:21:21 +08:00

线索管理模块 - 前端界面

📁 文件结构

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)

表单分组:

  1. 基本信息:线索姓名、称呼、手机号、固定电话、公司名称、职位、邮箱、客户网站
  2. 详细信息:线索来源、线索等级、所属行业、预算范围、省市区、详细地址
  3. 需求信息:意向产品、预计购买时间、需求描述
  4. 分配信息:负责人、下次联系时间、备注

表单校验:

  • 线索姓名:必填
  • 手机号:必填,11位数字,格式校验
  • 线索来源:必填
  • 邮箱:邮箱格式校验

3. 添加跟进记录 (followForm.vue)

功能特点:

  • ✅ 跟进方式选择(电话、微信、邮件、拜访、其他)
  • ✅ 富文本跟进内容输入(10-1000字)
  • ✅ 下次联系时间快捷选项(今天、明天、3天后、7天后)
  • ✅ 附件上传(最多10个文件,单个最大10MB)
  • ✅ 自动更新线索的最后跟进时间和跟进次数

4. 转为客户确认 (convertForm.vue)

转化流程:

  1. 显示线索信息预览
  2. 自动填充客户名称(从线索公司继承)
  3. 自动填充联系人姓名(从线索姓名继承)
  4. 填写转化原因(最少20字)
  5. 确认转化

转化后自动执行:

  • 创建客户档案
  • 创建主要联系人
  • 复制跟进记录
  • 线索标记为"已转化"
  • 发送通知给负责人

5. 批量分配 (assignForm.vue)

功能说明:

  • 选择新负责人
  • 填写分配原因(最少10字)
  • 支持批量分配多个线索
  • 自动发送通知给新负责人

6. 线索详情页 (detail.vue)

页面布局:

  • 左侧栏:
    • 基本信息卡片
    • 线索信息卡片
    • 需求信息卡片
    • 跟进统计卡片
  • 右侧栏:
    • 跟进记录时间线
    • 操作日志(开发中)
    • 附件管理(开发中)

功能特点:

  • ✅ 一键拨号、发邮件
  • ✅ 逾期提醒(下次联系时间逾期显示红色)
  • ✅ 转化条件判断(满足条件显示"立即转化"按钮)
  • ✅ 跟进记录时间线展示
  • ✅ 可编辑/删除自己的跟进记录

📦 使用的字典

本模块使用以下数据字典,需要在系统中配置:

  1. crm_clue_source - 线索来源
  2. crm_clue_level - 线索等级
  3. crm_clue_status - 线索状态
  4. crm_budget - 预算范围
  5. crm_follow_type - 跟进方式
  6. crm_title - 称呼
  7. 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 组件库
  • 卡片式布局
  • 响应式设计
  • 操作按钮使用图标+文字(列表页操作栏只用图标)
  • 统一的颜色和间距

📝 开发规范

  1. 组件命名:使用 PascalCase 命名法
  2. 文件命名:使用 camelCase 命名法
  3. API请求:统一使用 @/utils/request 中的 request 方法
  4. 错误处理:使用 try-catch 捕获异常
  5. 代码注释:关键功能添加注释说明
  6. TypeScript:严格使用类型定义

🔄 后续优化

以下功能待后续完善:

  1. 操作日志功能
  2. 附件管理功能
  3. 线索评分功能
  4. 线索统计分析页面
  5. 线索评分规则配置
  6. 编辑跟进记录功能
  7. 智能分配算法
  8. 自动提醒功能

📞 技术支持

如有问题,请参考:

  • 项目需求文档: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