一、功能介绍
客资清洗由「数据概览」「客资清洗」「清洗配置」三个主标签组成，可查看回访统计、按清洗状态处理客资、记录回访结论、转出或驳回客资，并处理地址退回记录。清洗列表接口是真实分页和 Excel 导出，清洗配置也已接入数据库；主 LeadCleanseController 已有服务端细分权限守卫，但清洗配置固定读写全局 ID=1 且客服列表不按企业隔离，不能把前端按钮隐藏当作数据安全边界。
二、功能亮点
- 数据概览并行读取概览指标、已回访列表和回访结果排行。
- 清洗列表区分全部、未清洗、已清洗、无效客资和退回列表。
- 详情页展示客户、清洗、留资、收款、合同和标签信息，并支持上一条、下一条。
- 单条回访可记录方式、结果、客户意向、多个意向品类、沟通内容和下次跟进时间。
- 真实 Excel 导出复用当前筛选、不分页，后端最多输出 10000 行。
- 退回列表可把实际地址设为客户主地址，并依据主地址重新执行区域分配。
- 清洗配置真实保存领取开关、领取数量、手动分配开关及客服姓名和主叫号码。
三、使用场景
适用于广告、表单或批量导入客资在销售分配前核验有效性，也适用于回访后转出、驳回以及地址退回的二次处理。配置标签只适合受信平台运营人员维护全局清洗规则，当前不适合作为各企业独立自助配置。
四、使用权限
- 进入页面依赖「客资清洗」菜单可见性；前端仅对导出和两项批量操作做按钮权限判断。
- 导出使用 `/flow/cleanse` 下的 `export`，批量转出使用 `batchTransfer`，批量驳回使用 `batchReject`。
- 详情、单条转出、单条回访、确认地址、重新分配和整个清洗配置标签没有前端按钮权限判断。
- CleanseConfigController 仅有 `CUSTOMER_SALES` 专区守卫，没有配置查看、编辑和客服维护的细分权限。
- 接口返回的 `can_detail`、`can_transfer` 和 `can_follow` 只影响单行按钮显示，不构成控制器级授权。
- 清洗配置和客服是全局共享数据；在补齐企业隔离及服务端授权前，只允许受信平台人员操作。
五、前置条件
- 确认操作者属于经批准的清洗岗位，并取得目标客资范围、导出、转出、驳回和地址变更授权。
- 客资已经通过合法渠道进入系统并具有有效客资 ID；先在客资列表核对当前负责人、组织和状态。
- 企业已经书面定义有效、无效、待继续清洗、转出及驳回口径，并规定抽检和纠错流程。
- 确认来源树以及回访方式、回访结果、客户意向和意向品类 Picklist 已加载；加载失败时页面可能显示编码或短横线。
- 批量操作前先导出或记录筛选条件、勾选 ID、当前状态、负责人和预期结果，以便逐条复核。
- 确认地址前核对客户提交地址、退回实际地址和授权证明；重新分配前确认区域规则与目标负责人可用。
- 修改清洗配置前取得平台级变更审批，记录旧值和回滚值；当前设置会影响全局。
- 维护客服前确认姓名和主叫号码准确、合法且不重复，并完成删除前的业务引用检查。
六、操作步骤
- 进入「流量分配 → 客资清洗」。默认打开「数据概览」，页面并行读取统计、已回访列表和回访结果排行；某一请求失败时先停止依据卡片作业务判断。
- 在数据概览按关键词、留资方式、回访结果、回访类型、清洗类型和时间范围筛选，核对统计卡片、列表总数及排行口径。
- 点击概览卡片可查看对应明细；从列表进入详情时核对 URL 中客资 ID，查看客户、清洗、留资、收款、合同和标签记录。上一条、下一条按进入时的标签范围导航。
- 切换到「客资清洗」，选择全部、未清洗、已清洗、无效客资或退回列表。普通列表默认每页 50 条，支持创建或留资时间、姓名/手机号/三方客资 ID、来源、回访方式、回访结果和广告名称筛选。
- 展开更多条件前注意省市区控件当前没有选项。点击搜索后记录总数和筛选条件；重置会恢复创建时间口径、清空筛选及勾选项。
- 点击目标客资「回访」，选择客户意向和至少一个意向品类，填写不超过 500 字的沟通内容；按需补充回访方式、结果和下次跟进时间后提交。
- 提交成功后刷新原列表或详情，核对最新回访时间、结果、清洗状态和记录内容。语音按钮不会录音或转写，必须使用文字。
- 单条「转出」和详情页「驳回」提交前不会弹出确认。先人工复述客户名称、手机号后四位、客资 ID 和目标结果，再点击一次并等待响应。
- 需要批量处理时先完成筛选，再勾选明确记录。批量转出和批量驳回同样没有二次确认；当前批量驳回不填写原因，接口收到的 reason 为空。
- 具备 `export` 时点击导出。请求移除分页参数并复用筛选，后端最多导出 10000 行；下载后核对行数、筛选口径和敏感信息保管要求。
- 在「退回列表」按客户名称或电话搜索。点击「确认地址」会直接把退回实际地址设为客户主地址且没有二次确认；完成后重新打开客户地址核对。
- 需要重新匹配区域时点击「重新分配」。该操作也没有二次确认；核对成功提示中的区域和负责人，再刷新退回列表、客资详情和负责人列表。
- 进入「清洗配置」前确认这是全局配置。记录领取开关、最高领取数和手动分配开关旧值，修改后保存并重新加载。页面限制数量为 1–100，但后端不复核范围。
- 添加客服时姓名和主叫号码必填；保存后核对列表。删除具有弹窗确认，但后端直接物理删除且不检查业务引用，必须先迁移相关领取或分配关系。
七、字段与规则说明
- 用户界面统一使用“客资”，接口和模型仍保留 Lead 技术标识。
- 普通列表默认每页 50 条，可切换 10、20、50 或 100 条；切换子标签或页容量会回到第 1 页并清空勾选。
- 单行按钮是否显示取决于 `can_detail`、`can_transfer` 和 `can_follow`；直接接口仍需另行授权，当前控制器未强制。
- 客户意向、意向品类和沟通内容是回访必填项；意向品类以逗号拼接提交。
- 批量驳回页面不收集理由，调用 `batchReject(leadIds)` 时 reason 为空。
- 单条转出、详情驳回、批量转出、批量驳回、确认地址和重新分配当前都没有二次确认。
- 导出复用列表筛选但不分页，服务端上限 10000 行；达到上限不代表已导出全部匹配记录。
- 确认地址把 `is_return_actual=true` 的地址设为客户主地址；重新分配再依据主地址匹配区域。
- 省市区级联器没有选项，不能完成地域筛选。
- 语音输入只显示开发中提示，不会录音或转写。
- 清洗配置固定使用 `CONFIG_ID=1`，没有 authCorpId、tenantId 或 ownerId；所有企业共享同一组开关和领取数量。
- 客服列表使用全表 `findAll()`，客服实体没有企业范围；删除客服为物理删除。
- 领取数量页面限制 1–100，后端 saveConfig 只判空后直接保存，不校验范围。
- 跟进结果配置是后端固定的 8 条静态字典，不是企业可维护的动态列表。
八、风险与限制
转出、驳回、确认地址和重新分配会直接改变客资流向、主地址或归属，且当前都没有二次确认。主控制器缺少服务端功能权限、配置与客服全局共享，使误操作可能跨越预期角色或企业边界；导出还可能一次包含最多 10000 条个人信息。
注意
任何转出、驳回、地址确认、重新分配和导出都先做人工双人复核；不要连续点击或依赖撤销。清洗配置按平台级高风险配置管理，普通企业管理员不得自行修改。沟通内容和导出文件不得包含或扩散超出业务必要范围的个人信息。
九、常见问题
- 为什么没有导出或批量菜单？当前角色缺少 `export`、`batchTransfer` 或 `batchReject` 前端按钮权限。
- 有按钮是否代表后端已授权？不代表；控制器已按 `/flow/cleanse` 菜单功能键做服务端强制校验，仍需在角色后台为角色勾选对应权限。
- 为什么某条记录没有回访或转出？接口可能把 `can_follow` 或 `can_transfer` 标为 false，但这只是行级显示条件。
- 为什么省市区无法选择？级联器当前使用空选项，地域筛选不可用。
- 为什么语音按钮没有录音？当前浏览器不支持语音识别（Web Speech API），请使用文字记录或更换支持的浏览器。
- 批量驳回能填写原因吗？当前页面不提供原因输入，提交的 reason 为空。
- 导出是否包含全部记录？最多 10000 行，达到上限时不能据此确认已覆盖全部匹配数据。
- 为什么转出或确认地址没有确认框？当前这些操作会直接发起请求，点击前必须人工核对。
- 清洗配置是否按企业独立？不是，配置固定使用全局 ID=1，客服列表也没有企业字段。
- 领取上限一定只能是 1–100 吗？页面控件如此限制，但后端未校验，异常接口调用可保存越界值。
- 删除客服后能恢复吗？不能，后端物理删除且没有恢复入口。
- 重新分配后如何确认？核对提示中的区域和负责人，再检查退回列表、客资详情和负责人归属。
十、相关指南
清洗结果需要审批时继续《审核客资》，需要改变负责人时阅读《分配客资》，完成后通过《管理客资列表》和《查看客资看板》复核状态与归属。
说明
页面入口：/flow/cleanse、/flow/cleanse/detail/:leadId