三、线索管理
菜单入口：CRM客户 → 线索管理（/crm/clue）。线索位于 CRM 漏斗的最上游：展会名单、广告投放、陌拜等渠道获得的尚未确认的潜在客户信息先沉淀为线索，经跟进确认有效后转化为客户，再进入联系人 / 商机 / 合同环节。
3.1 线索列表
页面操作：查询、创建、更新、删除、导出。
- 查询条件：线索名称、转化状态（未转化 / 已转化）、手机号、电话；
- 数据范围页签：我负责的 / 我参与的 / 下属负责的；
- 列表展示：线索名称（点击进入详情）、线索来源、手机、电话、邮箱、地址、客户行业、客户级别、下次联系时间、最后跟进时间 / 最后跟进记录、负责人、所属部门、创建人等。
3.2 新建线索
| 字段 | 说明 |
|---|---|
| 线索名称 | 必填 |
| 客户来源 | 字典 CRM_CUSTOMER_SOURCE（与客户共用一套来源字典） |
| 手机 / 电话 / 邮箱 / 微信 / QQ | 联系方式，均为选填 |
| 负责人 | 必选，创建后不可在编辑中修改，变更走详情页"转移" |
| 客户行业 / 客户级别 | 与客户共用字典，转化时直接带给新客户 |
| 地址（省市区）+ 详细地址 | 转化时复制给新客户 |
| 下次联系时间 / 备注 | 跟进计划安排 |
3.3 线索状态模型（重要）
线索没有独立的状态字段，状态由两个布尔字段组合表达：
| 字段 | 含义 | 取值变化 |
|---|---|---|
| followUpStatus（跟进状态） | 新建后默认待跟进；写了第一条跟进记录后置真，变为跟进中 | 待跟进 → 跟进中 |
| transformStatus（转化状态） | 转化为客户后置真，即已转化，并回填生成的 customerId | 未转化 → 已转化 |
- 没有"已废弃"概念：确认无效的线索直接删除，删除时同时删除该线索的跟进记录与数据权限，不留僵尸数据；
- 列表用"转化状态"筛选未转化 / 已转化线索，便于盯住待转化池。
3.4 线索跟进
在线索详情页【跟进记录】页签写跟进：保存后系统自动更新线索的 followUpStatus（置为跟进中）、最后跟进时间 / 最后跟进记录，以及本次填写的下次联系时间。跟进是线索存活的基本动作——"分配给我的线索"待办（见 待办事项）正是筛出"我负责 + 未跟进 + 未转化"的线索。
3.5 线索转化为客户（核心动作）
入口：线索详情页【转化为客户】按钮（已转化的线索该按钮置灰为"已转化客户"，不可重复转化；后端同样校验，重复转化直接报错）。
转化在一个事务内完成三步：
- 生成新客户：复制线索的手机、地区（省市区）、客户行业、客户级别、客户来源等信息，负责人 = 操作人；
- 回写线索：标记
transformStatus = 已转化，并回填新生成的customerId建立关联； - 批量复制跟进记录：把线索名下的全部跟进记录复制到新客户名下，保证客户侧跟进历史不中断。
转化后线索仍保留在列表中（转化状态 = 已转化），可追溯来源与转化过程。
3.6 业务规则与注意事项
- 线索没有手机号查重：新建线索时不做手机号唯一性校验，系统不会自动拦截重复线索；如需查重，只能用列表的"手机号"查询条件人工搜索核对；
- 对比：客户的 Excel 导入按客户名称查重——因此"重复线索 → 转化"会产生重复客户，转化前建议先按手机号搜索确认；
- 删除线索会连带删除其跟进记录与数据权限，请确认后再删；
- 已转化的线索不可再转化，一个线索只能产生一个客户。
📖 相关文档
- 客户管理（线索转化成客户）