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