75 lines
3.5 KiB
Markdown
75 lines
3.5 KiB
Markdown
## ADDED Requirements
|
||
|
||
### Requirement: Self-service password menu entry
|
||
|
||
系统 SHALL 在顶部用户菜单“个人中心”和“锁定屏幕”之间提供“修改密码”入口,点击后显示当前登录用户的修改密码弹窗,不跳转页面。
|
||
|
||
#### Scenario: 打开修改密码弹窗
|
||
|
||
- **WHEN** 当前登录用户点击顶部菜单“修改密码”
|
||
- **THEN** 系统 MUST 关闭用户菜单浮层并显示修改密码弹窗
|
||
- **AND** 弹窗 MUST 包含旧密码、新密码、确认新密码、取消及确认操作
|
||
- **AND** 输入 MUST 默认隐藏密码并支持切换可见
|
||
|
||
### Requirement: Password form validation
|
||
|
||
系统 SHALL 校验旧密码必填、新密码及确认新密码长度为 8–32 位且两次新密码一致,在校验通过前不得发送修改密码请求。系统 MUST NOT 自动裁剪或修改用户输入的密码,也不得对旧密码新增长度限制。
|
||
|
||
#### Scenario: 密码长度边界
|
||
|
||
- **WHEN** 新密码或确认新密码长度为 7 或 33 位
|
||
- **THEN** 表单 MUST 提示长度要求并阻止提交
|
||
- **AND** 长度为 8 或 32 位且其他校验通过时 MUST 允许提交
|
||
|
||
#### Scenario: 必填及一致性校验
|
||
|
||
- **WHEN** 任一密码字段为空,或者两次新密码不一致
|
||
- **THEN** 表单 MUST 展示对应字段错误并阻止提交
|
||
|
||
### Requirement: Unified authentication password contract
|
||
|
||
系统 SHALL 通过现有统一认证请求层调用 `PUT /api/auth/password`,请求体 MUST 仅包含 `old_password` 和 `new_password`,Bearer 认证 MUST 沿用当前登录会话,确认密码 MUST NOT 发送到服务端。
|
||
|
||
#### Scenario: 提交有效表单
|
||
|
||
- **WHEN** 用户提交通过校验的密码表单
|
||
- **THEN** 系统 MUST 发送旧密码至 `old_password`、新密码至 `new_password`
|
||
- **AND** 请求方法 MUST 为 PUT,请求路径 MUST 为 `/api/auth/password`
|
||
- **AND** 请求 MUST 沿用现有请求层的 Bearer 认证
|
||
|
||
### Requirement: Password submission lifecycle
|
||
|
||
系统 SHALL 在提交期间提供加载状态并阻止重复提交;成功后提示、关闭弹窗并清空敏感字段及记住密码凭证;普通失败时保留弹窗并展示后端错误;认证过期 MUST 沿用现有请求层处理。成功后系统 MUST NOT 主动退出登录或改变锁屏密码。
|
||
|
||
#### Scenario: 重复点击提交
|
||
|
||
- **WHEN** 修改密码请求尚未完成时用户再次确认
|
||
- **THEN** 系统 MUST 保持加载状态且不得发送重复请求
|
||
|
||
#### Scenario: 修改成功
|
||
|
||
- **WHEN** 修改密码请求成功
|
||
- **THEN** 系统 MUST 提示成功并关闭弹窗
|
||
- **AND** 系统 MUST 清空全部密码字段及保存的旧登录凭证
|
||
- **AND** 系统 MUST 保留当前登录状态,不修改锁屏密码
|
||
|
||
#### Scenario: 修改失败
|
||
|
||
- **WHEN** 接口返回普通错误,如旧密码错误或服务器错误
|
||
- **THEN** 系统 MUST 通过现有请求层展示错误并保留弹窗
|
||
- **AND** 系统 MUST 解除提交中状态以允许用户更正后重试
|
||
|
||
#### Scenario: 取消后重新打开
|
||
|
||
- **WHEN** 用户取消或关闭弹窗后重新打开
|
||
- **THEN** 所有密码字段及校验状态 MUST 为空
|
||
|
||
### Requirement: Password dialog interface consistency
|
||
|
||
修改密码弹窗 SHALL 复用现有 Element Plus 组件和主题,支持中英文、键盘操作及窄屏展示,密码输入 MUST 具备可识别标签和可见校验反馈。
|
||
|
||
#### Scenario: 窄屏及键盘操作
|
||
|
||
- **WHEN** 用户在窄屏设备或通过键盘打开弹窗
|
||
- **THEN** 弹窗 MUST 不产生水平溢出,且可访问全部输入、取消及确认操作
|