一、功能介绍
客资审核以当前企业真实客资为申请对象，状态按待审核、审核通过、审核拒绝和已撤销流转。企业可使用单级审批，也可配置最多 10 级的条件审批；提交时会冻结当时命中的节点、审批人和策略版本，后续修改策略不影响在途申请。审批动作、逐节点企微待办和最终结果通知均保留可追溯证据。
二、功能亮点
- 按全部、待审核、审核通过、审核拒绝和已撤销筛选，支持审批单号、手机号或申请人关键词。
- 详情展示申请、客资地址、跟进记录、分配日志、审批节点、逐人动作和企微投递状态。
- 审批策略支持指定人员或角色、或签或会签，以及组织、类型、来源、省市区条件。
- 只有冻结在当前节点的审批人才能处理动态审批，单有管理按钮权限不代表能审批任意节点。
- 最后一级通过时可选门店和在职员工，审批与客资分配在同一事务完成。
- 审批终态不可逆；重复处理已结束记录会返回冲突。
三、使用场景
适用于客资在分配前需要核对真实来源、联系方式、地区、跟进上下文或提交组织，并按企业职责逐级批准的场景。没有启用动态策略时沿用单级审批；启用策略后，每次提交必须至少命中一个条件节点。
四、使用权限
- 查看列表、详情和策略需要 `FLOW_APPROVAL_VIEW`；提交或撤销申请需要 `FLOW_APPROVAL_SUBMIT`；审批和保存策略需要 `FLOW_APPROVAL_MANAGE`。后端对三个键分别强制校验。
- 列表和详情只在持有 `FLOW_APPROVAL_MANAGE` 时显示「审核」或「审批策略」，动态流程还会校验当前登录员工属于该节点提交时冻结的审批人。
- 所有审批单、策略、节点、客资引用和通知证据均按已验签 `authCorpId` 查询；客户端提交的审批人姓名和 ID 会被登录态覆盖。
- 审批详情直接显示手机号和地址，应仅向确有审核职责的人员授予查看权限，并按企业隐私制度留痕。
五、前置条件
- 由业务负责人定义通过标准、拒绝标准、必须核对的客资字段以及争议升级路径。
- 确认申请引用的是当前企业真实客资 ID；服务端会从客资表权威回填手机号、地区、地址和归属，不信任提交者伪造这些展示字段。
- 按关联客资 ID、手机号和申请人搜索现有待审记录。同一客资可能同时存在多张待审核审批单；发现重复单时先确定唯一有效单并暂停其余单据。
- 如启用动态策略，确认每个节点的人员或角色仍属于当前企业且处于启用状态。指定角色会在提交时解析成当时的在职员工并冻结。
- 为等于/不等于条件只配置一个值，为属于/不属于配置 1–20 个值；每个节点最多 8 个条件，整条策略最多 10 个节点。
- 需要审批后分配时，先确认目标门店与员工关系有效、员工在职且操作者具备分配所需权限。
- 同一审批单同一时段只安排一名审核人操作，并统一规定驳回备注格式。驳回备注前后端均强制必填，未填写原因的驳回会被直接拦截。
六、操作步骤
- 进入「流量分配 → 客资审核」。默认加载第 1 页 50 条；可切换每页 10、20、50 或 100 条。
- 点击「待审核」，再输入审批单号、手机号或申请人关键词并搜索。状态页签会映射为后端 `PENDING/APPROVED/REJECTED/REVOKED`。
- 先核对列表中的关联客资 ID、手机号、地区、审批单号、申请人、提交时间和备注。审批信息列会显示处理时间、处理人、备注和状态。
- 用相同手机号和申请人再次搜索，结合详情中的关联客资 ID 排查重复待审单。同一客资有多张待审单时不要分别处理，先由负责人指定唯一有效审批单。
- 点击「查看」进入详情。列表会把当前页记录 ID 带入详情，因此「上一条/下一条」只在进入详情时的当前页范围内导航。
- 在详情核对审批单号、申请人、提交时间、状态、手机号、省市区、详细地址、关联客资 ID 和提交备注。
- 查看「跟进记录」和「分配&费用日志」判断客资是否已有处理。两页签返回全部跟进与分配记录，可查看完整历史。
- 打开「审批记录」，核对提交时冻结的策略版本、节点顺序、指定人员/角色、或签/会签、命中条件、通过进度、逐人动作和每个节点的企微待办投递状态。
- 操作前刷新一次详情，确认记录仍为待审核、自己是当前节点审批人且没有其他审核人正在处理。多人并发操作同一审批单时，服务端只允许一次状态流转，后提交方会收到 409 冲突提示，应刷新后查看最新状态。
- 选择「通过」或「拒绝」，填写不超过 50 个字符的审核备注。驳回备注为必填项，必须填写清晰原因和可复核依据。
- 若是最后一级且选择通过，可勾选「审批通过后立即分配客资」，再同时选择当前企业门店和在职员工。分配失败时整个事务回滚，审批不会进入通过状态。
- 分配员工下拉支持按关键词远程搜索在职员工；找不到员工时不要改选相似人员，应先核对关键词或到客资分配页处理。
- 点击「确认」一次并等待响应。若请求超时或页面无反馈，先刷新状态和审批记录，不要立即再次提交；审批采用带旧状态条件的原子更新，已被处理的审批单会返回 409 冲突。
- 或签节点任一冻结审批人通过即可进入下一节点；会签节点需要所有冻结审批人逐一通过。任一节点拒绝会将后续等待节点取消并结束审批。
- 返回列表或刷新详情，核对最新状态、审批人、时间、备注、节点进度和企微结果通知。`企微已接受` 仅表示企微接口接收，不等于收件人已阅读。
- 若详情显示关联工作流，再到工作流记录核对节点确已推进或终止。关联工作流推进或终止失败会回滚审批状态保持强一致，操作整体会失败并提示。
- 需要配置策略时点击「审批策略」。启用逐级审批后按顺序增加节点，选择指定人员/角色、或签/会签，并按需设置全部或任一条件。
- 策略中的指定人员候选支持按关键词远程搜索当前企业在职员工。
- 保存策略后记录新版本号。新提交申请使用新版本；已在途申请继续使用提交时冻结的旧节点和审批人。
七、字段与规则说明
- 状态机只允许 `PENDING` 进入 `APPROVED`、`REJECTED` 或 `REVOKED`，终态不能从本页恢复。
- 同一客资可能同时存在多张待审核审批单，审批前必须按关联客资 ID 和手机号查重。
- 通过、驳回和撤销采用带旧状态条件的原子更新并配合行锁；多人并发操作同一审批单时失败方收到 409 冲突。
- 动态策略关闭或没有节点时按单级审批处理；启用后必须配置 1–10 个节点，且申请至少命中一个节点。
- 指定人员和指定角色只能引用当前企业启用对象；角色会在提交时展开为当时的在职员工列表。
- 或签由任一冻结审批人通过；会签必须所有冻结审批人通过。同一用户不能重复处理同一节点。
- 审批节点条件支持提交组织、审批类型、来源类型、省、市、区，以及等于、不等于、属于、不属于、为空和非空。
- 最后一级之前不能请求审批后分配；门店和员工必须同时提交，且分配成功后才写入最终通过状态。
- 关联工作流推进或终止失败会回滚审批状态；存在关联实例时仍应分别核对审批单和工作流。
- 审核备注最多 50 个字符，驳回备注为必填项。
- 当前没有批量通过或批量驳回，只能逐条审核。
- 后端支持申请人撤销待审核申请，但当前审批列表和详情没有撤销入口。
八、风险与限制
误通过会使无效客资进入后续分配，误拒绝会终止全部等待节点；在最后一级勾选分配还会同时改变客资归属。重复待审单或多人并发处理可能造成相互矛盾的审核与分配结果，工作流联动失败会整体回滚审批状态。候选员工分页限制可能导致选错相似人员，空驳回备注会削弱审计证据。
注意
提交审批前必须查重并核对审批单号、关联客资 ID、手机号、当前节点和冻结审批人。同一审批单同一时段只允许一人操作；请求超时先刷新，不要直接重试。拒绝必须填写具体原因，末级分配必须二次核对门店和员工；有关联工作流时还要核对工作流终态。
九、常见问题
- 为什么有管理权限仍看不到或不能处理某个节点？动态审批还要求当前员工属于提交时冻结的节点审批人；角色或人员在策略修改后不会改变在途节点。
- 为什么同一客资出现多张待审核单？当前数据约束没有限制同一企业、客资只能有一张 PENDING 单；先确定唯一有效单，不要分别处理。
- 点击确认后超时，可以直接重试吗？不要。先刷新审批状态和节点动作；多人或重复请求都可能基于同一个旧的 PENDING 状态发起处理。
- 为什么审批通过后状态仍是待审核？当前节点可能是会签且尚未集齐全部人员，或还有后续审批节点。
- 为什么审批已结束但关联工作流没有变化？工作流推进或终止是弱依赖，失败不会回滚审批状态，需要单独核对并按运维流程处置。
- 为什么没有出现“审批通过后立即分配”？该选项只在选择通过且当前是最后一级时显示。
- 为什么员工下拉找不到在职员工？弹窗只加载该组织前 100 人；请到客资分配页使用完整检索，不要选择相似姓名替代。
- 为什么驳回时系统没有要求原因？当前审核备注不是必填，这是已知边界；企业操作规范应强制填写。
- 为什么详情里的跟进或分配记录不完整？聚合接口各限制为最新 20 条，需要到对应业务页面查询完整记录。
- 为什么找不到撤销按钮？服务端有仅申请人可用的撤销端点，但当前列表和详情没有接入。
- 为什么策略保存后旧审批没有变化？审批提交时会冻结策略版本、匹配节点和审批人，策略更新只影响后续新申请。
十、相关指南
审核前结合《处理客资清洗》核对真实性，通过且未自动分配时使用《分配客资》，审批后通过《管理客资列表》复核最终归属；统一待办入口的真实边界阅读《处理待办审批任务》。
说明
页面入口：/flow/approval、/flow/approval/detail