34 lines
2.3 KiB
Markdown
34 lines
2.3 KiB
Markdown
## Context
|
||
|
||
头像菜单位于 `src/components/core/layouts/art-header-bar/index.vue`，当前“个人中心”通过路由跳转，“锁定屏幕”通过事件打开。`AuthService.changePassword` 已封装 `PUT /api/auth/password`，但当前 TypeScript 参数 `ChangePasswordParams` 使用 `oldPassword`、`newPassword`、`confirmPassword`，与 OpenAPI 的 `old_password`、`new_password` 不一致。HTTP 层只序列化 JSON，不会将 camelCase 自动转换成 snake_case。
|
||
|
||
## Goals / Non-Goals
|
||
|
||
- Goals: 提供头像菜单入口和简单的自助修改密码流程；遵循给定 OpenAPI 请求契约；不增加权限编码或权限判断。
|
||
- Non-Goals: 修改后端接口、增加路由、改变锁屏行为、增加权限管理配置。
|
||
|
||
## Decisions
|
||
|
||
- Decision: 使用头像菜单中的对话框承载表单，不为此功能新增页面路由。入口依次位于个人中心、修改密码、锁定屏幕。
|
||
- Decision: 表单收集当前密码、新密码和确认密码；确认密码仅用于客户端一致性校验，提交时仅构造 `{ old_password, new_password }`。
|
||
- Decision: 将 API DTO 类型调整为精确表达 OpenAPI 的 snake_case 字段，避免依赖 HTTP 层不存在的字段转换。
|
||
- Decision: 所有已登录用户均可见并可操作该入口，不使用 RBAC、按钮权限或菜单权限配置进行隐藏/拦截；API 请求仍携带现有 Bearer Token。
|
||
- Decision: 接口成功时清空敏感表单数据、提示成功，再调用 `userStore.clearLocalState()` 清除旧 token 并跳转登录页；接口失败时展示错误反馈，不记录密码值。
|
||
|
||
## Risks / Trade-offs
|
||
|
||
- 当前类型与接口字段不一致，直接复用旧 camelCase 参数会发送错误字段；以 DTO 对齐及请求验证覆盖此风险。
|
||
- 密码策略细节未在给定 OpenAPI 中定义；本次不自行新增密码复杂度规则，沿用后端校验结果并反馈错误。
|
||
|
||
## Migration Plan
|
||
|
||
无需数据迁移或后端变更。前端发布后，已登录用户可从头像菜单使用入口；回滚时可移除菜单项及对话框实现。
|
||
|
||
## Open Questions
|
||
|
||
- None.
|
||
|
||
## Session Handling
|
||
|
||
After a successful password change, clear the current client authentication state with `userStore.clearLocalState()` and redirect to the login route. Do not attempt the logout API after changing the password because the old token may already be invalid.
|