分配客资

一、功能介绍

留资分配页面集中处理客资分配、导入、领取提醒、退回客资池和回访任务，支持选中记录、当前页或当前筛选全部三种批量口径。回访子域具有专门权限守卫，但分配列表、详情、导出、单条和批量分配主要只受 `CUSTOMER_SALES` 专区及前端按钮控制；列表与导出明确不加企业或组织数据范围，批量分配还按任意主键读取客资，因此必须按平台级公共池高风险工具管理。

二、功能亮点

1. 在全部、未分配、已分配、无效客户、退回客资池、提醒和回访标签间切换。
2. 普通列表提供二十余项筛选、真实分页和无分页 Excel 导出。
3. 批量分配支持已选、当前页和当前筛选全部，前端排除已领取记录。
4. 单条区域分配按区、市、省优先级解析规则，并在服务端拒绝已领取或已分配客资。
5. 退回池可确认主地址或进入人工重新分配。
6. 回访任务具备查看、本人管理和团队管理三档服务端权限。

三、使用场景

适用于受信平台运营人员在公共待分配池中按区域、组织或员工分派客资，并处理领取提醒、地址退回和团队回访。当前不适合普通企业或组织管理员在多租户实例中自助分配。

四、使用权限

1. 手动新建使用 `add`，批量导入使用 `import`，批量分配和单条区域分配使用 `batchAllocation`，导出使用 `export`。
2. `add` 缺失但具有 `batchAllocation` 时，页面仍显示手动新建按钮。
3. 我的回访需要 `LEAD_RETURN_VISIT_VIEW`，创建、完成和取消本人任务需要 `LEAD_RETURN_VISIT_MANAGE`，团队列表、统计、提醒重试和改派需要 `LEAD_RETURN_VISIT_TEAM_MANAGE`；这些回访接口有服务端守卫。
4. LeadController 的列表、详情、导出、手动分配、单条分配和批量分配没有对应按钮键的服务端细分权限，只依赖专区或页面隐藏。
5. 列表与导出服务明确把客资分配视为公共待分配池，不按 authCorpId、当前企业、可见组织或用户范围过滤。
6. 批量分配使用任意 ID 集合读取客资，也没有验证目标员工属于当前 authCorpId、处于启用状态或属于所选组织。
7. 在企业和组织隔离、批量服务校验及服务端功能权限补齐前，只允许受信平台人员操作。

五、前置条件

1. 取得平台级分配工单，明确目标客资 ID、当前企业、组织、负责人、领取状态、目标员工和回滚负责人。
2. 确认客资已完成必要审核或清洗，并通过客户列表独立核对 authCorpId 与业务归属；不要仅依赖公共分配列表。
3. 确认目标员工属于同一企业、处于启用状态、属于目标组织且具有承接能力；批量接口不会完整验证这些条件。
4. 区域分配前核对客资省市区以及启用的区、市、省规则，记录预期命中规则与负责人。
5. 批量操作前明确口径是已选、当前页还是全部筛选结果，并导出或记录筛选条件、总数和样本 ID。
6. 处理退回客资前核对退回实际地址、客户主地址、原负责人和重新分配原因。
7. 回访任务操作前确认当前权限档位、负责人、到期时间、结果口径和改派理由。

六、操作步骤

1. 进入「流量分配 → 留资分配」。先确认这是平台公共池页面，再选择全部、未分配、已分配、无效客户或退回客资池。
2. 按创建/留资/分配时间、姓名或电话、品类、意向、确认意愿、来源、领取与分配状态、经销商、客户状态、跟进状态、二级渠道和输入来源筛选；展开后可增加地域、人工拨打等条件。
3. 搜索后记录总数并抽查至少三条客资的企业、组织、负责人和状态。列表后端不做企业/组织范围过滤，出现非目标企业数据时立即停止。
4. 打开详情核对客资、归属和分配日志。详情 URL 携带当前页 ID 集合用于上一条/下一条，但后端详情按主键读取，不把当前列表范围当授权。
5. 单条按区域分配会立即调用接口，没有二次确认。点击前核对客资尚未领取和未分配、地址完整、规则命中预期；成功后记录返回的规则、区域、目标员工和门店。
6. 批量分配先选择“已选可分配数据”“当前页可分配数据”或“全部可分配数据”。“全部”会用 pageSize=当前总数重新请求，数据量大时可能产生超大响应。
7. 在员工选择器核对组织和员工。弹窗确认即直接提交，没有额外批次摘要；先人工复述批次数量、目标企业、组织、员工和回滚负责人。
8. 批量服务会跳过已领取记录，但不会逐条按当前企业过滤；提交后不能只相信“分配成功”，必须按提交 ID 全量对账成功、跳过、缺失和异常跨企业记录。
9. 分配完成后检查负责人、归属组织、分配动作、待领取状态、分配日志和提醒周期。退回池客资还可能同步更新客户 owner，需到客户详情复核。
10. 需要新增数据时按权限使用手动新建或批量导入；导入结束后核对成功、失败、重复记录和企业归属。
11. 提醒领取前只勾选批准范围，发出后到提醒列表核对投递状态；重试提醒有浏览器确认。
12. 退回客资池按姓名或电话查询。确认地址会直接把退回实际地址设为主地址且无二次确认；人工重新分配会打开员工选择器。该标签当前不支持导出。
13. 具备回访权限时创建、完成或取消本人的任务；团队管理员可查看团队列表、统计和提醒，改派必须选择新负责人并填写最多 500 字的原因。
14. 普通列表导出使用当前筛选但无分页和行数上限证据，包含手机号、地址、微信号、归属和备注；只在批准范围内执行并加密保管。

放大查看

从流量分配进入留资分配，核对筛选区、批量操作与分配列表。

关闭

放大查看

在留资分配页按客户姓名、电话、地址、品类、意向等条件筛选客资并批量操作。

关闭

放大查看

切换到退回客资池页签，按客户名称或客户电话查询退回客资。

关闭

七、字段与规则说明

1. 列表只展示 `isRootIssued=true` 的总部客资；returned 标签按 assignAction=RELEASE，其余标签排除 RELEASE。
2. 列表与导出明确不做企业或组织数据权限过滤，所有能调用接口的用户可看到公共池匹配数据。
3. 关键词后端只匹配客户姓名和手机号，页面提示中的地址不会参与关键词查询。
4. 详情使用 `findById(id)`，没有 authCorpId 或可见范围条件。
5. 单条分配会按当前 authCorpId 校验客资与员工，验证员工启用且属于目标组织；批量分配没有这些同等级校验。
6. 批量分配按 `findAllById(ids)` 获取客资，跳过已领取项，但没有按当前企业过滤，也不报告逐条跳过清单。
7. 批量分配的“全部”按每页最多 200 条分页拉取，逐页累计全部可分配客资 ID 后再提交批量分配。
8. 已领取客资在页面不可勾选，单条和批量服务也会拒绝或跳过；待领取的已分配客资仍可能被批量改派。
9. 员工选择确认会立即执行批量分配，没有展示 ID 摘要或二次确认。
10. 单条区域分配拒绝已领取和已分配客资，按区、市、省规则优先级选择目标。
11. 导出调用与列表使用同一公共池条件但不分页，没有明确最大行数。
12. 确认地址把退回实际地址设为客户主地址；该操作没有二次确认。
13. 回访接口通过三类权限守卫，但这些权限不覆盖主分配列表、导出和分配写操作。
14. 退回客资池暂不支持从当前页面导出。

八、风险与限制

公共池列表、详情和导出缺少企业/组织范围，批量分配又按任意 ID 操作且缺少目标员工同企业、启用和组织关系校验，可能造成跨企业查看、导出或改派。全量口径、无二次确认、无逐条结果和无上限导出进一步放大误操作及个人信息泄露风险。

九、常见问题

1. 为什么能看到其他组织甚至其他企业的客资？列表被实现为公共待分配池，没有企业或组织数据范围过滤。
2. 单条和批量分配校验一致吗？不一致，单条会校验当前企业、员工启用和组织关系，批量没有同等级校验。
3. 为什么某些客资无法勾选？已领取客资不可选择；待领取的已分配客资仍可能可改派。
4. “全部”是如何拉取客资的？页面按每页最多 200 条分批请求并逐页累计可分配客资 ID，不再以当前总数作为单次请求量。
5. 批量成功是否表示每条都成功？不能这样判断，已领取项会被跳过且页面没有逐条结果，必须按 ID 对账。
6. 为什么关键词搜地址没有结果？后端关键词只匹配姓名和手机号。
7. 导出是否受当前企业范围限制？不是，导出复用公共池筛选且无组织范围。
8. 为什么退回池不能导出？当前页面明确不支持该标签导出。
9. 为什么没有我的回访或团队回访？当前角色缺少对应回访权限；这些权限与主分配权限是不同边界。
10. 分配后还需核对什么？检查负责人、组织、待领取状态、分配日志、提醒周期，并对退回池记录复核客户 owner。

十、相关指南

分配前用《处理客资清洗》和《审核客资》核对有效性，分配后通过《管理客资列表》与《查询客户跟进记录》验证归属和后续执行。