4.6 KiB

Raw Blame History

A4 客户管理

对应蓝湖原型「A4 客户管理」分区（A4-1 客户公海 / A4-2 客户总览 / A4-3 我的客户 / A4-4 客户详情 / A4-5 联系人 / A4-6 客户查重 / A4-7 客户交割）。

已落地接口（55 个 + 根级 2 个 = 57 个）

客户管理/（10）：新增客户、编辑客户、客户详情、客户分页、商机侧客户搜索、快速创建客户、按客户查联系人、名称相似提示、信用代码查重、工商信息查询
客户三 workspace/（3）：workspace 列表分页、看板分组汇总、看板单列卡片
- 对应原型 A4-1/A4-2/A4-3 三个列表页：路径段 {workspace} 取 mine / overview / pool 三值，一套端点三处复用
归属流转/（9）：领取客户、批量领取、分配客户、批量分配、抛公海、批量抛公海、归档客户、批量归档、恢复客户
客户详情页/（8）：详情公共头部、团队成员页签、添加团队成员、移除团队成员、关联商机页签、操作日志分页、新增跟进、跟进记录分页
A4-5 联系人/（7）：新增联系人、编辑联系人、删除联系人、联系人详情、顶级联系人列表、联系人全局搜索、电话软提示
客户关注与重点标记/（5）：关注客户、取消关注客户、标记重点客户、取消重点标记、批量关注客户
客户交割/（6）：发起前客户预览、发起交接、交接详情、交接记录分页、客户分配、可分配销售列表
客户导入/（6）：上传导入文件并预校验、确认执行导入、任务结果、失败疑似重复明细、最近导入记录、下载导入模板
模块健康/（1）：健康探针
根级 客户管理/超期提醒规则/（2）：当前提醒规则、保存提醒规则 —— 见下「为什么超期提醒规则在根级」

示例值说明：各 .bru 的请求/响应示例均注入 E2E 实测真值（标注「示例数据（E2E 实测真值/实测值注入）」的为真实抓取，其余为语义兜底）。

为什么超期提醒规则在根级

超期提醒规则的两个端点（GET/PUT /api/rule/customer/reminder）实现在 crm-rule 模块（CustomerReminderRuleController），源码 @Tag 原文为「客户管理」（无 A4 前缀）。按「结构听源码」铁律，目录 = tag 原文，故其生成在 collection 根级 客户管理/超期提醒规则/ 而非 A4 客户管理/ 下——bruno-sync 重跑时按 tag 归位，挪进 A4 会产生孤儿目录。

crm-preference 6 端点说明（不生成副本）

客户模块功能上依赖 crm-preference 的自定义视图（saved-view）6 个端点（列表 / 保存 / 删除 / 设为默认等），但其源码 @Tag 挂在 A3 商机管理 分区（商机先建 saved-view，客户侧复用同一套），为避免 sync 重跑产生副本/孤儿，本分区不生成副本，文档见 A3 分区对应目录。前端对接时 scopeKey 传 customer.*（如 customer.workspace.mine），接口本身与商机共用：

GET /api/preference/saved-view/list?scopeKey=customer.*（自定义视图列表）
POST /api/preference/saved-view（保存自定义视图）
DELETE /api/preference/saved-view/{id}（删除自定义视图）
PUT /api/preference/saved-view/{id}/default（设为默认视图）

（以上为文字索引；A3 分区文档中的 scopeKey 示例为商机域，客户域联调请按本段替换 scopeKey。）

空缺标注

无 —— 原型 A4 各功能页均有接口落地。已知缺口（不影响联调，详见 E2E 报告）：QuickCreateDTO 无 confirmSimilar 字段、详情汇总卡 5 字段恒 null 前端显 "--"、页签 5/6 汇总卡同。

对接工程师示位

客户模块前端按页面目录联调：三个列表页共用「客户三 workspace/」（分页 + 看板两个子端点，路径段换 workspace）；客户详情页接口集中在「客户详情页/」下（公共头部 + 6 页签共享 8 端点）；联系人独立页在「A4-5 联系人/」；全生命周期归属操作（领取 / 分配 / 抛公海 / 归档等）在「归属流转/」；客户交割（总监交接）在「客户交割/」；Excel 导入全流程在「客户导入/」。

维护纪律：本 README 为人工维护的分区索引；.bru 接口文件由生成器依据后端 Controller tag 自动同步（只动带 generated 标记的文件，结构听源码、表述听人），请勿手改。各 .bru docs 首行 METHOD path 为对账钥匙行，勿手改（对账脚本以此比对源码 mapping）。agent 不执行 git 提交，由维护者审查后自行提交。

4.6 KiB Raw Blame History