feat: 支持管理员自助修改密码 (#57)

2026-08-09 16:49:28 +08:00
parent 2cbb98f09c
commit 008bb87620
12 changed files with 446 additions and 19 deletions
@@ -681,6 +681,27 @@ placeholder 写「任务编号 / 订单号 / 商品 ID」，**不要写全「PDD
 - 不能禁用最后一个有效管理员，也不能让唯一管理员禁用自己。
 - 完整密码不在列表、弹窗关闭后的页面或日志中出现。

+### 8.3 管理员修改自己的密码
+
+已登录管理员的顶部账号区域显示“修改密码”，采购员不显示该入口。点击后打开公共弹窗：
+
+```text
+修改我的密码
+当前密码   [••••••••••••••••]
+新密码     [••••••••••••••••]
+确认新密码 [••••••••••••••••]
+[取消] [修改密码]
+```
+
+- 必须校验当前密码；目标用户只取当前 Session，不接受表单传入用户编号。
+- 新密码至少 6 个字符、最多 72 个字节，两次输入必须一致。
+- 当前密码使用 `autocomplete="current-password"`，新密码和确认密码使用
+  `autocomplete="new-password"`。
+- 校验失败时不回显三个密码，自动重新打开弹窗，在对应字段旁显示错误并聚焦该字段。
+- 修改成功后撤销该管理员在所有浏览器中的 Session、清除当前 Cookie，并跳转登录页要求使用新密码登录。
+- 采购员仍由管理员在用户管理页重置密码；本阶段不提供采购员自助改密和忘记密码入口。
+- 弹窗继续遵守公共关闭规则：取消、关闭按钮、Esc 和直接点击遮罩可关闭，从密码框拖选到遮罩不会误关闭。
+
 ## 9. 反馈方式

 | 场景 | 怎么反馈 |
@@ -29,7 +29,7 @@
 - SKU 映射复用：第二次匹配同一 SKU 应自动带出；
 - 在线状态派生：`last_seen_at` 刚好在边界前后。
 - 密码哈希校验：正确密码成功，错误密码失败，数据库不出现明文密码；
- 密码长度边界：5 个字符拒绝、6 个字符接受；初始化、创建和重置规则一致；
+- 密码长度边界：5 个字符拒绝、6 个字符接受；初始化、创建、重置和管理员自助修改规则一致；
 - 角色校验：管理员可以管理用户，采购员访问用户管理返回 `403`；
 - 最后管理员保护：不能禁用最后一个有效管理员。
 - 客户端归属：一人多客户端、一台客户端唯一当前负责人、转交/解绑历史完整；
@@ -107,13 +107,14 @@
 - `[建议]` MVP 只监听 `127.0.0.1`，不对外暴露。要给内网用再单独评估。
 - `[必须]` 不提供固定默认密码和公开注册；第一位管理员由用户首次初始化。
 - `[必须]` 密码使用成熟算法哈希，禁止自创加密、明文保存或可逆加密。
- `[必须]` 密码最少 6 个字符、最多 72 个字节；初始化、创建采购员、重置密码
+- `[必须]` 密码最少 6 个字符、最多 72 个字节；初始化、创建采购员、重置密码、管理员自助修改
  的服务端校验和 HTML 表单约束保持一致。
 - `[必须]` 首次管理员创建必须在数据库写事务中完成，并发请求最多一个成功。
 - `[必须]` 登录成功后使用新的随机 Session Token，数据库只保存其 SHA-256 哈希。
 - `[必须]` 登录 Cookie 设置 `HttpOnly`、`SameSite=Lax`、`Path=/`；HTTPS 部署时设置 `Secure`。
- `[必须]` Session 默认 12 小时过期；退出、密码重置和账号禁用立即撤销对应 Session。
- `[必须]` `/setup`、`/login`、`/logout` 和用户管理写操作都保留 CSRF 防护。
+- `[必须]` Session 默认 12 小时过期；退出、密码重置、管理员自助修改密码和账号禁用立即撤销对应 Session。
+- `[必须]` 管理员自助修改密码必须验证当前密码，目标账号从当前 Session 取得；成功后撤销该账号全部 Session 并重新登录。
+- `[必须]` `/setup`、`/login`、`/logout`、`/account/change-password` 和用户管理写操作都保留 CSRF 防护。
 - `[必须]` 客户端绑定、转交、解绑和删除只能由管理员执行，并保留 CSRF 防护。
 - `[必须]` Web 登录中间件只保护 HTML 路由，不得覆盖 `/api/v1/client/*`。
 - `[建议]` 对连续登录失败做简单限速；错误提示不区分用户名不存在和密码错误。