> ## Documentation Index
> Fetch the complete documentation index at: https://developers.uqpay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 团队（成员与角色管理）

> 商户后台「设置 > 团队」页，分「成员」和「角色」两个标签，用于邀请/编辑/移除团队成员、给成员分配角色，以及查看和管理角色权限（新建/编辑角色见 create-role 页）。

## 这是什么

这是商户后台「**设置**」下的「**团队**」页面（页面标题「团队」，副标题「管理团队成员和角色」）。页面顶部分「**成员**」和「**角色**」两个标签：在「成员」标签邀请同事加入、查看成员及待接受邀请、编辑成员姓名与角色、移除成员；在「角色」标签查看账户下的角色、查看每个角色的权限、把角色分配给成员、删除自定义角色。想给同事开后台账号、调整谁能访问哪些功能、看某个角色有哪些权限时都从这里操作。新建或编辑角色的完整表单在单独的「创建角色 / 编辑角色」页，本页负责管理成员与角色列表。

## 操作步骤

进入团队页：

1. 左侧导航进入「**设置**」→「**团队**」。
2. 顶部在「**成员**」和「**角色**」两个标签间切换。

**邀请新成员**（「成员」标签）：

1. 点右上角「**邀请成员**」。
2. 在弹窗填「**名字**」「**姓氏**」「**电子邮箱**」，并在「**角色**」下拉选一个角色。
3. 若账户开启了成员操作二次验证，还需填 6 位「**双重身份验证代码**」。
4. 点「**发送邀请**」。成功后提示「邀请已发送」，对方会收到邀请邮件，需自行接受后才正式加入。

**搜索与筛选成员**：用列表上方「搜索成员」按姓名或邮箱搜；用「**按角色筛选**」只看某个角色的成员。已生效的筛选会在「**筛选条件**」区以标签显示，点标签上的「×」移除单项，或点「**全部清除**」清空。

**编辑成员**：在某位成员行末尾「**⋯**」菜单选「**编辑成员**」，可改名字、姓氏和角色（**电子邮箱不可修改**），点「**保存修改**」。

**移除成员**：在成员行「**⋯**」菜单选「**移除**」，弹窗确认（开启二次验证时需填验证码）后点「移除」。此操作无法撤销。

**处理待接受的邀请**：尚未被接受的邀请会以单独一行出现在成员列表里，状态显示「**待接受**」或「**已过期**」。在该行「**⋯**」菜单可「**重新发送邀请**」（已过期的显示「再次发送」）或「**撤销邀请**」。撤销后对方原邀请链接失效。

**查看与管理角色**（「角色」标签）：

1. 切到「**角色**」标签，列表显示账户下所有角色。
2. 点某一行打开「角色详情」，查看该角色的成员数、类型和已授予的权限。
3. 在角色行「**⋯**」菜单可「**分配**」（把该角色分配给选中的成员）；**自定义**角色还可「**编辑角色**」「**删除角色**」。
4. 新建角色：点右上角「**添加角色**」进入创建角色页。

## 字段与状态含义

**成员列表列：**

| 列    | 含义（商户视角）                                 |
| ---- | ---------------------------------------- |
| 成员   | 成员姓名 + 邮箱                                |
| 角色   | 成员当前所属角色；账户主显示「所有者」徽标                    |
| 加入时间 | 成员加入日期；待接受的邀请行显示「已邀请 + 日期」               |
| 状态   | 成员当前状态，见下；待接受的邀请行显示「待接受」或「已过期」           |
| 最后登录 | 成员最近登录时间，从未登录显示「从未」；待接受的邀请行显示「有效期至 + 日期」 |

**成员状态：**

| 状态  | 含义        |
| --- | --------- |
| 活跃  | 成员正常、账号可用 |
| 待处理 | 成员待处理     |
| 已暂停 | 成员已被暂停    |

**待接受邀请的状态：**

| 状态  | 含义                 |
| --- | ------------------ |
| 待接受 | 邀请已发出、对方尚未接受，在有效期内 |
| 已过期 | 邀请已超过有效期，需重新发送     |

**成员数据条**：列表上方有「**总计 / 活跃 / 待处理**」三个计数，反映当前成员构成。

**角色列表列：**

| 列    | 含义（商户视角）      |
| ---- | ------------- |
| 角色   | 角色名称          |
| 类型   | 「系统」或「自定义」，见下 |
| 成员   | 当前拥有该角色的成员数   |
| 最后修改 | 该角色最近一次修改的时间  |

**角色类型：**

| 类型  | 含义                     |
| --- | ---------------------- |
| 系统  | 平台预设角色，可分配给成员，但不能编辑或删除 |
| 自定义 | 你自建的角色，可编辑、删除，也可分配给成员  |

> 「**所有者**」是账户主身份，不能通过邀请或编辑赋予他人，也不会出现在邀请/编辑成员的角色下拉里。

**角色详情面板**：显示角色名称、类型（系统/自定义）、成员数、描述（若有），以及该角色已授予的权限——权限按模块分组，每个模块标注「**完全访问**」（该模块权限全给）或「**部分访问**」（只给了部分），并显示「已授权 N 项」。

## 边界与常见处理

* **看不到「邀请成员」按钮 / 邀请入口**：需要团队管理权限，没权限时该按钮不显示；请让账户管理员分配权限。
* **看不到某位成员行的「⋯」操作菜单**：所有者行不提供编辑/移除操作；此外编辑和移除需团队写权限。
* **邮箱格式不对无法发送**：邀请邮箱格式不合法时会提示「请输入有效的邮箱地址」并禁用「发送邀请」，改成正确邮箱即可。
* **成员一直是「待接受」**：对方还没点邮件里的邀请接受，可在该行「⋯」菜单「重新发送邀请」；显示「已过期」的用「再次发送」重发。
* **想收回一个还没被接受的邀请**：在待接受邀请行「⋯」菜单选「撤销邀请」，撤销后原邀请链接失效。
* **邀请/编辑/移除时要求填 6 位验证码**：账户开启了成员操作二次验证，需输入 6 位双重身份验证代码才能完成操作。
* **某个角色的「编辑角色 / 删除角色」是灰的或没有**：系统角色不能编辑或删除，只有自定义角色可以；且需要角色写权限。
* **删除角色时提示会影响成员**：若该角色已分配给若干成员，删除后这些成员会失去与该角色绑定的访问权限；若无人使用则提示「此操作不可撤销」。
* **角色详情里「暂无权限数据」**：该角色当前没有可展示的权限。

## 常见问法（Q→A）

* **Q：怎么邀请同事加入 / 给同事开后台账号？** A：设置 > 团队 >「成员」标签，右上角「邀请成员」，填姓名、邮箱、选角色后点「发送邀请」，对方接受邀请即加入。
* **Q：邀请成员在哪里操作？需要填什么？** A：在「团队」页「成员」标签点「邀请成员」，填名字、姓氏、电子邮箱并选一个角色；若账户开了二次验证还要填 6 位验证码。
* **Q：邀请发出去对方没收到 / 一直没接受怎么办？** A：该邀请在成员列表里显示「待接受」，在其行「⋯」菜单选「重新发送邀请」；若显示「已过期」，用「再次发送」重发。
* **Q：怎么取消 / 撤销一个已发出的邀请？** A：在待接受邀请行「⋯」菜单选「撤销邀请」并确认，撤销后原邀请链接失效。
* **Q：怎么改一个成员的角色？** A：在该成员行「⋯」菜单选「编辑成员」，在「角色」下拉换成目标角色后「保存修改」；也可在「角色」标签用「分配」把角色批量分给成员。
* **Q：能改成员的邮箱吗？** A：不能，编辑成员时邮箱只读不可修改，只能改姓名和角色。
* **Q：怎么把一个人移出团队？** A：在该成员行「⋯」菜单选「移除」并确认；此操作无法撤销。
* **Q：为什么「所有者」不能被移除或改角色？** A：所有者是账户主身份，不提供编辑/移除操作，也不能通过邀请或编辑赋予他人。
* **Q：成员状态有哪些？** A：活跃、待处理、已暂停；待接受的邀请另显示「待接受」或「已过期」。
* **Q：系统角色和自定义角色有什么区别？** A：系统角色是平台预设、可分配但不能编辑或删除；自定义角色是你自建的，可编辑、删除、分配。
* **Q：怎么新建一个角色 / 自定义权限？** A：在「角色」标签右上角点「添加角色」进入创建角色页设置名称和权限。
* **Q：怎么看某个角色有哪些权限？** A：在「角色」标签点该角色行打开角色详情，权限按模块分组，标注「完全访问」或「部分访问」并显示已授权项数。
* **Q：怎么把一个角色分配给多个成员？** A：在「角色」标签该角色行「⋯」菜单选「分配」，搜索并勾选成员后点「分配」。
* **Q：删除一个角色会影响什么？** A：若该角色已分配给成员，删除后这些成员会失去与该角色绑定的访问权限；确认框会提示受影响成员数。
* **Q：为什么有的角色不能删 / 不能编辑？** A：系统角色不可编辑或删除，只有自定义角色可以，且需具备角色写权限。