审批配置与审批中心 PRD
| 项 | 内容 |
|---|---|
| 所属产品 | ASA |
| 版本 | v2.1.0 |
| 页面 | 12-审批配置与审批中心 |
| 涉及功能 | 审批 |
| 编制日期 | 2026-10-16(2026-10-21 按会议清单 v2 回写;2026-10-22 按闭环清单 A03、B10、B11、B12、B20 回写) |
| 文档状态 | 待评审 |
| 目标读者 | 研发、测试、AI 实现助手(本文件可直接整份投喂给 AI 作为实现依据) |
| 关联文档 | 本目录 spec.yaml、mocks/;版本 index.md;原型 html/审批配置.html、html/审批中心.html、html/审批详情-客户管理.html(通用格式与通知文案出处)、html/客户管理.html(撤回文案出处) |
0 前置说明
- 本页覆盖版本记录第 25 项(审批配置)、第 26 项(审批中心),并按版本级约定收拢审批详情页的通用格式(第 6、12、15、17、19、21 项的公共部分)。
- 本页主管:审批类型清单、审批流配置、审批单实体与状态机、审批人解析与会签、撤回与作废、最终通过时业务执行失败的回滚(D-00-79)、变更高亮基准(D-00-75)、审批通知、审批详情页通用格式、审批中心、在途单提示句式。
- 各业务包(03-规则配置、04-客户管理、05-费用管理、06-账单与结算单、07-返点管理、08-渠道对账)只写四件事:本业务审批详情「审批内容」区展示什么、提交前的业务校验、最终通过时哪些情形算「业务执行失败」(D-00-79①)、审批结束后业务单据怎么变。它们不再各写一套状态、会签、撤回、作废、通知、提交提示。
- 01-客户登记「已提交审批」tab 的撤回(R-01-036)按本页 2.4 执行。
- 版本级口径(只引用不复述):会签 D-00-43;「绑定的销售」D-00-50;「绑定的运营」= 本单涉及账户的优化师 D-00-76;客户数据范围 D-00-77;页面查看权限点与审批人候选 D-00-78;审批通用口径(执行失败回滚、撤回、作废)D-00-79;变更高亮基准 D-00-75;已禁用用户的显示与保留 D-00-83;收付款中心只读 8 类 D-00-71。
- 依赖既有能力:角色列表(角色管理)、用户列表与启用状态(用户管理)、用户所持权限点(角色管理)、用户的企业微信绑定与邮箱(个人中心)、客户的「销售」(04)、账户的「优化师」与所属客户(02)。这些由技术沿用现有实现。
1 整体概述
1.1 背景与目标
v2.1.0 新增了 14 种需要审批的业务动作(客户、充值、结算、返点、渠道付款等)。目标:管理员能按「申请人是什么角色」给每种动作配置审批流;业务提交后系统自动找到审批人、逐节点推进、会签、通知;审批人在一个地方(审批中心)处理所有待办;所有审批详情长得一样,只有内容区按业务不同。
可证伪的判定:配好一条「财务提交充值 → 客户的销售审 → 王敏审」的流程后,财务提交一笔充值,销售和王敏依次在审批中心看到待办并收到通知,两人都通过后充值单进入已通过。
1.2 本页范围
- ✅ 包含:
- 预置 14 种审批类型。
- 审批配置列表页、「配置审批流」弹窗。
- 审批单的匹配、解析、跳过、会签、推进、通过、驳回、撤回、作废;最终通过时业务执行失败的回滚。
- 审批通知(企业微信 → 邮箱)。
- 审批详情页通用格式(唯一地址)。
- 审批中心(待审批 / 全部审批)与待办角标。
- 业务页提交后的通用弱提示、在途单提示通用句式。
- ❌ 不包含:
- 各业务审批详情「审批内容」区的字段,哪些情形算业务执行失败,以及审批结束后业务单据怎么变(归各业务包)。
- 各业务页「已提交审批」tab 的列表字段和筛选(归各业务包;撤回按本页 2.4)。
- 短信通知:本期不做(D-12-11)。
- 或签、转交、加签、催办:原型没提,本期不做。节点配置仍单选(D-12-33)。
- 原型里审批配置、审批中心动态面板的「审批」「草稿」两个状态:复制残留,不做(D-12-12)。
- 原型列表行前的复选框:没有任何批量操作,不做。
- 把权限点分配给角色:只出权限点,交 13-导航与权限 汇总(D-00-45)。
1.3 角色与权限
| 角色 | 能做什么 | 不能做什么 | 权限来源 |
|---|---|---|---|
| 持「审批中心(查看)」的用户 | 看到并进入审批中心,只看与自己相关的单(R-12-036、R-12-042);可被选为审批配置里的指定用户节点(R-12-010) | 查看与自己无关的审批详情(R-12-043) | 「审批中心(查看)」权限点(D-00-78,13 汇总) |
| 审批配置管理员 | 查看审批配置列表;配置审批流;对任何审批中的单「作废」,为此可只读打开任何审批详情(R-12-046、R-12-043③) | 通过、驳回不属于自己的节点 | 「审批配置」权限点(R-12-041;13 汇总,不预设角色) |
| 业务数据查看者 | 只读查看自己有权看的业务单据对应的审批详情(R-12-043②) | 通过、驳回、撤回、作废 | 沿用各业务现有数据权限,不新增权限点;另含「收付款中心」权限点持有人查看 8 类(D-00-71) |
| 申请人 | 在业务页提交审批单;查看自己提交的单;撤回自己的审批中单(只看本人 + 审批中,不看业务权限点,D-00-79②) | 审批不属于自己当前节点的单;撤回别人的单 | 提交看各业务动作的权限点;撤回不看 |
| 审批人 | 查看与自己相关的单;对轮到自己、还没处理的单通过或驳回(不论是否还持「审批中心(查看)」,可从通知链接进入,D-00-78) | 撤回别人的单;处理还没轮到或已经处理过的节点 | 审批单快照里的审批人名单 |
同一个人可以同时是申请人和审批人(D-12-03)。
1.4 术语定义
| 术语 | 释义 |
|---|---|
| 审批事项 | 审批所属的大模块,如「客户管理」「费用管理」。 |
| 审批类型 | 具体动作,如「新建客户」「账户充值」。审批事项 + 审批类型确定一种审批。 |
| 审批规则 | 某审批类型下的一套「哪些角色提交 → 走哪条审批流」。一个类型可以有多套。 |
| 默认规则 | 每个类型的规则 1。凡是没被其他规则选走的角色都归它,不能删除。 |
| 节点 | 审批流里发起者之后的一级审批。配置时每个节点只选一项:一个用户,或一个动态选项。 |
| 动态选项 | 「绑定的销售」(解析操作对象客户的销售,D-00-50)、「绑定的运营」(解析本单涉及账户的优化师,D-00-76)。 |
| 操作对象客户 | 业务包提交审批单时告诉本页「这张单是关于哪个客户的」。 |
| 涉及账户 | 业务包提交审批单时告诉本页「这张单涉及哪些账户」;客户级单据(新建客户、客户信息变更、付款主体变更、提成规则配置)传客户名下全部账户(D-00-76)。 |
| 会签 | 一个节点解析出 2 人及以上时,这些人全部通过才算这个节点通过;任一人驳回整单驳回(D-00-43)。 |
| 跳过 | 节点解析不出任何可用审批人时,这个节点不需要审,直接往后走。 |
| 作废 | 持「审批配置」权限点的人结束一张审批中的单,效果同撤回(D-00-79③、R-12-046)。 |
| 快照 | 提交那一刻定下的命中规则、节点、每个节点的审批人名单,以及变更高亮的比对基准(R-12-030)。之后改配置、改客户销售、改账户优化师、禁用用户、收回权限点,都不影响这张单。 |
1.5 核心流程
| 步骤 | 操作者 | 系统行为 | 产物 / 状态 |
|---|---|---|---|
| 1 | 管理员 | 在审批配置里给某审批类型配置一套或多套规则,保存 | 审批流配置 |
| 2 | 申请人 | 在业务页提交(业务包负责业务校验) | — |
| 3 | 系统 | 按申请人角色命中规则 → 解析每个节点的审批人 → 生成快照(含高亮基准) | 审批单【审批中】;0 节点或全部跳过时直接【已通过】;「至少一个指定用户节点」为「要求」的 10 类全部跳过时提交被拒(R-12-018) |
| 4 | 系统 | 通知第一个需审节点的所有人;业务页按 R-12-018 给提交提示 | 通知 |
| 5 | 审批人 | 在审批中心或审批详情通过 / 驳回 | 节点记录 |
| 6 | 系统 | 节点全员通过 → 进入下一节点并通知;最后一个节点全员通过 → 让业务包执行,成功则【已通过】、失败则回滚(R-12-045);任一人驳回 → 【已驳回】 | 状态变化;通知申请人 |
| 支线 | 申请人 / 审批配置管理员 | 审批中时撤回(2.4)/ 作废(R-12-046) | 【已撤回】;通知相关人 |
| 7 | 系统 | 审批单结束后通知业务包处理业务单据(各业务包定义) | 业务单据变化 |
2 详细需求
2.1 审批配置
2.1.1 功能描述
左侧菜单「审批配置」进入列表,每行一种审批类型;点「配置审批流」打开弹窗编辑这一类型的全部审批规则。
2.1.2 核心字段
审批配置列表:
| 字段名 | key | 类型 | 必填 | 枚举/取值 | 默认值 | 规则说明 |
|---|---|---|---|---|---|---|
| 审批事项 | category | enum | 是 | 客户登记表 / 客户管理 / 费用管理 / 账单管理 / 返点管理 / 渠道对账中心 | — | 预置,R-12-001 |
| 审批类型 | type | enum | 是 | 见下方预置清单 | — | 预置,R-12-001 |
| 编辑时间 | edited_at | datetime(Asia/Shanghai,秒) | 否 | yyyy-mm-dd hh:mm:ss | — | 最近一次保存的时间,从未保存显示「—」,R-12-003 |
预置审批类型清单(固定顺序,也是列表排序)。「至少一个指定用户节点」列为 R-12-012 ③ 的适用范围;「动态选项」列为 R-12-010 的适用范围:
| 序 | 审批事项 | 审批类型 | 审批内容由谁定义 | 至少一个指定用户节点 | 动态选项 |
|---|---|---|---|---|---|
| 1 | 客户登记表 | 规则配置 | 03-规则配置 | — | 提供 |
| 2 | 客户管理 | 新建客户 | 04-客户管理 | 要求 | 提供 |
| 3 | 客户管理 | 客户信息变更 | 04-客户管理 | 要求 | 提供 |
| 4 | 客户管理 | 付款主体变更 | 04-客户管理 | — | 提供 |
| 5 | 费用管理 | 账户充值 | 05-费用管理 | 要求 | 提供 |
| 6 | 费用管理 | 充值退款 | 05-费用管理 | 要求 | 提供 |
| 7 | 费用管理 | 额度调整 | 05-费用管理 | 要求 | 提供 |
| 8 | 费用管理 | 余额分配 | 05-费用管理 | 要求 | 提供 |
| 9 | 费用管理 | 提成规则配置 | 05-费用管理 | — | 提供 |
| 10 | 账单管理 | 生成结算单 | 06-账单与结算单 | 要求 | 提供 |
| 11 | 返点管理 | 客户返点 | 07-返点管理 | 要求 | 提供 |
| 12 | 返点管理 | 客情费用 | 07-返点管理 | 要求 | 提供 |
| 13 | 渠道对账中心 | 渠道付款 | 08-渠道对账 | 要求 | 不提供 |
| 14 | 渠道对账中心 | 渠道对账 | 08-渠道对账(上传批次的审批,和渠道付款是两种,D-12-14) | — | 不提供 |
原型列表里画的「客户管理—规则配置变更」按第 1 行「客户登记表—规则配置」处理(D-12-16)。
配置弹窗(每套审批规则):
| 字段名 | key | 类型 | 必填 | 枚举/取值 | 默认值 | 规则说明 |
|---|---|---|---|---|---|---|
| 审批事项 | category | — | — | 只读 | — | R-12-004 |
| 审批类型 | type | — | — | 只读 | — | R-12-004 |
| 申请者角色 | applicant_roles | 列表(角色) | 规则 2 起必填 | 角色列表 | 规则 1 自动计算 | 规则 1 只读 R-12-005;规则 2 起 R-12-007 |
| 审批节点 | node_count | int | 是 | 整数 ≥ 0 | 0 | R-12-009、R-12-011 |
| 审批流 | nodes | 列表 | 节点数 ≥ 1 时每个节点必选 | 持「审批中心(查看)」的启用用户 / 绑定的销售 / 绑定的运营 | 空 | 每节点只选一项,R-12-010 |
2.1.3 业务规则
- R-12-001 审批类型是系统预置的 14 种(见上表),不提供新增和删除。
- R-12-002 审批配置列表按预置清单顺序固定排序;搜索框按审批事项或审批类型模糊匹配;分页 10/50/100/300 条每页,默认 10。
- R-12-003 列表字段为 审批事项、审批类型、编辑时间、操作。编辑时间是最近一次保存审批流的时间(yyyy-mm-dd hh:mm:ss),从未保存过显示「—」;操作只有「配置审批流」。
- R-12-004 点「配置审批流」打开审批配置弹窗。顶部只读展示审批事项、审批类型;下面展示这个类型已保存的全部审批规则。从未配置过时只有规则 1,节点数 0。
- R-12-005 规则 1 是默认规则:它的申请者角色由系统自动算成「没被本类型其他规则选走的全部角色」,只读展示,可以为空。角色管理里新建的角色,自动落进每个审批类型的规则 1(D-12-01、D-12-17)。存量配置迁移后的规则 1 按 R-12-050 处理。
- R-12-006 每套规则标题右侧有「+」「−」。「+」在最后追加一套新规则;「−」删除这套规则。规则 1 没有「−」,不能删。删除后规则序号从 1 连续重排(D-12-06)。
- R-12-007 规则 2 起的「申请者角色」是必填的复选下拉,选项来自角色列表;已被本类型其他非默认规则选走的角色不出现在选项里(角色互斥)。勾选的角色从规则 1 移出;取消勾选或删掉这套规则时,角色自动回到规则 1(D-12-06)。存量规则之间角色重叠的,按 R-12-050③ 归属。
- R-12-008 角色管理里删除某个角色后,它自动从所有规则里移除。如果规则 2 起的某套规则因此没有角色了,这套规则保留但匹配不到任何人,下次保存时按 R-12-012 拦住。
- R-12-009 「审批节点」是整数步进器,最小 0,不设最大值(D-12-23),不能输入小数和负数。0 表示这套规则免审批,审批流只显示「发起者」(D-12-07)。
- R-12-010 审批流显示为「发起者 — 节点1 — 节点2 …」,节点框个数等于审批节点数。每个节点只能选一项:一个用户,或「绑定的销售」「绑定的运营」二选一。用户候选只列启用中、且持「审批中心(查看)」权限点的用户,可按用户名搜索(D-00-78、D-12-38);下拉里两个动态选项置顶(D-12-13)。渠道对账中心的「渠道付款」「渠道对账」两类没有操作对象客户,下拉不提供动态选项,只能选用户(D-12-32)。
- R-12-011 审批节点数调小时,从最后一个节点往前删掉多出的节点框和已选值;调大时在末尾追加空节点框。
- R-12-012 点「保存」时逐条校验,任一条不过就不保存,并在对应位置标红:①规则 2 起申请者角色为空,提示「请选择申请者角色」;②节点数 ≥ 1 时有节点没选,提示「请选择审批人」;③上表「至少一个指定用户节点」为「要求」的 10 类,某套规则节点数 ≥ 1、却没有一个节点选的是启用中的用户(全是动态选项,或指定的用户都已禁用),在这套规则的审批流下方提示「涉及资金或计费模式的审批类型,至少要有一个指定用户节点」;节点数为 0(免审)不受此条限制(D-12-07、D-12-32、D-12-41);本条只在保存时校验,保存后指定用户被禁用、提交时全部节点解析为空的,按 R-12-018 的例外拒绝提交(D-12-43);④「渠道付款」「渠道对账」的节点里存有动态选项(存量配置),该节点标红「该审批类型不支持动态选项,请选择用户」(D-12-42)。
- R-12-013 保存成功弱提示「保存成功」,关闭弹窗,这一行的编辑时间刷新。新配置只对保存之后提交的审批单生效(D-12-04)。关闭弹窗不保存就丢弃本次修改,不弹确认;两个人同时编辑同一类型时,后保存的覆盖先保存的(D-12-20)。
- R-12-041 审批配置页(列表和配置审批流弹窗)只对有「审批配置」权限点的用户开放。没有这个权限点时,左侧菜单不显示「审批配置」,直接访问页面地址显示「无权限访问」(页面形态按 13 R-13-005);保存接口在服务端同样校验(D-12-24)。
- R-12-050 存量审批配置上线迁移(index S-15,D-12-45):①存量「账户销售」节点就是「绑定的销售」,保留;存量「账户优化师」节点即「绑定的运营」,保留(D-00-76)。②迁移生成的规则 1 是 0 节点的;凡「规则 1 为 0 节点、规则 2 起又没覆盖全部角色」的审批类型,列入上线检查清单,由用户逐个确认。③存量规则之间角色重叠的,重叠角色归原排序最前的那条(迁移后按 R-12-007 互斥)。④存量「发起人」节点上线前核对,有残留就阻断上线,由管理员重配。
2.1.4 异常与边界
| 场景 | 现象 | 系统行为 | 用户看到 |
|---|---|---|---|
| 搜索无结果 | 关键词匹配不到 | 列表为空 | 空态「暂无数据」 |
| 规则 2 起没选角色 | 点保存 | 不保存 | 该规则角色框标红「请选择申请者角色」 |
| 节点没选审批人 | 点保存 | 不保存 | 对应节点框标红「请选择审批人」 |
| 涉钱类型只配了动态选项 | 点保存 | 不保存(R-12-012③) | 审批流下方标红「涉及资金或计费模式的审批类型,至少要有一个指定用户节点」 |
| 所有角色都被规则 2 起选走 | 规则 1 角色为空 | 允许保存 | 规则 1 角色框显示「(暂无,新建角色会自动归入)」 |
| 已选的指定用户后来被禁用 | 打开弹窗 | 保留已选值(D-00-83);不单独拦保存,但不算 R-12-012③ 的指定用户节点 | 节点框显示「姓名(已禁用)」;提交时这个节点会被跳过(R-12-016);10 类全部节点都解析为空时提交被拒(R-12-018) |
| 已选的指定用户后来被收回「审批中心(查看)」 | 打开弹窗 | 保留已选值,不拦保存;提交时照常解析为审批人(D-12-39) | 节点框正常显示姓名;该用户靠通知链接处理(R-12-042) |
| 同时编辑 | 两个管理员先后保存 | 后保存的覆盖 | 无提示 |
| 涉及钱的类型上线时还没配置 | 节点数 0 | 提交即通过 | 无提示;靠上线检查兜底(见第 3 节、index S-15) |
| 保存失败(网络 / 服务异常) | 接口报错 | 不关闭弹窗,保留已填内容 | 提示「保存失败,请重试」 |
2.1.5 验收标准
本页各验收用例的通用前置:涉及的用户都是启用用户、都持「审批中心(查看)」,用例另有说明的除外。
- G-12-001 前置:系统初始化完成。操作:打开审批配置页。期望:列表按预置顺序列出 14 行;从未配置的行编辑时间显示「—」;搜索「费用」剩 6 行(费用管理的 5 行 + 返点管理—客情费用);搜索「结算单」只剩 账单管理—生成结算单。
- G-12-002 前置:角色列表有 销售、运营、财务、管理员 4 个角色;账户充值从未配置。操作:点账户充值的「配置审批流」。期望:弹窗只读显示 费用管理 / 账户充值;只有规则 1,规则 1 角色只读显示 4 个角色;节点数 0;规则 1 没有「−」。
- G-12-003 前置:同 G-12-002。操作:点「+」新增规则 2,勾选 财务;再新增规则 3。期望:规则 1 角色变为 销售、运营、管理员;规则 3 的角色下拉里没有 财务。
- G-12-004 前置:规则 2 已勾选 财务。操作:点规则 2 的「−」。期望:规则 2 消失,原规则 3 重排为规则 2;财务回到规则 1。
- G-12-005 前置:规则 1 节点数设为 2,节点 1 选了用户 王敏、节点 2 选了「绑定的销售」。操作:把节点数调成 1。期望:审批流只剩 发起者 — 王敏;节点 2 的选择被丢弃。
- G-12-006 前置:规则 2 节点数为 2,节点 2 未选;规则 3 申请者角色为空。操作:点保存。期望:不保存;节点 2 标红「请选择审批人」;规则 3 角色标红「请选择申请者角色」。
- G-12-007 前置:配置合法。操作:点保存。期望:提示「保存成功」并关闭弹窗;该行编辑时间变为当前时间;重新打开看到刚保存的内容。
- G-12-008 前置:打开弹窗做了修改。操作:点右上角关闭。期望:不弹确认直接关闭;重新打开仍是修改前的内容。
- G-12-009 前置:在角色管理新增角色「渠道专员」。操作:打开任一审批类型的配置弹窗。期望:规则 1 角色里出现 渠道专员。
- G-12-010 前置:用户 李磊 已禁用;用户 周婷 启用但没有「审批中心(查看)」;用户 王敏 启用且持该点。操作:在账户充值某节点下拉里分别搜索 李磊、周婷、王敏。期望:李磊、周婷搜不到,王敏能搜到;下拉第一、二项为「绑定的销售」「绑定的运营」。
- G-12-030 前置:用户 孙磊 持「审批中心(查看)」、没有「审批配置」权限点。操作:登录后看左侧菜单,再直接访问审批配置页地址。期望:菜单里没有「审批配置」,有「审批中心」;直接访问显示「无权限访问」。
- G-12-033 前置:账户充值规则 1 节点数 2,两个节点都是动态选项(绑定的销售、绑定的运营);用户 李磊 已禁用。操作:①点保存;②把节点 2 改为李磊后保存(李磊此前已选、后被禁用,用存量数据构造);③把节点 2 改为王敏后保存;④在「规则配置」类型配同样两个动态节点并保存;⑤打开「渠道付款」的节点下拉。期望:①②都不保存,审批流下方标红「涉及资金或计费模式的审批类型,至少要有一个指定用户节点」;③保存成功;④保存成功;⑤下拉里没有「绑定的销售」「绑定的运营」。
2.1.6 示意
2.2 审批单与审批引擎
2.2.1 功能描述
业务包提交审批时调用本页能力:传入审批类型、申请人、操作对象客户、涉及账户、业务单据、发起备注,以及变更类审批的比对基准(R-12-030)。本页负责匹配规则、解析审批人、生成快照、推进节点;最后一个节点全员通过时让业务包执行,成功才算通过(R-12-045);审批结束后通知业务包。本节没有独立页面。
2.2.2 核心字段
| 字段名 | key | 类型 | 必填 | 枚举/取值 | 默认值 | 规则说明 |
|---|---|---|---|---|---|---|
| 审批单号 | approval_no | string | 是 | 系统生成,全局唯一 | — | 生成规则由技术定;文档里的单号示例(AP… / SP-… / FD…)仅示意 |
| 审批事项 | category | enum | 是 | 同 2.1 | — | 取自审批类型 |
| 审批类型 | type | enum | 是 | 同 2.1 | — | 取自审批类型 |
| 申请人 | applicant_id | 关联用户 | 是 | — | 当前用户 | — |
| 申请时间 | submitted_at | datetime(Asia/Shanghai,秒) | 是 | — | 提交时刻 | — |
| 审批状态 | status | enum | 是 | 审批中 / 已通过 / 已驳回 / 已撤回 | 审批中 | 见 2.2.4;作废后也是「已撤回」(R-12-046) |
| 操作对象客户 | target_customer | 关联客户 | 否 | — | — | 业务包给出;「绑定的销售」用,R-12-016 |
| 涉及账户 | target_accounts | 列表(账户) | 否 | — | — | 业务包给出,可多个;「绑定的运营」用,R-12-016 |
| 业务单据 | biz_ref | 关联对象 | 是 | — | — | 业务包的单据;审批内容区按它渲染 |
| 发起备注 | submit_remark | text | 否 | — | — | 业务提交时填写的备注;R-12-027 |
| 流程快照 | flow_snapshot | 列表 | 是 | — | — | R-12-015 |
| 比对基准快照 | diff_baseline | 对象 | 否 | — | — | 变更类审批提交时该对象的生效值,R-12-030 |
| 最近一次通过未执行 | last_failed_pass | 对象(原因、审批人、时间) | 否 | — | — | R-12-045;每次失败覆盖上一次 |
审批记录(时间线的每一条):
| 字段名 | key | 类型 | 必填 | 枚举/取值 | 默认值 | 规则说明 |
|---|---|---|---|---|---|---|
| 节点序号 | node_seq | int | 是 | 0 = 发起 | — | — |
| 操作人 | user_id | 关联用户 | 否 | — | — | 跳过的节点、自动通过为空 |
| 动作 | action | enum | 是 | 发起 / 通过 / 驳回 / 撤回 / 作废 / 已跳过 / 自动通过 | — | 自动通过见 R-12-018;作废见 R-12-046 |
| 备注 | remark | text | 否 | — | — | 通过 / 驳回选填(R-12-020);作废时为必填的作废原因 |
| 操作时间 | acted_at | datetime(Asia/Shanghai,展示到分) | 是 | — | — | — |
2.2.3 业务规则
- R-12-014 提交时按申请人当时的角色,在该审批类型的规则里找到它所属的那一套(角色互斥,只会命中一套)。申请人没有角色,或角色不在规则 2 起任何一套里,就按规则 1。不存在提交被「未配置审批流」拦住的情况(D-12-01、D-12-02)。
- R-12-015 提交那一刻,把命中规则的每个节点解析成审批人名单,连同比对基准(R-12-030)固化到审批单快照。之后修改审批配置、修改客户的销售、修改账户的优化师、禁用用户、收回用户的权限点,都不改变在途审批单的流程和名单(D-12-04、D-12-18)。
- R-12-016 节点解析(D-12-31):
- 指定用户 → 该用户;账号已禁用则解析为空。是否持「审批中心(查看)」不影响解析(D-12-39)。
- 绑定的销售 → 操作对象客户当前的「销售」(D-00-50);新建客户取提交表单里的销售(R-04-034,D-12-46);销售已禁用或客户没有销售,解析为空。
- 绑定的运营 → 本单涉及账户当前的「优化师」,去重后只取启用用户(D-00-76);客户级单据(新建客户、客户信息变更、付款主体变更、提成规则配置)的涉及账户是客户名下全部账户;没有账户(如新建客户)或优化师都已禁用时解析为空。
- 业务包没给操作对象客户 / 涉及账户时,对应动态选项解析为空(D-12-13)。已禁用用户一律按解析为空处理(D-00-83)。
- 「至少一个指定用户节点」为「要求」的 10 类,命中规则节点数 ≥ 1 而全部节点都解析为空时,按 R-12-018 的例外拒绝提交(D-12-43)。
- R-12-017 节点解析结果为空 → 跳过这个节点,时间线标「已跳过」;解析出 1 人 → 普通节点;解析出 2 人及以上 → 会签节点,名单里的人全员通过才算这个节点通过(D-00-43、D-12-03、D-12-08、D-12-13)。
- R-12-018 命中规则节点数为 0,或全部节点都被跳过,审批单提交即为「已通过」,并按 R-12-038 通知申请人(D-12-07、D-12-08、D-12-21)。免审单和普通单一样有单号,同等出现在审批中心「全部审批」(申请人本人)和各业务页「已提交审批」里,状态「已通过」;时间线在发起记录(及各「已跳过」节点)后追加一条「无需审批,自动通过」(D-12-36)。业务页提交后,按返回的审批单状态给弱提示:审批中 →「已提交审批」;已通过 →「提交成功,无需审批,已生效」。各业务页引用本条,不各写。免审单在提交时即让业务包执行;执行失败则提交不成功、不生成审批单,业务页显示业务包给出的原因(D-12-40)。例外(D-12-43):2.1.2 预置清单里「至少一个指定用户节点」为「要求」的 10 类,命中规则节点数 ≥ 1、但审批人全部解析为空(全部节点被跳过)时,不按免审通过:提交直接被拒、不生成审批单,业务页提示「审批流中的审批人均不可用,请联系审批配置管理员」;节点数为 0 的免审照旧。
- R-12-019 审批单从第一个没被跳过的节点开始。当前节点全员通过后,进入下一个没被跳过的节点,并通知那个节点的人;没有后续节点时,按 R-12-045 结束。
- R-12-020 通过、驳回都要二次确认。确认框文案「是否要{通过/驳回}该审批?」,带选填的「备注」多行输入框(最多 1,024 字,超出不能继续输入;驳回不预填备注),按钮「取消」「确定」。确定后弱提示「操作成功」并刷新当前页(D-12-05)。最终通过遇业务执行失败时,确认框按 R-12-045 处理。
- R-12-021 当前节点任一审批人驳回,审批单立即变为「已驳回」,不再往后推进;会签节点里其他还没处理的人不能再操作。
- R-12-022 审批人恰好是申请人本人时,照常要本人点通过,不自动通过;同一个人出现在多个节点时,每个节点都要分别处理(D-12-03)。
- R-12-023 只有「审批单为审批中」且「当前用户在当前节点名单里、还没处理」时,才对他显示「通过」「驳回」按钮;其他情况一律隐藏。服务端也按这条再校验。是否持「审批中心(查看)」不影响这条(D-00-78)。
- R-12-024 提交后审批人账号才被禁用的,系统不自动跳过、不转交,单子停在这个节点,由申请人撤回后重新提交,或由持「审批配置」权限点的人作废(R-12-046,D-12-08)。
- R-12-025 审批单结束(已通过 / 已驳回 / 已撤回)后,系统通知对应业务包按结果处理业务单据;业务单据怎么变,由各业务包定义,本页不定义。作废按「已撤回」通知业务包。
- R-12-045 最终通过时的业务执行(D-00-79①、D-12-28):最后一个节点的最后一位审批人点通过并确定时,系统先让业务包执行。执行成功 → 记这次通过、审批单变「已通过」、通知申请人。执行失败 → 整体回滚:审批单保持「审批中」,这次通过不写入审批记录,确认框不关闭并在备注框上方红字显示业务包给出的原因;审批人可以取消后驳回,或等申请人撤回 / 管理员作废;审批信息区显示「最近一次通过未执行:{原因}({审批人} {yyyy-mm-dd hh:mm})」(只在审批中显示,再次失败时覆盖)。哪些情形算执行失败由各业务包在 PRD 里列明(07 后付抵扣通过时不复核、08 错误行跳过都不算失败);未列明的不得拒绝。非最后一位的通过不触发业务执行。审批中心行内通过与审批详情通过同一处理。
2.2.4 状态与流转
本页定义「审批单」状态机:审批中 / 已通过 / 已驳回 / 已撤回。已通过、已驳回、已撤回都是终止状态。
| 当前状态 | 触发动作 | 操作者 | 目标状态 | 前置条件 |
|---|---|---|---|---|
| (新提交) | 提交,且有需审的节点 | 申请人 | 审批中 | R-12-014、R-12-017 |
| (新提交) | 提交,命中 0 节点或全部跳过(10 类全部跳过除外),业务执行成功 | 系统 | 已通过 | R-12-009、R-12-018 |
| (新提交) | 提交,10 类命中节点数 ≥ 1 且全部跳过 | 系统 | 不生成审批单(提交被拒) | R-12-018 例外 |
| 审批中 | 当前节点全员通过,后面还有节点 | 审批人 | 审批中(进入下一节点) | R-12-019 |
| 审批中 | 最后一个节点全员通过,业务执行成功 | 审批人 | 已通过 | R-12-045 |
| 审批中 | 最后一个节点最后一位通过,业务执行失败 | 审批人 | 审批中(不变,这次通过不记录) | R-12-045 |
| 审批中 | 任一审批人驳回 | 审批人 | 已驳回 | R-12-021 |
| 审批中 | 撤回 | 申请人本人 | 已撤回 | 2.4 |
| 审批中 | 作废 | 持「审批配置」的人 | 已撤回 | R-12-046 |
逆向操作:驳回由当前节点审批人发起,不再往后推进;撤回只能由申请人在审批中发起,作废由持「审批配置」的人在审批中发起,原单作废,不能原单修改或重提(2.4)。驳回、撤回、作废后业务单据怎么处理,由业务包定义(作废同撤回)。已通过的单不能撤回、作废;通过后业务单据有误(错单、银行退回等)按 D-00-69 的已知限制线下处理。
2.2.5 异常与边界
| 场景 | 现象 | 系统行为 | 用户看到 |
|---|---|---|---|
| 客户没有销售 / 销售已禁用 | 「绑定的销售」解析为空 | 跳过这个节点 | 时间线「已跳过(未找到审批人)」 |
| 本单没有账户 / 账户优化师都已禁用 | 「绑定的运营」解析为空 | 跳过这个节点 | 同上 |
| 涉及多个账户、优化师不同 | 「绑定的运营」解析出多人 | 合并去重,变成会签 | 节点上多个状态圆点 |
| 全部节点被跳过 | — | 直接已通过 | 申请人收到审批通过通知;提示「提交成功,无需审批,已生效」 |
| 10 类(「至少一个指定用户节点」为「要求」)全部节点被跳过 | 节点数 ≥ 1,审批人全部解析为空 | 提交被拒、不生成审批单(R-12-018 例外) | 「审批流中的审批人均不可用,请联系审批配置管理员」 |
| 审批人是申请人本人 | — | 照常待审 | 申请人在审批中心待审批里看到 |
| 在途审批人被禁用 | 单子没人能审 | 不自动处理 | 申请人可撤回重提,或管理员作废 |
| 审批人被收回「审批中心(查看)」 | 看不到审批中心菜单 | 快照不变,照常可审 | 从通知链接打开审批详情处理 |
| 最终通过时业务执行失败 | 点确定 | 回滚(R-12-045) | 确认框不关,红字显示业务原因;详情页出现「最近一次通过未执行」 |
| 重复点通过 | 同一人在两个标签页先后提交 | 只记第一次 | 第二次提示「该审批单状态已变化,请刷新」并刷新 |
| 会签里别人刚驳回 | 我还在页面上点通过 | 拒绝操作 | 提示「该审批单状态已变化,请刷新」并刷新 |
| 申请人刚撤回 / 管理员刚作废 | 审批人点通过 / 驳回 | 拒绝操作 | 同上 |
| 操作失败(网络 / 服务异常) | 接口报错 | 不改状态 | 提示「操作失败,请重试」,确认框不关 |
2.2.6 验收标准
- G-12-011 前置:新建客户规则 1 节点数 0;申请人角色在规则 1。操作:申请人提交新建客户。期望:业务页弱提示「提交成功,无需审批,已生效」;审批单直接为「已通过」,有单号;时间线为发起记录 + 「无需审批,自动通过」;申请人收到「审批通过」通知;这张单出现在申请人审批中心「全部审批」和客户管理「已提交审批」里。
- G-12-012 前置:账户充值规则 2(角色 财务)的节点为 节点1 绑定的销售、节点2 指定用户 王敏;申请人角色 财务;客户 A 的销售是 张三。操作:申请人对客户 A 提交充值。期望:业务页弱提示「已提交审批」;命中规则 2;审批单审批中、当前节点 1;张三在审批中心待审批里看到这张单并收到待审批通知;王敏在全部审批里能看到,但没有通过 / 驳回按钮。
- G-12-013 前置:同 G-12-012,但客户 A 没有销售。操作:提交。期望:节点 1 显示「已跳过(未找到审批人)」;当前节点直接是王敏;张三不在审批流里。
- G-12-014 前置:账户充值规则 1 节点 1 为绑定的运营、节点 2 为王敏;一张充值单涉及客户 A 的账户 1(优化师 张三)、账户 2(优化师 张三)、账户 3(优化师 赵六)。操作:提交。期望:节点 1 是会签节点,名单为 张三、赵六(张三只出现一次);张三通过后节点 1 仍是待审批;赵六也通过后进入节点 2。
- G-12-015 前置:按 G-12-014 构造的会签节点 张三、赵六,张三已通过。操作:赵六驳回,备注留空。期望:审批单变为「已驳回」;后续节点显示「未处理」;申请人收到驳回通知,原因写「无」。
- G-12-016 前置:规则配置类型某规则节点 1 指定用户 王敏、节点 2 绑定的运营;王敏配置后被禁用;本单涉及的唯一账户的优化师已禁用。操作:提交。期望:两个节点都显示「已跳过(未找到审批人)」,其后追加「无需审批,自动通过」;审批单直接「已通过」。
- G-12-017 前置:审批单在节点 1 待王敏审批。操作:管理员把该类型节点 1 改成赵六并保存。期望:这张单仍是王敏待审批;保存后新提交的单节点 1 是赵六。
- G-12-018 前置:审批单在节点 1 待王敏审批。操作:王敏账号被禁用。期望:单子仍停在节点 1,不自动跳过;申请人可以撤回。
- G-12-019 前置:节点 1 指定的用户就是申请人本人。操作:申请人提交。期望:节点 1 待申请人审批;申请人在审批中心待审批里看到这张单并能通过。
- G-12-020 前置:审批单待王敏审批。操作:王敏在两个浏览器标签里先后点「审批通过」并确定。期望:只记一条通过记录;第二次提示「该审批单状态已变化,请刷新」并刷新。
- G-12-034 前置:额度调整单审批中,最后一个节点只有王敏;05 列明的执行失败情形已发生(例:额度有效期已过,业务原因「额度有效期 2026-10-20 已过,请驳回后重新提交」)。操作:王敏 2026-10-21 10:30 在审批详情点「审批通过」并确定;再取消确认框,点「驳回」。期望:第一次确认框不关闭,备注框上方红字显示该原因;审批单仍「审批中」,时间线王敏仍「待审批」、无通过记录;申请人没收到通过通知;刷新后审批信息区显示「最近一次通过未执行:额度有效期 2026-10-20 已过,请驳回后重新提交(王敏 2026-10-21 10:30)」;驳回确认框的备注为空;驳回后审批单「已驳回」,该行不再显示。
- G-12-035 前置:规则配置类型节点 1 为绑定的运营。①新建客户节点 1 为绑定的运营,新客户没有账户;②客户信息变更节点 1 为绑定的运营,客户 A 名下账户 1 优化师 张三、账户 2 优化师 赵六(已禁用);③付款主体变更节点 1 为绑定的销售,客户 A 的销售 李四 已禁用。操作:分别提交。期望:①节点跳过;②节点 1 为普通节点,名单只有张三;③节点跳过。三者时间线被跳过的节点都显示「已跳过(未找到审批人)」。
2.3 审批详情页通用格式
2.3.1 功能描述
所有审批类型共用一个审批详情页,只有一个页面地址,按审批单号打开(R-12-026)。入口:审批中心「审批详情」、各业务页「已提交审批」的「详情」、通知里的链接、业务页里的审批单号(交易明细、收付款中心关联审批单号等)、在途单提示里的单号(R-12-047),一律新页打开这个地址。上半部分「审批信息」由本页定义;下半部分「审批内容」由各业务包定义。
2.3.2 核心字段
| 字段名 | key | 类型 | 必填 | 枚举/取值 | 默认值 | 规则说明 |
|---|---|---|---|---|---|---|
| 审批单号 | approval_no | string | 是 | — | — | 格式以技术为准,文档里的示例仅示意 |
| 审批状态 | status | enum | 是 | 审批中 / 已通过 / 已驳回 / 已撤回 | — | — |
| 申请人 | applicant_id | 关联用户 | 是 | 展示姓名;已禁用显示「姓名(已禁用)」 | — | R-12-049 |
| 申请时间 | submitted_at | datetime | 是 | yyyy-mm-dd hh:mm:ss | — | — |
| 审批事项 | category | enum | 是 | — | — | — |
| 审批类型 | type | enum | 是 | — | — | — |
| 最近一次通过未执行 | last_failed_pass | 文本 | 否 | 「{原因}({审批人} {yyyy-mm-dd hh:mm})」 | — | 只在审批中且有记录时显示,R-12-045 |
| 审批流 | flow_snapshot + records | 时间线 | 是 | — | — | R-12-027~R-12-029 |
2.3.3 业务规则
- R-12-026 审批详情只有一个页面地址,按审批单号打开;进入只要求登录,不要求「审批中心(查看)」或任何业务菜单权限点,能否看到内容按 R-12-043 由服务端判断(D-12-34)。页面标题为「{审批事项}/审批详情」,首段是纯文本、不可点;不另加面包屑;侧栏高亮「审批中心」(当前用户没有该菜单时不高亮任何项)。页面分「审批信息」「审批内容」两块。审批信息展示 审批单号、审批状态、申请人、申请时间(yyyy-mm-dd hh:mm:ss)、审批事项、审批类型、最近一次通过未执行(R-12-045,有才显示)、审批流。
- R-12-027 审批流时间线从左到右:先是发起记录(申请人、「发起」、时间、发起备注),再按快照顺序列出每个节点。每条记录展示 用户名、动作、时间(yyyy-mm-dd hh:mm)、备注;备注为空就不显示(D-12-22)。
- R-12-028 节点状态文字与颜色(D-12-19):
| 状态 | 文字 | 颜色 | 时间 | | --- | --- | --- | --- | | 发起 | 发起 | 绿 #16a34a | 有 | | 已通过 | 通过 | 绿 #16a34a | 有 | | 已驳回 | 驳回 | 红 #dc2626 | 有 | | 轮到了、还没处理 | 待审批 | 灰 #6b7280 | 无 | | 还没轮到 | 未开始 | 浅灰 #9ca3af | 无 | | 被跳过 | 已跳过(未找到审批人) | 浅灰 #9ca3af | 无 | | 单子已驳回 / 撤回 / 作废,后面没处理的 | 未处理 | 浅灰 #9ca3af | 无 | | 免审 | 末尾追加一条:无需审批,自动通过(R-12-018) | 绿 #16a34a | 有 | | 撤回 | 末尾追加一条:申请人 · 撤回 · 时间 | 橙 #ea580c | 有 | | 作废 | 末尾追加一条:{操作人} · 作废 · 时间 · 原因(R-12-046) | 橙 #ea580c | 有 |
- R-12-029 会签节点在节点名上方显示一排状态圆点,每个审批人一个,颜色 通过绿 #16a34a / 驳回红 #dc2626 / 待审批灰 #6b7280 / 未处理浅灰 #9ca3af(会签终止后没处理的人),选中的圆点有描边。点圆点切换下方显示的审批人;默认选中名单第一个人。圆点数量不设上限,一行放不下时,其余的收进「+N」悬浮层。
- R-12-030 「审批内容」区的展示字段由各业务包定义;本页提供变更高亮能力(D-00-75):比对基准 = 提交那一刻该对象的生效值,由业务包提交时给出、随审批单快照保存(规则配置取新起始日期前一天适用的那条);审批中、审批结束后回看都按这份基准比,所有查看者看到的标红一致。与基准不同的字段值标红,标红格下方灰字「原:{原值}」;原值为空的不标红,也不显示「原」。规则起始日期不参与标红,与已有记录同日时内容区写「将覆盖 yyyy-mm-dd 起的规则」(03 落实)。审批中、该对象当前生效值已与基准不同时,内容区顶部提示「提交后该{对象}已有变更,当前生效值与本单比对基准不同」;审批结束后不显示此提示。哪些审批类型启用高亮、对象叫什么,由业务包声明;04 付款主体的删除线展示不变。
- R-12-031 页面底部按钮:满足 R-12-023 时显示「驳回」「审批通过」;当前用户是申请人、且审批中时显示「撤回」(R-12-032);当前用户持「审批配置」、且审批中时显示「作废」(R-12-046);都不满足时不显示按钮区。
- R-12-043 审批详情页的查看范围是三类人(D-12-24、D-12-25):①这张单的申请人,以及快照审批人名单里的人(包括还没轮到的;不要求持「审批中心(查看)」,也不要求下表的页面查看点);②对这张单关联的业务单据有查看权限的人,按下表沿用各业务现有数据权限,另含 D-00-71 规定的「收付款中心」权限点持有人(只给审批详情查看资格,不给业务页面访问权,R-13-051),只读,不显示通过、驳回、撤回按钮;③持「审批配置」权限点的人,可只读打开任何审批单(为执行作废,D-00-79③、D-12-30),只显示「作废」按钮(审批中时)。三类都不是的人,就算拿到链接也只显示「无权限查看」,不展示任何审批信息和审批内容。服务端同样校验。
| 审批类型 | 关联业务单据 | 第②类:谁能看(沿用现有权限,不新增) | 落实方 | | --- | --- | --- | --- | | 规则配置 | 客户登记表 | 登记表的创建人,或有「客户管理-只读」「客户管理-读写」任一权限点、且登记表关联的客户在其客户数据范围内的人(D-00-77、D-03-23、R-03-050;未关联客户时只有创建人) | 03 | | 新建客户 | 客户(申请中,尚不存在) | 有「客户管理-只读」或「客户管理-读写」权限点、且按本单提交内容里的销售是不是本人判断(sys 看全部,R-04-043、D-12-46) | 04 | | 客户信息变更 / 付款主体变更 | 客户 | 有「客户管理-只读」或「客户管理-读写」权限点、且该客户在其客户数据范围内的人(非 sys 须是该客户的销售或其名下任一账户的优化师,D-00-77、D-12-26、R-04-043) | 04 | | 账户充值 / 充值退款 / 额度调整 / 余额分配 | 账户 | 对单里任一账户有查看权限、且持「费用管理(查看)」的人(费用管理原型 3.1.3:权限跟着账户走;页面查看点 D-12-44) | 05 | | 提成规则配置 | 提成规则 | 有「提成规则管理」权限点的人(费用管理原型 3.1.6 新增的权限点) | 05 | | 生成结算单 | 账单 / 结算单 | 对账单里任一账户有查看权限、且持「账单管理(查看)」的人(D-12-44) | 06 | | 客户返点 / 客情费用 | 返点单 | 对单里任一账户有查看权限、且持「返点管理(查看)」的人(D-12-44) | 07 | | 渠道付款 / 渠道对账 | 渠道批次 | 有「渠道对账中心」权限点的人(没有客户维度,R-08-082) | 08 |
另:账户充值、充值退款、额度调整、余额分配、生成结算单、客户返点、客情费用、渠道付款这 8 种,有「收付款中心」权限点的人也可只读查看审批详情(D-00-71、R-13-050);「渠道对账」不在其中。
- R-12-044 本页只向业务包询问「这个用户能不能查看这张业务单据」,判断逻辑由各业务包按上表实现;业务数据权限变化后,审批详情的可见范围随之变化,不另存一份。一张单涉及多个账户、而查看者只对其中部分账户有权限时,照样能打开审批详情;「审批内容」区里没权限的账户行是否隐藏,由业务包决定(参照费用明细「按账户查看权限展示内容」)。
- R-12-047 在途单提示统一句式(D-12-37):业务包因为已有在途单据而锁定页面或拒绝操作时,提示句末统一追加在途单信息,各页引用本条,不各写:
- 在途的是审批中的审批单:「该{对象}已有审批中的{审批类型}(审批单号 {单号},申请人 {姓名}),请等审批结束或撤回后再操作」。
- 06 / 08 在途的是审批已通过、收付款单还没完成的单:「该{对象}已有处理中的{单据}({收款单 / 付款单} {财务ID},{待完成 / 待汇出}),待{收款 / 付款}完成后再操作」。
- 审批单号可点,新页打开审批详情;没有查看资格的按 R-12-043 显示「无权限查看」。带单号的提示不用会自动消失的弱提示:页面锁定状态用页面顶部提示条,点按钮被拦时用提示框(按钮「知道了」)。{对象}{审批类型}{单据} 由业务包填。
- R-12-049 已禁用用户的显示(D-00-83):审批详情的申请人、时间线操作人、会签圆点切换后的审批人、审批配置节点框回显,用户已禁用时显示「姓名(已禁用)」,不显示用户 ID;已存的快照和配置原样保留,不因禁用而改动。
2.3.4 异常与边界
| 场景 | 现象 | 系统行为 | 用户看到 |
|---|---|---|---|
| 审批单号不存在 | 打开链接 | — | 「审批单不存在」空态 |
| 不在审批流里、但能看这笔业务数据 | 打开链接 | 只读返回(R-12-043②) | 完整详情,无操作按钮 |
| 持「审批配置」、与本单无关 | 打开链接 | 只读返回(R-12-043③) | 完整详情;审批中时只有「作废」 |
| 不在审批流里、也看不到这笔业务数据 | 打开链接 | 服务端拒绝返回数据(R-12-043) | 「无权限查看」 |
| 没有「审批中心(查看)」的审批人 | 从通知链接打开 | 正常返回(R-12-043①) | 完整详情与通过 / 驳回按钮;侧栏不高亮 |
| 会签人很多 | 圆点一行放不下 | 收进「+N」 | 鼠标悬浮展开其余圆点 |
| 页面打开期间状态变了 | 点按钮 | 服务端拒绝 | 「该审批单状态已变化,请刷新」并刷新 |
| 审批中对象已被改动 | 打开详情 | 按快照基准标红(R-12-030) | 内容区顶部提示「提交后该{对象}已有变更…」 |
| 备注很长 | 时间线展示 | 节点宽度固定,备注折行 | 完整显示 |
2.3.5 验收标准
- G-12-021 前置:按 G-12-014 方式构造三人会签节点(涉及 3 个账户,优化师 张三、赵六、钱七),张三已通过、赵六待审批、钱七待审批。操作:打开审批详情。期望:节点上有 3 个圆点(绿、灰、灰);默认显示张三的通过记录;点第三个圆点切换成 钱七 · 待审批。
- G-12-022 前置:审批单审批中,当前用户既不是当前节点审批人,也不是申请人,也没有「审批配置」。操作:打开审批详情。期望:不显示任何操作按钮。
- G-12-031 前置:审批单 AP202610160037 的申请人是刘佳,审批人是陈思远和王敏;孙磊不在其中,也没有「审批配置」与相关业务权限。操作:孙磊打开这张单的审批详情链接;王敏(节点 2,还没轮到)打开同一链接。期望:孙磊看到「无权限查看」,页面上除了单号没有任何信息;王敏能看到完整详情,但没有操作按钮。
- G-12-032 前置:AP202610160037 是客户 A 账户 1 的账户充值单;财务 周婷 不在审批流里,但有账户 1 的查看权限。操作:周婷在费用明细的交易明细里点这个审批单号。期望:新页打开审批详情,能看到审批信息和审批内容,不显示任何操作按钮;收回她的账户 1 权限后再打开,显示「无权限查看」。
- G-12-036 前置:客户信息变更单提交时客户 A 公司简称为「星海」、备注为空,提交值为「星海互娱」、备注「补充」;该单已通过,通过后客户 A 的简称又被改成「星海科技」。操作:打开这张单的审批详情。期望:「星海互娱」标红,下方灰字「原:星海」;备注不标红、不显示「原」;不出现「提交后该客户已有变更」提示(单子已结束);另一张同样内容、仍审批中的单,在客户 A 生效值变化后打开,顶部出现「提交后该客户已有变更,当前生效值与本单比对基准不同」,标红仍按提交时基准。
- G-12-037 前置:客户 A 已有审批中的付款主体变更 AP202610150019(申请人 刘佳);04 规定同一客户同时只能有一张审批中的付款主体变更。操作:周婷在客户 A 上再次发起付款主体变更被拦;再点提示里的单号。期望:弹出提示框「该客户已有审批中的付款主体变更(审批单号 AP202610150019,申请人 刘佳),请等审批结束或撤回后再操作」,不自动消失,点「知道了」关闭;点单号新页打开审批详情,周婷没有查看资格时显示「无权限查看」。
- G-12-038 前置:账户充值单 AP202610160041 待王敏审批;王敏没有「审批中心(查看)」(配置后被收回);申请人刘佳之后账号被禁用。操作:王敏从企业微信通知链接打开;再从审批中心列表、交易明细里点同一单号。期望:三处打开的都是同一个审批详情地址;标题「费用管理/审批详情」中「费用管理」不可点,没有面包屑;王敏看到「通过」「驳回」并能通过,侧栏不高亮任何项;申请人显示「刘佳(已禁用)」。持「审批中心(查看)」的用户打开时侧栏高亮「审批中心」。
2.3.6 示意
2.4 撤回与作废
2.4.1 功能描述
申请人对自己还在审批中的单子撤回;持「审批配置」权限点的人可作废任何审批中的单(兜底在途卡死的单)。所有审批类型通用。撤回入口在各业务页「已提交审批」tab 的行操作(如 R-01-036),以及审批详情页底部;作废入口只在审批详情页底部。审批中心不放撤回、作废(D-12-09)。
找单路径(作废):业务人员在在途单提示(R-12-047)里看到单号,转给持「审批配置」的人,按单号打开审批详情作废(R-12-046)。
2.4.2 业务规则
- R-12-032 14 种审批类型都支持撤回;只校验「申请人本人」且「审批中」,不校验任何业务权限点(D-00-79②):申请人的业务权限被收回或降为只读后,仍可在审批详情页撤回本人的审批中单。入口在各业务页「已提交审批」tab 的行操作和审批详情页,审批中心不放撤回。
- R-12-033 撤回二次确认文案:「撤回后,本次审批申请将被立即关闭并作废,审批进度将终止。请注意:撤回后无法在本单据上直接修改或重新提交。如需再次申请,请移步至表单页面重新填写。确认撤回吗?」,按钮「取消」「确定」。
- R-12-034 确认后审批单变为「已撤回」,当前节点所有人的待办消失,弱提示「已撤回」并刷新。已撤回的单子不能再改,也不能原单重新提交。
- R-12-035 撤回时,通知当前节点里还没处理的所有人:普通节点就是那一位,会签节点是这个节点所有没处理的人(D-12-11、D-12-16)。
- R-12-046 作废(D-00-79③、D-12-29、D-12-30):持「审批配置」权限点的人,对任何审批中的单,在审批详情页底部有「作废」按钮。点后弹二次确认,标题「作废审批单」,文案「作废后,本审批单立即关闭,效果同撤回,业务单据按撤回处理。确认作废吗?」,下方「作废原因」多行输入框必填(最多 1,024 字),为空点确定时标红「请填写作废原因」。确定后:审批单变为「已撤回」,当前节点所有人的待办消失;时间线末尾追加「{操作人} · 作废 · 时间 · 原因」;按「已撤回」通知业务包(R-12-025);通知申请人和当前节点里还没处理的人(R-12-038,操作人本人不发);弱提示「已作废」并刷新。服务端校验「审批配置」权限点与审批中状态;已通过、已驳回、已撤回的单不能作废。
2.4.3 异常与边界
| 场景 | 现象 | 系统行为 | 用户看到 |
|---|---|---|---|
| 撤回 / 作废前一刻单子已经通过 / 驳回 / 撤回 | 点确定 | 拒绝 | 「该审批单状态已变化,请刷新」并刷新 |
| 非申请人通过接口调撤回 | — | 服务端拒绝 | 「无权限操作」 |
| 没有「审批配置」的人通过接口调作废 | — | 服务端拒绝 | 「无权限操作」 |
| 申请人业务权限已被收回 | 在审批详情点撤回 | 照常撤回(R-12-032) | 「已撤回」 |
| 作废原因为空 | 点确定 | 不提交 | 原因框标红「请填写作废原因」 |
2.4.4 验收标准
- G-12-023 前置:申请人有一张审批中的付款主体变更单,节点 1 为绑定的运营,客户名下账户优化师为 张三、赵六(会签),张三已通过。操作:申请人在客户管理「已提交审批」点撤回并确定。期望:状态变为「已撤回」;时间线末尾多一条 申请人 · 撤回;赵六收到撤回通知,张三收不到;赵六的待审批列表里这张单消失。
- G-12-024 前置:审批单已通过。操作:申请人打开审批详情。期望:没有撤回按钮;业务页已提交审批这一行也没有撤回。
- G-12-039 前置:刘佳提交了一张审批中的客户信息变更单后,权限被降为只有「客户管理-只读」;另有刘佳提交的审批中规则配置、账户充值、生成结算单、客户返点、渠道付款单各一张。操作:刘佳逐张打开审批详情点撤回并确定。期望:每张详情都显示「撤回」,都能撤回成功、状态变「已撤回」。
- G-12-040 前置:账户充值单审批中,申请人刘佳,当前节点会签 张三(已通过)、赵六(待审批);孙磊持「审批配置」,不在流程、无账户权限;周婷没有「审批配置」。操作:孙磊打开审批详情,点「作废」,不填原因点确定;再填「申请人已离职」点确定;周婷通过接口调作废另一张单。期望:孙磊能只读看到详情,底部只有「作废」;第一次标红「请填写作废原因」不提交;第二次后状态「已撤回」,时间线末尾「孙磊 · 作废 · {时间} · 申请人已离职」;赵六待办消失;刘佳与赵六收到作废通知,张三不收;05 按撤回处理该充值单;周婷的请求被拒「无权限操作」。
2.4.5 示意
2.5 审批中心
2.5.1 功能描述
左侧菜单「审批中心」。审批人在这里集中处理待办、回看与自己相关的审批单;行内可以直接通过 / 驳回,也可以进审批详情。
2.5.2 核心字段
| 字段名 | key | 类型 | 必填 | 枚举/取值 | 默认值 | 规则说明 |
|---|---|---|---|---|---|---|
| 审批单号 | approval_no | string | 是 | — | — | 搜索项 |
| 审批事项 | category | enum | 是 | 同 2.1 | — | 筛选项 |
| 审批类型 | type | enum | 是 | 同 2.1 | — | 筛选项,随审批事项联动 |
| 申请时间 | submitted_at | datetime | 是 | yyyy-mm-dd hh:mm:ss | — | 排序依据 |
| 审批状态 | status | enum | 是 | 审批中 / 已通过 / 已驳回 / 已撤回 | — | 筛选项(仅全部审批标签,R-12-037) |
| 操作 | — | — | — | 审批详情 / 通过 / 驳回 | — | R-12-023 |
2.5.3 业务规则
- R-12-036 审批中心有「待审批」「全部审批」两个标签,默认待审批,两个标签字段一致。待审批 = 审批中、且当前用户在当前节点名单里还没处理的单;全部审批 = 当前用户出现在审批流里的所有单,包括自己发起的(含免审单)、审过的、正等自己审的、还没轮到自己的(D-12-10)。
- R-12-037 列表字段:审批单号、审批事项、审批类型、申请时间、审批状态、操作。搜索按审批单号模糊匹配;筛选 审批事项、审批类型(随审批事项联动),默认全部;「审批状态」筛选只在全部审批标签显示,选项 全部 / 审批中 / 已通过 / 已驳回 / 已撤回,默认全部,待审批标签不显示该筛选。待审批标签按申请时间降序;全部审批标签里待我审批的置顶,其余按申请时间降序。分页 10/50/100/300 条每页,默认 10(D-12-15)。
- R-12-042 审批中心菜单与页面按「审批中心(查看)」权限点显示(D-00-78、D-12-24):有该点才在侧栏看到一级「审批中心」下的「审批中心」并能进入,数据只按 R-12-036 显示与自己相关的单;没有该点时不显示菜单,直接访问显示「无权限访问」(页面形态按 13 R-13-005),服务端同样校验。审批详情不要求该点(R-12-026、R-12-043);被收回该点的审批人仍可从通知链接、业务页链接打开审批详情处理(D-00-78)。
- R-12-048 待办角标(D-12-35):侧栏一级「审批中心」和二级「审批中心」旁显示待办数角标,数 = 当前用户待审批标签的条数(R-12-036);0 不显示,超过 99 显示「99+」。进入页面、切换路由、本人通过 / 驳回后刷新,不要求实时推送。没有「审批中心(查看)」的用户没有该菜单,也就没有角标。
行操作:所有行都有「审批详情」(新页打开 2.3);「通过」「驳回」只在满足 R-12-023 时显示,点后弹出与审批详情相同的二次确认(R-12-020、R-12-045)。
2.5.4 异常与边界
| 场景 | 现象 | 系统行为 | 用户看到 |
|---|---|---|---|
| 与我无关 | 两个标签都没数据 | — | 空态「暂无审批」 |
| 搜索 / 筛选无结果 | — | — | 空态「暂无数据」 |
| 行内处理时状态已变 | 点确定 | 拒绝 | 「该审批单状态已变化,请刷新」并刷新列表 |
| 行内最终通过遇业务执行失败 | 点确定 | 回滚(R-12-045) | 确认框不关,红字显示业务原因 |
| 处理完一行 | 待审批标签 | 刷新列表与角标 | 该行消失,角标减 1 |
| 没有「审批中心(查看)」 | 直接访问 | 拒绝(R-12-042) | 「无权限访问」 |
2.5.5 验收标准
- G-12-025 前置:用户 张三 有 3 张待自己审批、2 张自己审过的、1 张流程里排在后面还没轮到的、1 张自己发起的。操作:打开审批中心。期望:默认待审批标签显示 3 张;全部审批显示 7 张,待我审批的 3 张在最前,其余按申请时间降序。
- G-12-026 前置:待审批标签有单子。操作:在列表行上点「驳回」并确定。期望:弹出与审批详情相同的二次确认;确定后这一行从待审批消失。
- G-12-027 前置:用户与任何审批单都无关。操作:打开审批中心。期望:两个标签都显示空态「暂无审批」。
- G-12-041 前置:张三有 3 张待审批。操作:登录看侧栏;在待审批标签通过 1 张;看待审批与全部审批两个标签的筛选栏;在通过确认框备注里输入第 1,025 个字。期望:侧栏一级、二级「审批中心」旁都显示「3」,通过后变「2」;待审批标签没有「审批状态」筛选,全部审批标签有,选项 全部 / 审批中 / 已通过 / 已驳回 / 已撤回;第 1,025 个字输不进去。另:张三处理完全部待办后角标不显示。
- G-12-042 前置:周婷没有「审批中心(查看)」。操作:登录看侧栏,直接访问审批中心地址。期望:侧栏一级「审批中心」下没有「审批中心」子项、没有角标;直接访问显示「无权限访问」。
2.5.6 示意
2.6 审批通知
2.6.1 功能描述
审批流转时,按时机给对应的人发企业微信或邮件。文案来自原型(审批详情-客户管理.html 注释第五节);作废文案按原型句式补。
2.6.2 业务规则
- R-12-038 通知时机:节点轮到某人时,通知这个节点的所有人;审批单变为已通过或已驳回时,通知申请人;申请人撤回时,按 R-12-035 通知;作废时,通知申请人和当前节点里还没处理的人(R-12-046);跳过的节点不通知;最终通过执行失败(R-12-045)不发通知。
- R-12-039 通知渠道:收件人绑定了企业微信,就只发企业微信;没绑企业微信但有邮箱,就发邮件;两者都没有就不发,只记日志。企业微信发送失败不降级到邮件,只记日志。本期不做短信(D-12-11)。
- R-12-040 文案按下表;{审批事项-审批类型} 形如「客户管理-新建客户」;{链接} 指向这张单的审批详情地址(R-12-026);驳回原因取驳回备注,为空时写「无」(D-12-05);作废原因取作废时填的原因。
| 事件 | 收件人 | 企业微信 | 邮箱 |
|---|---|---|---|
| 轮到审批 | 当前节点全部审批人 | 【待审批】{审批事项-审批类型},申请人:{申请人},单号:{单号}。请及时处理。链接:{链接} | 主题:【待审批】{审批事项-审批类型} - {申请人};正文:您有一条待审批:{审批事项-审批类型},申请人:{申请人},单号:{单号}。请登录系统处理。链接:{链接} |
| 审批通过 | 申请人 | 【审批通过】您的{审批事项-审批类型}已通过,单号:{单号}。链接:{链接} | 主题:【审批通过】{审批事项-审批类型} - {单号};正文:您好,您提交的{审批事项-审批类型}已通过,单号:{单号}。链接:{链接} |
| 审批驳回 | 申请人 | 【审批驳回】您的{审批事项-审批类型}被驳回,单号:{单号},原因:{驳回原因}。链接:{链接} | 主题:【审批驳回】{审批事项-审批类型} - {单号};正文:您好,您提交的{审批事项-审批类型}被驳回,单号:{单号},原因:{驳回原因}。链接:{链接} |
| 审批撤回 | 当前节点没处理的人 | 【审批撤回】{申请人}已撤回{审批事项-审批类型},单号:{单号}。请知悉。链接:{链接} | 主题:【审批撤回】{审批事项-审批类型} - {单号};正文:您好,{申请人}已撤回{审批事项-审批类型},单号:{单号}。链接:{链接} |
| 审批作废 | 申请人、当前节点没处理的人(操作人本人除外) | 【审批作废】{审批事项-审批类型}(申请人:{申请人})已被{操作人}作废,单号:{单号},原因:{作废原因}。链接:{链接} | 主题:【审批作废】{审批事项-审批类型} - {单号};正文:您好,{审批事项-审批类型}(申请人:{申请人})已被{操作人}作废,单号:{单号},原因:{作废原因}。链接:{链接} |
2.6.3 异常与边界
| 场景 | 现象 | 系统行为 | 用户看到 |
|---|---|---|---|
| 收件人没有任何渠道 | — | 不发,日志记「无可用渠道」 | 收不到通知;有「审批中心(查看)」的审批中心照常有待办 |
| 企业微信接口失败 | — | 不降级,日志记发送失败 | 收不到通知 |
| 申请人自己就是下一节点审批人 | — | 照常发待审批通知 | 收到通知 |
2.6.4 验收标准
- G-12-028 前置:按 G-12-014 方式构造三人会签节点(张三、赵六、钱七);张三绑定了企业微信和邮箱;赵六没绑企业微信、有邮箱;钱七都没有。操作:该会签节点轮到。期望:张三只收到企业微信;赵六收到邮件;钱七收不到,通知日志记「无可用渠道」。
- G-12-029 前置:张三绑定了企业微信,但企业微信接口返回失败。操作:轮到张三审批。期望:不发邮件;通知日志记发送失败。
3 变更影响面
| 被影响对象 | 影响方式 | 处理动作 | 负责人 |
|---|---|---|---|
| 03、04、05、06、07、08 各业务包 | 提交审批时要传 审批类型、操作对象客户、涉及账户(客户级单据传客户名下全部账户,D-00-76)、业务单据、发起备注;变更类传比对基准 | 各包 PRD 写清每种审批类型的操作对象客户、涉及账户取哪些;渠道两类不提供动态选项(R-12-010) | 各业务包 |
| 同上 | 审批详情「审批内容」区 | 各包定义字段;变更类声明是否启用高亮、对象名称,基准按 R-12-030(D-00-75) | 各业务包 |
| 同上 | 最终通过执行失败 | 各包列明哪些情形算执行失败及业务原因文案(R-12-045,D-00-79①);未列明的不得拒绝 | 各业务包 |
| 同上 | 审批结束回调 | 各包写清 已通过 / 已驳回 / 已撤回(含作废)后业务单据怎么变(R-12-025) | 各业务包 |
| 同上 | 提交提示与在途提示 | 提交后弱提示引用 R-12-018;「已有在途单」提示引用 R-12-047,不各写 | 各业务包 |
| 各业务页「已提交审批」tab(01、04、05、06、07、08) | 撤回入口、免审单 | 撤回规则、文案引用本页 2.4,只看申请人本人 + 审批中(R-12-032);列表含免审单(R-12-018) | 各业务包 |
| 08-渠道对账 | 预置清单新增「渠道对账中心—渠道对账」(上传批次审批),与「渠道付款」是两种 | 08 定义两种审批各自的审批内容 | 08 包 |
| 02 / 04 | 「绑定的运营」解析账户优化师;客户「运营」字段去掉(D-00-76) | 02 维护优化师;04 不再有运营字段 | 02、04 包 |
| 13-导航与权限 | 权限点 | 汇总「审批中心(查看)」「审批配置」两个权限点(R-12-041、R-12-042,D-00-78);「审批配置」另含作废与只读查看任何审批详情(R-12-046、R-12-043③) | 13 包 |
| 03、04、05、06、07、08 各业务包 | 审批详情第②类查看范围沿用业务数据权限(R-12-043、R-12-044) | 各包提供「用户能否查看该业务单据」的判断,口径按 R-12-043 表(客户相关按 D-00-77 数据范围);业务页里的审批单号一律新页打开 12 审批详情唯一地址(R-12-026) | 各业务包 |
| 上线 | 0 节点即免审(D-12-07);存量节点(index S-15) | 上线前把 14 种类型的审批流配好,至少涉钱 8 类;存量节点与规则按 R-12-050 迁移(「账户销售」即「绑定的销售」、「账户优化师」即「绑定的运营」,保留;「规则 1 为 0 节点、规则 2 起没覆盖全部角色」的类型列入检查清单由用户逐个确认;角色重叠归原排序最前的那条;「发起人」节点有残留即阻断上线、由管理员重配);核对编辑时间不为「—」、没有空节点、R-12-012③ 的 10 类不只配动态节点;给角色配「审批中心(查看)」「审批配置」后用户重新登录 | 用户 / 运维 |
| 角色管理、用户管理 | 角色增删、用户禁用、权限点收回会影响规则、候选和解析 | 沿用现有数据,不改页面;按 R-12-005、R-12-008、R-12-010、R-12-016 读取 | 技术 |
4 非功能与留痕
- 权限:通过、驳回、撤回、作废都在服务端按 R-12-023、R-12-032、R-12-046 再校验一次,前端隐藏按钮不算权限控制。
- 审计:审批记录(发起、通过、驳回、撤回、作废、已跳过、自动通过)只追加、不修改,本身就是审批单的操作日志;最终通过执行失败记一条失败记录(原因、审批人、时间),不进时间线;审批流配置每次保存记录编辑人、编辑时间;每条通知记录收件人、渠道、发送结果,没发(无渠道)和发失败都要记。
- 量级:原型没给数据量,不设性能指标,由技术沿用现有列表方案。
5 开放问题与已知限制
开放问题:暂无。节点上限(D-12-23)、审批相关权限(D-12-24、D-12-25、D-12-26)、动态选项(D-12-27、D-12-31)已由用户确认。
已知限制:
- 本期节点配置仍单选(D-12-33)。「绑定的销售」每单只解析一个客户的销售,不会产生会签;会签只在「绑定的运营」解析出多人(本单涉及多个账户、优化师不同)时出现(D-00-43 备注)。
- 已通过的审批单不能撤回、作废;通过后业务单据有误(错单、退款被银行退回等)按 D-00-69 线下处理。
原由我代定的以下各项已于 2026-10-21 用户确认,全部转已定:D-12-17(规则 1 角色只读自动计算)、D-12-18(提交时就解析审批人)、D-12-19(时间线状态文字)、D-12-20(弹窗细节)、D-12-22(发起备注来源)、D-12-30(作废后状态记「已撤回」、作废入口只在审批详情、持「审批配置」可只读看任何审批详情)、D-12-39(指定用户 / 动态选项不按「审批中心(查看)」过滤解析)、D-12-40(免审单提交时业务执行失败则提交不成功)、D-12-41(已禁用的指定用户不算「指定用户节点」)、D-12-42(渠道两类存量动态节点保存时拦截)。