# 平台管理与权限

用户、管理员、账户状态和操作审计。

## 三类平台角色 [#三类平台角色]

普通用户使用开发者控制台。运营管理员处理申请、发布、工单和商务需求，也可查看账户目录。超级管理员额外拥有用户启用/停用、平台角色修改和会话撤销权限。

平台角色与工作空间 owner / developer / viewer 相互独立。拥有自己工作空间的 owner 角色，不代表可以管理整个平台。

## 首位超级管理员与登录 [#首位超级管理员与登录]

管理员使用已有账户[登录控制台](/login)。开放平台暂未开放自助注册，接入需求可通过[商务联系页](/contact)提交。

**第一个注册账户自动成为超级管理员**，可以直接打开[用户管理](/admin/users)。后续注册账户默认是普通用户，不能通过注册字段自行取得管理权限。

已有账户的项目在运行 `pnpm run setup` 时，按最早注册账户执行一次初始化。初始化标记会持久保存；后续注册、重启和再次 setup 不会重复分配首位权限。

## 委派与维护 [#委派与维护]

超级管理员在用户管理页找到目标账户，将平台角色调整为“超级管理员”，即可委派管理权限。对方旧会话会被撤销，需要重新登录。也可以将用户调整为运营管理员或普通用户，但不能通过此页修改自己的角色。

可信本机维护人员可使用以下恢复命令，提升指定的已注册账户：

```bash
pnpm admin your-registered-email@example.com
```

平台不提供默认管理员密码，不能查询用户密码或找回 Key 明文。

## 用户管理 [#用户管理]

支持按姓名或邮箱搜索，按启用状态和角色筛选，分页显示注册时间、工作空间数量和有效会话数量。

停用账户会撤销其会话和由其创建的 API Key。再次启用不会自动恢复已撤销的 Key。修改角色也会撤销旧会话，要求重新登录。

不能通过用户管理修改自己的权限或停用自己；不能移除最后一位有效超级管理员。操作记录保存在内部审计中。

## 上线要求 [#上线要求]

管理权限必须在服务端校验。平台已提供验证器 TOTP 和恢复码流程，但未自动强制所有管理员启用。生产前应为管理员完成启用与验收，并配置受控访问入口；首次注册、角色委派、停用与恢复也需实际验收。
