跳到主要内容

第 8 期 · M1 完成:个人资料、登录设备与后台用户管理

· 阅读需 5 分钟

M1(账号)的最后一部分:用户可以管理自己的资料、密码、邮箱和登录设备,可以注销账号;管理员有了用户列表与审计日志。至此 M1 的范围全部交付,下一步进入 M2(材质与角色)。

本期完成​

  • 个人资料 /user/profile:昵称、语言偏好(只接受站点提供的语言,修 S04)、改密码、改邮箱(旧地址收到通知,新地址重新验证)。两者都要验证当前密码,改完后其它设备上的登录全部失效(修 S08)。
  • 登录设备:列出有效会话(浏览器、地址、最近活跃,当前设备排在最前),单独退出或一键退出其它设备。
  • 注销账号:软删除,30 天内用原密码登录即恢复,之后每小时的清理任务永久删除;管理员不能注销自己。
  • 后台用户管理 /admin/users:搜索、筛选、游标分页;改昵称、邮箱、积分、验证状态、密码、角色;封禁与解封;恢复已注销的账号;删除。权限规则集中在一个函数里,最后一个超级管理员在事务内受保护。
  • 审计日志 /admin/audit:按动作或前缀筛选,记录改了哪些字段与关键字段的前后值。
  • /.well-known/change-password 跳转到个人资料页。
  • 设计记录:ADR 0016 个人资料、设备管理、注销与后台用户管理。

本地实测(skinloom up --dev,log 邮件驱动)​

  1. 未登录访问 /user/profile → 跳到登录页,登录后回到资料页。
  2. 改昵称、把语言改成 English → 刷新后整站变成英文;之后发出的邮件也是英文。
  3. 另开两个"设备"(curl)登录同一账号 → 设备列表显示 3 个;单独退出其中一个;改密码时先输错(提示"密码不正确"),再输对 → 另一个设备的会话返回 401,列表只剩当前设备。
  4. 改邮箱 → 页头提示条变成新地址"未验证";日志里有发给旧地址的变更通知和发给新地址的验证链接。
  5. 超级管理员进入后台:搜索 player、封禁 Player2(同时改积分、标记已验证)→ Player2 已登录的会话立即 401,再登录返回 403;审计日志里能看到改了哪些字段和积分的前后值。
  6. 把 Player3 提升为管理员并用他登录:只能编辑普通用户,编辑表单里没有角色选项;直接调用接口封禁超级管理员、改角色、给自己升级、删除超级管理员,全部 403。
  7. 注销账号 → 回到首页并退出登录;后台显示"已注销";用原密码登录 → 状态恢复为正常,审计里依次是 account.deleted、account.restored。
  8. 普通用户访问 /admin/users 得到 404,调用管理接口得到 403。

实测中发现并修复:改密码后设备列表没有刷新(改为监听会话变化事件重新加载);当前设备有时排在后面(服务端排序)。复查时又补了两处:管理员给用户换邮箱后验证状态没有清除;管理员修改已注销账号的状态时没有清掉注销时间。

测试​

  • 账号服务(SQLite 与 PostgreSQL):资料与语言白名单、改密码(错误密码、短密码、其它会话失效、当前会话保留、错误次数限制)、改邮箱(大小写变化、地址占用、两封邮件、验证状态)、设备列表与退出(不能退出别人的会话)、注销(管理员不可、密码错误、宽限期内恢复、管理员恢复、过期后不能登录、清理后邮箱可重新注册)、后台(分页、搜索、筛选、全部权限规则、最后一个超级管理员、封禁即退出、换邮箱后的验证状态、审计记录)。
  • HTTP:/api/v1/me 全部接口(含 CSRF、未登录、管理员不能注销、注销后 Cookie 被清除)、后台用户与审计接口(403 / 404 / 409 的映射)。
  • 前端:类型检查、单元测试(含浏览器标识解析)、生产构建。
  • 全量回归:go test ./...(含 PostgreSQL 18)、go vet、staticcheck、govulncheck;ent、OpenAPI、TypeScript 客户端重新生成无差异;迁移与 schema 无漂移。

M1 回顾​

部分内容期
一安装向导、登录与会话、旧密码算法、三层登录限流、CSRF、审计表第 4 期
二注册、验证码(内置图形 / Turnstile / reCAPTCHA / hCaptcha)第 6 期
三任务队列、邮件、邮箱验证、找回密码第 7 期
四个人资料、登录设备、注销、后台用户管理、审计日志本期

验收项(设计文档 03):S01 可信代理、S02 重置链接、S03 验证链接、S04 语言参数、S05 用户枚举、S06 错误信息外泄、S08 改密后踢人、S15 密码长度均有测试覆盖。S07(皮肤库排序字段)属于皮肤库,随 M2 一起验收。

问题与风险​

  • 头像(需要材质渲染)、暗色模式偏好入库、积分流水表、BS 的搜索语法都留到 M2 及以后;在积分流水上线前,后台的积分修改只记在审计日志里。
  • 目前所有管理员都能修改站点设置(与 BS 一致)。自定义代码、插件等高风险设置上线时会限定为超级管理员(S09、S16)。
  • 后台删除用户是立即硬删除;等 M2 有了材质和角色,需要决定它们随用户删除还是转移。

下期计划​

M2 材质与角色:上传管线与存储、皮肤库(服务端渲染 + 游标分页)、材质详情页、衣柜、角色、积分与签到、举报、公告,以及 CustomSkinLoader / UniSkinMod / Legacy 接口。