# 审批配置与审批中心 PRD

| 项 | 内容 |
| --- | --- |
| 所属产品 | ASA |
| 版本 | v2.1.0 |
| 页面 | 12-审批配置与审批中心 |
| 涉及功能 | [审批](../../../feature/审批/README.md) |
| 编制日期 | 2026-10-16（2026-10-21 按会议清单 v2 回写；2026-10-22 按闭环清单 A03、B10、B11、B12、B20 回写） |
| 文档状态 | 待评审 |
| 目标读者 | 研发、测试、AI 实现助手（本文件可直接整份投喂给 AI 作为实现依据） |
| 关联文档 | 本目录 spec.yaml、mocks/；版本 [index.md](../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 示意

<!-- mock: mocks/2.1-审批配置/01-列表默认态.html | 审批配置列表（默认态） -->
<!-- mock: mocks/2.1-审批配置/02-配置弹窗.html | 配置审批流弹窗（两套规则、审批人下拉展开） -->
<!-- mock: mocks/2.1-审批配置/03-保存校验失败.html | 配置审批流弹窗（保存校验失败） -->

### 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 示意

<!-- mock: mocks/2.3-审批详情/01-会签审批中.html | 审批详情（会签节点审批中，当前用户是待审批人） -->
<!-- mock: mocks/2.3-审批详情/02-已驳回含跳过.html | 审批详情（含跳过节点，已驳回，无按钮） -->
<!-- mock: mocks/2.3-审批详情/03-二次确认.html | 通过 / 驳回二次确认框 -->

### 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 示意

<!-- mock: mocks/2.4-撤回/01-撤回确认.html | 撤回二次确认框 -->

### 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 示意

<!-- mock: mocks/2.5-审批中心/01-待审批.html | 审批中心（待审批标签） -->
<!-- mock: mocks/2.5-审批中心/02-全部审批.html | 审批中心（全部审批标签） -->
<!-- mock: mocks/2.5-审批中心/03-空态.html | 审批中心（空态） -->

### 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（渠道两类存量动态节点保存时拦截）。
