国际课堂实时翻译与课件学习助手

当前账号中心参考成熟交易平台常见的分层方式，但针对学生课堂平台进行了简化：

1. 身份层：使用稳定的用户 ID 作为内部主键，学号只作为登录凭证；修改资料不会改变用户 ID。
2. 资料层：姓名、学校、专业、课程和语言偏好独立维护，不与密码和 Token 混在一起。
3. 安全层：密码只保存加盐哈希；每次浏览器登录都生成独立会话，可查看、单独退出或批量退出。
4. 偏好层：AI 模型、字幕和网络线路属于用户偏好，与账号安全分开。
5. 治理层：开发者可暂停或恢复账号，关键操作写入账号事件，便于排查问题。

POST /api/auth/register        注册新账号，可填写邮箱和手机号
POST /api/auth/login           登录，兼容学号 / 邮箱 / 手机号
POST /api/auth/password-reset/request   请求找回密码验证码
POST /api/auth/password-reset/confirm   验证验证码并重设密码
POST /api/auth/logout          退出当前设备
GET  /api/bootstrap            读取用户资料、偏好和登录设备
PUT  /api/me                   修改学生资料
POST /api/me/verification/request       请求邮箱或手机验证码
POST /api/me/verification/confirm       确认邮箱或手机号
GET  /api/me/security-events            读取账号安全事件
PUT  /api/me/password          修改密码并退出其他设备
GET  /api/me/sessions          读取登录设备
DELETE /api/me/sessions/:id    退出指定设备
POST /api/me/sessions/revoke-others 退出其他设备

除注册和登录外，用户接口都需要请求头：Authorization: Bearer <token>。

1. 先使用开发者密码解锁面板，开发者会话与普通用户会话相互独立。
2. 在“用户”分类查看账号状态、角色和活跃设备数。
3. 点击“暂停账号”会立即撤销该用户全部登录会话；点击“恢复账号”后用户可以重新登录。
4. 在“账号事件”分类核对是谁、在什么时候执行了什么账号操作。

PATCH /api/dev/users/:userId/status
Body: { "status": "active" | "suspended" }
PATCH /api/dev/users/:userId/access
Body: { "role": "student" | "beta_tester" | "assistant" | "admin",
        "userGroup": "default" | "internal_test" | "school_partner" | "paid_user" | "restricted" }
Headers: X-Dev-Panel-Token: <developer-token>

users[]
  id, studentId, email, phone, passwordHash
  role, userGroup, status, emailVerifiedAt, phoneVerifiedAt
  profile fields, aiSettings, modelConnections

tokens[]
  id, userId, token, clientName, ipAddress
  createdAt, lastSeenAt, expiresAt

securityTokens[]
  id, userId, type, target, codeHash
  createdAt, expiresAt, usedAt

accountEvents[]
  id, userId, type, summary, actorType, createdAt

当前内测版已经具备邮箱/手机号验证、找回密码、分组、权限和异常登录记录。正式部署时应接入真实邮件或短信服务，把会话和限流迁移到 Redis，并继续补充 MFA、隐私授权和操作日志保留策略。

1. 不得把密码、完整 Token 或 API Key 返回开发者列表。
2. 暂停账号、改密和退出设备都必须留下账号事件。
3. 用户状态判断必须放在后端中间件，不能只依赖前端隐藏按钮。
4. 新增角色时采用最小权限原则，不要让普通学生获得开发者接口权限。