线索管理
这篇解决什么
线索存在哪、怎么转成客户,跟进记录跟不跟过去。读完能对上 crm_clue、PUT /crm/clue/transform,以及 transformStatus / customerId。
默认端口 48080,管理端前缀 /admin-api。PC 开发页 http://127.0.0.1:5800。转成客户之后见 客户管理、公海客户。
示意图:转化是新建一行客户,线索留下并打已转化。不要把线索表当客户表改。
从哪改
| 名称 | 说明 | 仓库路径 |
|---|---|---|
| 线索接口 | @RequestMapping("/crm/clue") | ruoyi-office/yudao-module-crm/.../controller/admin/clue/CrmClueController.java |
| 线索表 | crm_clue | CrmClueDO |
| 转移 | PUT /transfer | 同上 |
| 转化 | PUT /transform | CrmClueServiceImpl.transformClue |
| 跟进条数 | GET /follow-count | 同上 |
| PC | /crm/clue | ruoyi-office-vben/apps/web-antd/src/views/crm/clue/ |
官方菜单 2404 线索管理。按钮 crm:clue:create / update / delete / transform。数据权限用 @CrmPermission,bizType 是线索。

本系统截图:CRM → 线索管理。转化状态和客户编号在转化成功后才有。
转化做什么
transformClue 只处理未转化的行。已经 transformStatus = true 再点会失败。
| 名称 | 说明 | 仓库路径 |
|---|---|---|
name / 联系方式 | 拷到新客户 | CrmCustomerCreateReqBO |
transformStatus | 线索打已转化 | crm_clue |
customerId | 指向新客户 | 同上 |
| 跟进记录 | 按线索复制一份到客户 | crm_follow_up_record |
CREATE TABLE crm_clue (
id bigint NOT NULL AUTO_INCREMENT,
name varchar(255) DEFAULT NULL,
owner_user_id bigint DEFAULT NULL,
transform_status bit(1) DEFAULT NULL,
customer_id bigint DEFAULT NULL,
PRIMARY KEY (id)
);示意图:线索行还在,用来对账。以后跟客户,不要继续改已转化线索当主数据。
线索没有公海
公海只作用于 crm_customer。线索靠转移负责人,没有 put-pool。不要给线索套客户掉海 Job。
行业、等级、来源字典和客户共用 CRM_CUSTOMER_*。联系人表 crm_contact 挂在客户上,转化时不会自动拆出联系人行,需要的话到客户详情再补。
配置与操作
走 CRM → 线索管理(菜单 2404)建线索,填 name、联系方式、ownerUserId。转移走 PUT /transfer。转化走 PUT /transform:未转化才能点,成功后线索 transformStatus 打已转化、写下 customerId,并复制跟进到新客户。
保存后客户列表立刻能看到新行。已转化线索不要再当主数据改。行业、等级、来源字典和客户共用。转化不会自动拆 crm_contact,到客户详情再补。线索没有公海。
