OSL Institutional 审批系统（Approval Rules & Approval Groups）说明文件

一、什么是 OSL Institutional 的审批系统

OSL Institution 支持对机构内的关键操作设置审批流程——比如创建 API Key、编辑 API Key、提现等。一旦某类操作被设置了审批规则，团队成员发起这类操作后不会立即生效，而是先进入"待审批"状态，需要经过指定审批人同意后，系统才会真正执行这项操作。

整套审批系统由两个部分组成：

• 审批组（Approval Group）：一组有权审批的人。审批组本身不绑定具体某类操作，只是定义"这些人在一起构成一个审批单位"。

• 审批规则（Approval Rule）：定义"哪类操作"需要审批，以及需要"哪个/哪些审批组"审批、按什么策略审批（比如组内是否要全员同意）。

一条操作要不要走审批、由谁审批，最终由审批规则决定；审批规则又依赖审批组提供"人"。所以设置审批的顺序，通常是先建审批组，再建审批规则。

二、如何设置审批

2.1 创建审批组

进入 Setting → Security → Approval Groups，点击右上角 "+ New Group"。

• Group Name（必填）：给这个审批组起一个名字，例如 "Treasury Committee"

• Members（必填）：从团队成员里选择加入这个审批组的人，可以多选

填写完成后点击 Create Group。创建好的审批组会显示在列表里，包含组名、成员数量、状态（Active）和组内成员；已有的审批组可以点击 Edit 调整成员。

2.2 创建审批规则

进入 Setting → Security → Approval Rules，点击右上角 "+ New Rule"。

• Rule Name（必填）：给这条规则起一个名字，例如 "Edit API Key Approval"

• Operation Type（必填）：选择这条规则适用于哪类操作，例如 "Create API Key"、"Edit API Key"

• Approval Groups：从已创建好的审批组中选择一个或多个，为这条规则指定审批人。如果添加了多个审批组，页面会提示"Each group is notified only after the one above it approves"——也就是说多个审批组之间是接力审批，排在后面的组要等前一个组审批通过后才会收到通知，可以拖动调整顺序；点击 "+ Add approval group" 可以继续添加下一组

填写完成后点击 Create Rule。创建好的规则会显示在列表里，包含规则名称、状态（Active）、适用的 Operation Type、对应的审批组和审批策略（例如 "Unanimous" 表示该组内所有成员都要同意才算通过）；已有规则可以 Edit 调整，或 Disable 临时停用。

三、走审批流程的操作，通知是怎么触发的

下面以 创建 API Key 为例，说明一次完整的审批是如何触发和流转的（前提是 "Create API Key" 这个 Operation Type 已经被设置了审批规则）。

I. 发起操作：团队成员正常走完创建 API Key 的填写和身份验证步骤后提交，如果命中了已配置的审批规则，页面会显示 "Submitted for Approval"，并提示"Track approval progress on the Activity page. You will be notified once it is approved."——此时 API Key 还没有真正被创建，操作进入等待审批的状态。

II. 发起人收到通知：发起人会在站内信（Notification Center → Message）收到一条提醒，例如 "Your Create API Key Request Is Under Review"，点击 Detail 可以直接跳转查看审批详情。

III. 审批人收到通知：命中的审批组内的成员，会同时收到站内信和邮件通知，提示有一条新的请求需要他们审批。

IV. 审批人处理请求：审批人进入 Activity → Approvals，找到对应的审批单，点击进入详情页。详情页会展示这次操作的具体信息（例如 Portfolio、Label、Access Level、Permission Settings、IP Address 等），右侧 Timeline 会显示审批进度（Initiated → 审批组审批中 → End），审批人可以填写一段可选的 Approval Note，然后选择 Approve 或 Reject。

V. 结果通知发起人：不管审批通过还是被拒绝，发起人都会同时收到站内信和邮件通知结果，例如审批通过时会收到 "Your Create API Key Request Is Approved"。

VI. 审批通过后系统才真正执行操作：只有当这条请求走完审批规则里配置的全部审批组、全部通过之后，系统才会真正执行这项操作（比如这里就是真正创建出这个 API Key）；审批被拒绝，操作则不会被执行。

另外，在审批还没出结果之前，发起人可以在详情页点击 Recall 主动撤回自己提交的这条请求。

四、在 Activity 页面查看审批单

进入 Activity → Approvals，可以看到当前与你相关的全部审批单。

• 页面上方可以按 Style（例如 "Pending my approval"）和 Status 筛选，也支持搜索

• 列表字段：Activity（操作名称）、Initiated By（发起人和发起时间）、Status（当前状态和最后更新时间）、Actions（例如待审批状态下会显示 "Approval" 操作入口）

• 点击列表中任意一条审批单，可以进入详情页查看这次操作的具体信息、完整的审批 Timeline，以及（如果轮到你处理）可执行的 Approve / Reject / Recall 操作