This commit is contained in:
luo
@@ -2,9 +2,9 @@
|
||||
|
||||
## Context
|
||||
|
||||
本仓库为 Vue 3/TypeScript 后台，HTTP 服务使用 `BaseService` 与 Axios，页面已有业务权限、状态映射、详情组件、异步导入导出任务。用户明确排除所有 C 端接口和页面。后台本人改密虽然使用 `/api/auth/password`，仍属于本次后台适配。
|
||||
本仓库为 Vue 3/TypeScript 后台，HTTP 服务使用 `BaseService` 与 Axios，页面已有业务权限、状态映射、详情组件、异步导入导出任务。原范围排除 C 端；2026-10-14 用户追加代理扫码注册页及同一注册接口的密码校验，其余 C 端接口和页面仍排除。后台本人改密虽然使用 `/api/auth/password`，仍属于本次后台适配。
|
||||
|
||||
本设计依据十月第 1 批说明、用户最新确认和当前代码。用户确认不提供最新 OpenAPI，不以该文件作为实施前置条件；新密码禁止特殊符号的确认优先于原说明。实施已获批准，代码与本地模拟页面验证详见实施记录；没有调用真实后台写接口或验证后端运行行为。
|
||||
本设计依据十月第 1 批说明、用户最新确认和当前代码。用户确认不提供最新 OpenAPI；2026-10-14 修正为新密码允许特殊符号，恢复四类至少三类。实施已获批准，结果详见实施记录，没有调用真实后台写接口。
|
||||
|
||||
### 代码证据与修改路径
|
||||
|
||||
@@ -24,7 +24,7 @@
|
||||
## Goals / Non-goals
|
||||
|
||||
- Goals：让后台显示、筛选、请求字段和可执行操作符合本批次说明；保留既有权限、表单内容、财务快照和导入导出流程。
|
||||
- Non-goals：C 端适配、后台接口实现、新审批机制、新页面架构、自动解绑手机号、前端重算预警或余额、替换设备导入模板、引入测试框架。
|
||||
- Non-goals：除代理扫码注册密码规则外的 C 端适配、后台接口实现、新审批机制、新页面架构、自动解绑手机号、前端重算预警或余额、替换设备导入模板、引入测试框架。
|
||||
|
||||
## Decisions
|
||||
|
||||
@@ -46,9 +46,11 @@
|
||||
|
||||
### 3. 新密码校验专用化
|
||||
|
||||
新增/复用新登录密码专用工具，避免直接改通用 `validatePassword` 或 `validateStrongPassword` 影响非登录密码。按用户最新确认，长度 8～12，仅允许 ASCII 英文字母和数字，并必须同时包含大写字母、小写字母和数字；所有特殊符号、空白、中文、emoji 和其他非英文字母数字字符均拒绝。不对输入静默 `trim` 后放行。
|
||||
使用新登录密码专用工具，避免影响通用校验与其他密码。按最新修正，长度 8～12，允许英文字母、数字及所有可打印半角 ASCII 符号，四类至少三类；空白、中文、emoji、控制字符和非 ASCII 字符拒绝。不静默 trim。
|
||||
|
||||
实现判定为 `^[A-Za-z0-9]{8,12}$` 且同时满足 `[A-Z]`、`[a-z]`、`[0-9]` 三个包含条件。例如 `Abc12345` 可接受，`abcd1234` 因缺少大写拒绝，`Abc1234!` 即使包含大写、小写和数字也因特殊符号拒绝。
|
||||
字符范围为 ASCII `0x21～0x7E`，按大写、小写、数字和标点四类计数，至少三类。`Admin@12345`、`ABC1234!`、`abc1234!`、`Abcdefg!` 均有效；`abcd1234`、`ABCDEF!!` 仅两类无效。
|
||||
|
||||
顶栏 `z-index:100`、侧栏 `z-index:101` 导致嵌在顶栏内的改密遮罩被侧栏压住。仅给改密弹窗加 `append-to-body`，不全局提高顶栏层级或修改所有弹窗；由 Element Plus 管理完整遮罩、焦点和关闭行为。
|
||||
|
||||
新密码和确认密码统一长度限制、规则说明与一致性校验；本人改密 `old_password` 不设新规则的 `maxlength` 或类别限制，旧登录表单不收紧。账号编辑目前没有密码输入则不新增；若既有调用传递可选 `password`，仅非空新值需要校验，未修改密码时不发送空串。
|
||||
|
||||
@@ -64,6 +66,12 @@
|
||||
| 创建企业 | `POST /api/admin/enterprises` | `password` |
|
||||
| 修改企业密码 | `PUT /api/admin/enterprises/{id}/password` | `password` |
|
||||
|
||||
用户明确追加的公开代理注册使用原 `POST /api/c/v1/agent-distribution-registrations` 和 `password` 字段。表单复用 `createNewLoginPasswordRule()`，注册服务发送前复用 `getNewLoginPasswordError()`；保留其他入参和 `withToken: false`。页面将输入上限改为 12，完整规则独立显示在输入框下，并关联 `aria-describedby`，避免移动端 placeholder 截断规则。强度反馈仅按共享校验判定合格/未合格，空格和中文不能被计作有效特殊符号；长错误文案参与正常布局，不覆盖下一个表单项。
|
||||
|
||||
用户进一步追加注册失败反馈：仅 `registerAgent` 请求设 `errorMessageMode: 'none'`，页面处理非零业务响应与 HTTP 异常。1050/1001 不暴露企业微信模板配置细节，统一「注册失败, 请联系管理员」，其余错误保留具体业务原因或正常网络降级；不记录密码或完整错误对象。提交进行中阻止再次提交，失败保留表单。公共 HTTP、短信与其他服务的错误提示保持原状。
|
||||
|
||||
公共表头 Sortable 报错作为既有列设置功能的生命周期修复：改用 `useDraggable(..., { immediate: false })` 和真实 `HTMLElement` ref，仅在列设置 Popover 已打开且进入后，目标仍连接文档时启动；关闭、卸载及 KeepAlive 停用销毁实例，晚到回调不得重新启动。列排序仍通过原 `columns` model 写回，勾选状态和其他表头功能不变。
|
||||
|
||||
错误消息兼容项目既有 `msg` 与说明中的 `message`，优先展示后端提供的可读字段级原因；不改变 401 等既有统一处理，不重复弹错、不输出密码值。
|
||||
|
||||
### 4. 换货 1202 定向错误处理
|
||||
@@ -95,7 +103,7 @@ CSV 只同步新表头和手机号说明，不为旧表头做客户端转换、
|
||||
## Risks / Trade-offs
|
||||
|
||||
- 无最新 OpenAPI：按用户确认，以第 1 批说明实施，不要求补文件；联调发现真实接口与说明不符时先反馈，不自行猜测或声称已通过联调。
|
||||
- 密码口径覆盖原说明：用户明确禁止特殊符号，前端不得按原「四类至少三类」放行含符号的新密码；如后端实际校验与该确认冲突，先反馈用户。
|
||||
- 密码口径以最新修正为准：允许半角特殊符号并按四类至少三类校验；如后端字符集合仍有不同约束，联调时反馈用户。
|
||||
- 恢复旧规范与新业务终态冲突：文档注明差异，实施时优先按本批次终态处理，结果未知继续守原恢复规则。
|
||||
- 改错密码/流量范围：专用新密码工具和独立规则/套餐类型限制修改范围，回归旧密码、操作密码、WiFi 密码、套餐额度。
|
||||
- 换货错误提示重复或泄漏号码：两个请求定向接管提示，共享处理器保留其他错误行为，删除受影响分支的完整错误输出。
|
||||
@@ -111,7 +119,7 @@ CSV 只同步新表头和手机号说明，不为旧表头做客户端转换、
|
||||
## 已确认事项
|
||||
|
||||
1. 没有最新 `admin-openapi.yaml`，不要求提供，以第 1 批说明实施。
|
||||
2. 新密码 8～12 位，仅允许英文字母和数字，且大写、小写和数字均必需，不允许特殊符号。
|
||||
3. 所有 `/api/c/v1` 和 C 端页面排除；后台代理注册失败仅展示重新扫码申请指引，不代发 C 端申请。
|
||||
2. 新密码 8～12 位，大写、小写、数字、半角特殊符号至少三类，禁止空白和中文。
|
||||
3. 用户明确追加的代理扫码注册密码规则纳入；其他 `/api/c/v1` 和 C 端页面排除。后台代理注册失败仍仅展示重新扫码申请指引，不代发 C 端申请。
|
||||
|
||||
当前没有待确认的需求问题。用户已批准实施，后台代码已适配；真实后端联调项继续在任务清单保留未完成状态。
|
||||
|
||||
Reference in New Issue
Block a user