fix: 第1批 M1、M4~M6 登录密码统一规则与三类导出补列
Some checks failed
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Has been cancelled

- 七个设置登录密码入口统一 8~12 位、四类字符至少三类(1001/1016),修改密码与建店铺返回字段级提示
- 订单导出末列“操作人”、IoT 卡导出末列“套餐到期时间”、设备导出流量标 MB 并新增“设备合计(GB)”
- 历史导出任务按冻结表头识别新旧尾列,行宽不变
- OpenSpec Change fix-august-iteration-export-and-password-hints:10/12,5.3 前端同步与 5.4 测试部署导出验证待完成
This commit is contained in:
邹进
2026-10-11 23:41:40 +09:00
parent f56113ba55
commit 260fec7114
24 changed files with 462 additions and 37 deletions

View File

@@ -0,0 +1,57 @@
## ADDED Requirements
### Requirement: 订单导出包含操作人
系统 SHALL 在新建订单导出任务的最后一列增加“操作人”,取订单创建时冻结的 `operator_name`;字段缺失时输出空值,MUST NOT 以当前账号名称回填历史订单。
#### Scenario: 新任务导出订单操作人
- **WHEN** 用户新建订单导出任务
- **THEN** 表头最后一列为“操作人”
- **AND** 每行值与订单列表同一订单的 `operator_name` 口径一致
#### Scenario: 历史订单没有操作人快照
- **WHEN** 新任务导出一条 `operator_name` 为空的历史订单
- **THEN** “操作人”列为空且该订单仍被导出
### Requirement: IoT 卡导出包含最终套餐到期时间
系统 SHALL 在新建 IoT 卡导出任务的最后一列增加“套餐到期时间”,并复用卡列表的全部有效主套餐连续使用后的最终到期推算口径。只有推算状态为 `exact` 时输出时间,其他状态输出空值且 MUST NOT 阻断整项导出。
#### Scenario: 最终到期时间可精确推算
- **WHEN** 新任务导出的 IoT 卡存在可精确推算的最终套餐到期时间
- **THEN** 表头最后一列为“套餐到期时间”
- **AND** 该列输出与卡列表 `estimated_final_expires_at` 相同的时间事实
#### Scenario: 最终到期时间不可精确推算
- **WHEN** 新任务导出的 IoT 卡到期推算状态为待激活、无参与套餐或数据异常
- **THEN** “套餐到期时间”列为空且该卡仍被导出
### Requirement: 设备导出明确流量单位并提供 GB 合计
系统 SHALL 对新建设备导出任务将每张绑定卡的当前月使用流量和设备合计明确标注为 MB,并在最后一列额外返回“设备合计(GB)”。GB 合计 MUST 等于全部当前绑定卡 MB 使用量之和除以 1024,并保留两位小数。
#### Scenario: 新任务导出设备流量
- **WHEN** 用户新建设备导出任务
- **THEN** 动态卡列名为 `ICCIDn使用的流量(MB)`,MB 合计列名为“设备合计(MB)”
- **AND** 表头最后一列为“设备合计(GB)”
- **AND** GB 合计按 MB 合计除以 1024 后保留两位小数
#### Scenario: 无绑定卡的设备
- **WHEN** 新任务导出没有当前绑定卡的设备
- **THEN** 每张卡的动态列为空,MB 与 GB 合计均输出格式化的零值
### Requirement: 历史导出任务保持冻结表头
系统 MUST 继续使用导出任务创建时冻结的表头决定输出列;本次新增的列一律追加在最后一列,新增或重命名的列只适用于新任务;订单与设备导出按冻结表头反推卡列组数时 MUST 同时识别带与不带新增末列的表头,卡列不得缺失或错位;历史任务重新执行或下载时 MUST 保持原列名、原列数与行宽对齐。
#### Scenario: 重跑变更前创建的导出任务
- **WHEN** Worker 处理一个在本 Change 部署前已冻结表头的订单、IoT 卡或设备导出任务
- **THEN** 输出仍使用该任务冻结的旧表头和对应旧行宽
- **AND** 不插入本 Change 新增的列

View File

@@ -0,0 +1,62 @@
## ADDED Requirements
### Requirement: 登录密码统一长度与强度规则
系统设置或修改登录密码时 SHALL 统一要求:长度 8~12 位;只能由 ASCII 可见字符组成(不含空格、中文等);在大写字母、小写字母、数字、特殊符号四类中至少包含三类。规则 MUST 适用于以下全部入口:本人修改密码(`PUT /api/auth/password`)、后台创建账号与修改账号(含密码时)、后台修改账号密码、创建店铺的初始账号密码、新增企业客户与修改企业账号密码、代理扫码注册。长度或必填不满足时返回错误码 `1001`;字符种类不足或含不允许字符时返回错误码 `1016`(密码强度不足)。错误消息 MUST 指明规则,MUST NOT 回显密码。规则只在设置密码时校验,MUST NOT 影响登录:存量不符合新规则的密码照常登录,不强制修改。超级管理员操作密码、WiFi 密码与启动时按配置创建的系统管理员账号不适用本规则。
#### Scenario: 符合规则的密码
- **WHEN** 调用方在任一适用入口提交 `Abc12345`(大写、小写、数字三类,8 位)
- **THEN** 系统接受该密码
#### Scenario: 只有两类字符
- **WHEN** 调用方提交 `abcd1234`(小写、数字两类)
- **THEN** 系统返回错误码 `1016`,消息为“密码须包含大写字母、小写字母、数字、特殊符号中的至少三类”
- **AND** 不设置或修改密码
#### Scenario: 长度超出范围
- **WHEN** 调用方提交 7 位或 13 位的密码
- **THEN** 系统返回错误码 `1001`,消息指明密码长度须为 8~12 位
- **AND** 不设置或修改密码
#### Scenario: 含不允许的字符
- **WHEN** 调用方提交含空格或中文的密码
- **THEN** 系统返回错误码 `1016`,消息指明密码只能包含字母、数字和特殊符号
- **AND** 不设置或修改密码
#### Scenario: 存量弱密码登录
- **GIVEN** 账号现有密码为规则上线前设置的 6 位纯数字
- **WHEN** 该账号用原密码登录
- **THEN** 登录照常成功,不要求修改密码
### Requirement: 修改密码参数校验提示
系统 SHALL 在已认证调用方请求 `PUT /api/auth/password` 且请求字段未通过校验时,在响应消息中以“修改密码参数不合法:”开头,明确指出首个失败字段及其规则;长度与必填失败返回错误码 `1001`,强度不足返回 `1016`。响应消息 MUST NOT 回显旧密码、新密码或其他请求字段值。
#### Scenario: 新密码短于最小长度
- **WHEN** 已认证调用方提交非空旧密码和少于 8 位的新密码
- **THEN** 系统返回错误码 `1001`,消息为“修改密码参数不合法:新密码长度不能小于 8”
- **AND** 系统不校验旧密码是否正确且不修改密码
#### Scenario: 新密码超过最大长度
- **WHEN** 已认证调用方提交非空旧密码和超过 12 位的新密码
- **THEN** 系统返回错误码 `1001`,消息为“修改密码参数不合法:新密码长度不能超过 12”
- **AND** 系统不修改密码
#### Scenario: 新密码强度不足
- **WHEN** 已认证调用方提交非空旧密码和 8 位纯小写字母的新密码
- **THEN** 系统返回错误码 `1016`,消息为“修改密码参数不合法:新密码须包含大写字母、小写字母、数字、特殊符号中的至少三类”
- **AND** 系统不修改密码
#### Scenario: 必填密码字段缺失
- **WHEN** 已认证调用方提交的请求缺少旧密码或新密码
- **THEN** 系统返回错误码 `1001`,消息明确指出对应密码字段不能为空
- **AND** 系统不修改密码