【机构】角色权限体系和邀请流程
一、权限体系是怎么设计的
理解 OSL Institutional 的权限体系，只需要抓住两个维度：这个角色能访问哪些 Portfolio，以及在能访问的 Portfolio 内，这个角色具体能做什么操作。
1.1 Access Level：决定"能看到谁的账"
每个角色都归属于以下两种 Access Level 之一：
Institution 级别：不需要单独指定 Portfolio，自动拥有机构下所有 Portfolio（包括以后新建的）的访问权限。适合承担全局职责的角色，比如公司管理层、合规/审计人员。
Portfolio 级别：只能访问被明确授权的 Portfolio。邀请这类角色的成员时，需要额外勾选这个人具体可以访问哪几个 Portfolio。适合日常交易、只需要接触特定资金账户的角色。
一句话理解：Institution 级别是"看全局"，Portfolio 级别是"看指定的几本账"。
1.2 基础权限：决定"在能看到的地方能做什么"
在角色被授权访问的 Portfolio 范围内，具体能执行哪些操作，由"基础权限"决定，一共 4 类：
权限 | 说明 |
|---|---|
Read | 可访问所有页面，也可下载账单记录和报告 |
Initiate | 可发起审批策略变更、出金、转账、API Key 管理、出金地址和银行账户管理 |
Trade | 具备下单交易的能力，包括 Convert 和 StableHub |
User Management | 可为机构内的人员分配和修改角色与权限 |
每个角色拥有的基础权限组合各不相同，具体如下表。
二、角色一览
角色 | Access Level | Read | Initiate | Trade | User Management |
|---|---|---|---|---|---|
管理员 Administrator | Institution | ✅ | ✅ | ✅ | ✅ |
交易管理员 Trading Admin | Portfolio | ✅ | ✅ | ✅ | — |
交易员 Trader | Portfolio | ✅ | — | ✅ | — |
审批人 Approver | Institution | ✅ | — | — | — |
发起人 Initiator | Institution | ✅ | ✅ | — | — |
审计员 Auditor | Institution | ✅ | — | — | — |
团队经理 Team Manager | Institution | ✅ | — | — | ✅ |
各角色详细说明
管理员（Administrator） —— Institution 级别 拥有机构内的全部权限，包括团队管理和安全设置，是权限最高的角色。适合公司创始人、最高负责人使用，建议谨慎控制这个角色在机构内的人数。
交易管理员（Trading Admin） —— Portfolio 级别 在被授权的 Portfolio 内拥有完整的交易权限，既能自己下单交易，也能发起提现、策略变更等操作。适合管理某个具体资金账户、对该账户负全责的负责人。
交易员（Trader） —— Portfolio 级别 在被授权的 Portfolio 内可以执行交易、查看数据，但不能发起提现或修改账户设置。适合负责日常盘中操作、不需要接触资金调拨权限的交易执行人员。
审批人（Approver） —— Institution 级别 这个角色本身不直接带来审批权限——能不能审批，取决于有没有被加入相应的审批组。设立 Approver 这个角色主要是方便识别："这个人是我们团队里主要负责审批的人"，实际是否能审批某项操作，还是要单独把他加入对应的审批组。
发起人（Initiator） —— Institution 级别 可以发起提现、策略变更等操作，发起后需要交由审批组内的成员审批。适合负责提交申请、由其他人复核把关的场景。
审计员（Auditor） —— Institution 级别 只读权限，可以查看机构下所有 Portfolio 的数据、下载账单和报告，但不能执行任何操作。适合合规、审计人员，只需要监督和留痕，不需要参与实际操作。
团队经理（Team Manager） —— Institution 级别 负责团队成员管理（邀请、编辑角色、禁用账号），可以查看机构层面的数据，但不参与交易和审批。适合负责账号权限治理、偏行政向的角色。
一个成员可以同时拥有多个角色：邀请或编辑团队成员时，可以一次勾选多个角色（比如同时是 Trading Admin + Approver），系统会把所选角色的权限自动合并生效，不需要为同一个人重复邀请。
三、如何邀请团队成员
进入 Setting → Team Members，点击右上角 "+ Invite Member"，按以下 4 步完成邀请。
Step 1：Provide Information（填写邮箱）
填写受邀人的邮箱地址。
Step 2：Configure Access（配置权限）
勾选要授予该成员的一个或多个角色：
勾选 Institution 级别角色（Administrator、Team Manager、Initiator、Auditor、Approver）时，不需要额外配置，该角色会自动适用于机构下所有 Portfolio
勾选 Portfolio 级别角色（Trading Admin、Trader）时，勾选后会展开一个"Select portfolios for this role"的下拉框，需要手动搜索并勾选这个角色具体可以访问哪些 Portfolio；如果这个成员需要在多个 Portfolio 里都拥有该角色，可以在这里一次性多选
Step 3：Review & Confirm（确认信息）
核对邮箱地址、所选角色以及对应的 Portfolio 授权范围，确认无误后提交。
Step 4：Complete（邀请发出）
提交后，系统会向受邀人发送邀请邮件。受邀人需要接受邀请并完成账号注册，才能正式加入团队。在此之前，这条邀请会显示在 Team Members → Invitation 标签页下，可以在这里查看和管理。
四、管理已有成员和邀请中的成员
4.1 编辑或禁用已有成员
进入 Team Members 页面的 Members 标签，每位成员的 Role 列会列出他当前拥有的所有角色标签；Portfolio 级别的角色标签后面会带一个数字（例如 "Trading Admin·3"），表示这个角色被授权访问了 3 个 Portfolio。
列表上方支持按 Roles、Portfolios 筛选，也可以直接搜索成员邮箱。右侧可以 Edit（编辑角色和 Portfolio 授权范围）或 Disable/Enable（禁用/重新启用账号）。
4.2 管理邀请
进入 Invitation 标签，可以看到所有发出过的邀请及当前状态，并按需 Resend（重新发送）或 Cancel（撤销）尚未完成的邀请。