fix: 第1批 M1、M4~M6 登录密码统一规则与三类导出补列
Some checks failed
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Has been cancelled
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:
@@ -0,0 +1,2 @@
|
||||
schema: spec-driven
|
||||
created: 2026-10-11
|
||||
@@ -0,0 +1,47 @@
|
||||
## Context
|
||||
|
||||
M1、M4~M6 原写在 `fix-august-iteration-follow-up-gaps`,改写该 Change 为第 1 批缺陷时移出;2026-10-11 确定并入第 1 批,单独成本 Change。现状已核对:
|
||||
|
||||
- `ChangePasswordRequest`(`internal/model/dto/auth_dto.go:50`)校验为 `required` 与 `min=8,max=32`,Handler 校验失败只返回“参数验证失败”,字段与规则被丢弃。
|
||||
- 设置登录密码的入口规则不一且无强度要求:本人改密码、后台账号创建/修改/改密码、建店铺初始密码为 8~32;企业客户新增与改密码为 6~20;代理注册为 6~64(`internal/domain/distribution/distribution.go:67`)。错误码 `1016`(`CodePasswordTooWeak`)已定义但未使用。
|
||||
- `customer_account_dto.go`、`shop_account_dto.go` 中的建账号与改密码 DTO 没有任何调用方,不在本次范围。
|
||||
- 订单导出表头有“店铺”无“操作人”(`internal/exporter/order_scene.go`),订单列表已有冻结的 `operator_name`。
|
||||
- IoT 卡导出无到期列;卡列表最终到期由 `packageexpiry.Query.ResolveBatch`(`internal/query/packageexpiry/query.go:41`)推算。
|
||||
- 设备导出表头为 `ICCIDn使用的流量`、“设备合计”(`internal/exporter/device_scene.go:378`),数值实为 MB,未标单位。
|
||||
- 导出任务创建时冻结 `ResolvedHeaders`,Worker 按冻结表头生成行。
|
||||
|
||||
## Goals / Non-Goals
|
||||
|
||||
**Goals:** 设置登录密码的入口统一长度与强度规则;修改密码失败消息直接说明字段与规则;三类导出补齐核对字段与单位;历史任务列不错位。
|
||||
|
||||
**Non-Goals:** 不强制存量弱密码修改,不改登录校验;不改超级管理员操作密码与 WiFi 密码;不改订单与支付写入、到期推算口径;不改前端;无迁移。
|
||||
|
||||
## Decisions
|
||||
|
||||
1. **修改密码复用 `internal/handler/validation.Message`。** 为请求字段补中文 `description`,Handler 返回“修改密码参数不合法:”加字段级消息;错误码、HTTP 状态和校验顺序不变。与项目已有中文校验提示约定一致,不在 Handler 内硬编码 validator 分支。
|
||||
2. **订单“操作人”取冻结的 `operator_name`,追加在最后一列。** 不回查当前账号名称;是否输出以任务 `ResolvedHeaders` 是否含“操作人”为准。
|
||||
3. **卡“套餐到期时间”按分页批量推算,追加在最后一列。** 每页调用一次 `ResolveBatch`,禁止逐卡查询;只有 `exact` 输出 `estimated_final_expires_at`,其余留空。
|
||||
4. **设备流量数值不变,只改表头并加 GB 列。** 新任务表头改为 `ICCIDn使用的流量(MB)`、“设备合计(MB)”,在最后一列(“关联手机号”之后)加“设备合计(GB)”,值为 MB ÷ 1024 保留两位小数;历史任务按冻结表头输出旧列名与旧列数。
|
||||
|
||||
5. **密码规则集中在一个函数,在服务层哈希前调用。** `pkg/validator` 新增登录密码规则函数,依次判断:长度 8~12(`1001`)→ 只含 ASCII 可见字符且无空格(`1016`)→ 大写、小写、数字、特殊符号四类至少三类(`1016`)。各入口在 `bcrypt.GenerateFromPassword` 前调用;DTO 标签同步改为 `min=8,max=12` 供文档与早期拦截。不只靠 DTO 标签,因为项目存在多个独立 `validator.New()` 实例,且代理注册在领域层自行校验,集中函数能保证口径一致。
|
||||
6. **启动时的系统管理员不校验。** `CreateSystemAccount`(`internal/bootstrap/admin.go:51`)按配置创建,校验会让配置弱密码的环境无法启动;该账号上线后改密码走本人改密码入口,受新规则约束。
|
||||
7. **长度上限 8~12 位为业务确认值。** 现有 8~32 位的密码超过 12 位的可继续登录,只在下次修改时受限。
|
||||
|
||||
5. **新列一律追加在最后(2026-10-11 确认)。** 与项目既有做法一致(IoT 卡导出注释:“「关联手机号」固定追加在尾部”)。原因:分片按位置把行截齐到冻结表头(`internal/task/export_common.go` 的 `alignRowsToHeaders`),新代码上线前派发、上线后执行的任务只会少最后一列,插在中间则后面各列整体错位。订单与设备导出的卡列是动态的,组数靠表头反推:订单为(总列数 − 固定列数)÷ 2(`orderCardGroupCountFromHeaders`),设备为按尾部固定列数(现为 6,旧为 5)反推(`cardGroupCountFromHeaders`)。追加末列后须先按末列表头是否为“操作人”/“设备合计(GB)”识别新旧表头再反推,否则卡列组数算错或为 0。
|
||||
|
||||
## Risks / Trade-offs
|
||||
|
||||
- [前端提示与后端规则不一致] → 任务中单列前端同步,测试环境联调确认。
|
||||
- [12 位上限压低可用强度] → 业务已确认;规则集中在一个函数,后续放宽只改一处。
|
||||
|
||||
- [批量推算增加导出耗时] → 每页一次批量查询,无 N+1。
|
||||
- [新列导致历史任务列错位] → 行构造一律以冻结 `ResolvedHeaders` 判定是否输出新列。
|
||||
- [调用方按旧消息“参数验证失败”匹配] → 错误码 `1001` 不变,调用方应按错误码分支。
|
||||
|
||||
## Migration Plan
|
||||
|
||||
无迁移。测试环境部署 API 与 Worker 后,新建导出任务使用新表头,已有任务沿用冻结表头。
|
||||
|
||||
## Open Questions
|
||||
|
||||
无。
|
||||
@@ -0,0 +1,30 @@
|
||||
## Why
|
||||
|
||||
8-9 月迭代中的 4 个优化项原排在第 2 批,2026-10-11 确定并入第 1 批一起交付:修改密码失败只提示“参数验证失败”(M1),且各入口密码规则不一(6~20、6~50、6~64、8~32 位)、只限长度无强度要求;订单导出缺“操作人”(M4,运营清单 B-1);IoT 卡导出缺“套餐到期时间”(M5,运营清单 21);设备导出流量未标单位、无 GB 合计(M6,运营清单 22)。内容沿用原 `fix-august-iteration-follow-up-gaps` 中已核实的方案,依据为《8-9月迭代排期安排》。
|
||||
|
||||
## What Changes
|
||||
|
||||
- **BREAKING** 所有设置登录密码的入口统一为:8~12 位、仅 ASCII 可见字符、大写/小写/数字/特殊符号四类至少三类。长度不符返回 `1001`,强度不足返回 `1016`。存量密码照常登录,不强制修改。
|
||||
- `PUT /api/auth/password` 校验失败消息改为“修改密码参数不合法:”加字段与规则,例如“新密码长度不能小于 8”;不回显密码。
|
||||
- 订单导出新任务在最后一列增加“操作人”,取订单冻结的 `operator_name`。
|
||||
- IoT 卡导出新任务在最后一列增加“套餐到期时间”,复用卡列表最终到期推算,只有精确推算时输出。
|
||||
- 设备导出新任务表头改为 `ICCIDn使用的流量(MB)`、“设备合计(MB)”,在最后一列新增“设备合计(GB)”(MB ÷ 1024,两位小数)。
|
||||
- 历史导出任务按冻结表头输出,不插入新列。
|
||||
|
||||
## Capabilities
|
||||
|
||||
### New Capabilities
|
||||
|
||||
无。
|
||||
|
||||
### Modified Capabilities
|
||||
|
||||
- `identity-access`:登录密码统一长度与强度规则;修改密码接口的字段级中文校验提示。
|
||||
- `export-task`:订单、IoT 卡、设备三类导出的新列、来源、单位与历史任务表头兼容。
|
||||
|
||||
## Impact
|
||||
|
||||
- 代码:`pkg/validator`(新增登录密码规则函数);设置密码的服务入口 `internal/service/auth/service.go`、`internal/service/account/service.go`、`internal/application/shop/create.go`、`internal/service/enterprise/service.go`、`internal/domain/distribution/distribution.go`;相关 DTO 校验标签(`auth_dto.go`、`account_dto.go`、`shop_dto.go`、`enterprise_dto.go`、`agent_distribution_dto.go`);`internal/handler/auth/handler.go`、`internal/exporter/order_scene.go`、`internal/exporter/iot_card_scene.go`(批量调用 `packageexpiry.Query.ResolveBatch`)、`internal/exporter/device_scene.go`。
|
||||
- 接口:七个设置密码入口的长度上限与强度规则变化,修改密码错误消息变化;三类导出新任务表头变化;重新生成接口文档。
|
||||
- 前端:后台建账号、改密码、新增企业、建店铺与 H5 代理注册页面的密码提示与前端校验需同步改为新规则;导出无需改动。
|
||||
- 无数据库迁移,不改 Redis 与第三方调用。
|
||||
@@ -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 新增的列
|
||||
@@ -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** 系统不修改密码
|
||||
@@ -0,0 +1,26 @@
|
||||
## 1. M1 登录密码规则与修改密码提示
|
||||
|
||||
- [x] 1.1 `pkg/validator` 新增登录密码规则函数(8~12 位 → `1001`;仅 ASCII 可见字符、四类至少三类 → `1016`),消息不含密码;在本人改密码、后台账号创建/修改/改密码、建店铺初始密码、企业新增/改密码、代理注册(替换 `distribution.go:67` 的 6~64 判断)共七处哈希前调用;对应 DTO 标签改为 `min=8,max=12` 并更新字段说明。不改登录校验与 `CreateSystemAccount`。
|
||||
- [x] 1.2 为 `ChangePasswordRequest` 的旧密码、新密码字段补中文描述,统一修改密码 Handler 用 `validation.Message` 返回“修改密码参数不合法:”加字段级提示;结构校验通过后在 Handler 内做强度判断(同样带该前缀),先于旧密码比对;不回显密码。
|
||||
- [x] 1.3 核对短于 8 位、超过 12 位、强度不足、必填缺失四种消息符合 delta spec;JSON 解析失败与旧密码错误行为不变。
|
||||
|
||||
## 2. M4 订单导出操作人
|
||||
|
||||
- [x] 2.1 订单导出查询带出 `operator_name`,新任务在最后一列输出“操作人”;`orderCardGroupCountFromHeaders` 先识别末列是否为“操作人”再反推卡列组数;按 `ResolvedHeaders` 判定是否输出,历史任务保持旧列序与行宽。
|
||||
|
||||
## 3. M5 IoT 卡导出套餐到期时间
|
||||
|
||||
- [x] 3.1 IoT 卡导出新任务在最后一列增加“套餐到期时间”;每个分页调用一次 `packageexpiry.Query.ResolveBatch`,只有 `exact` 输出时间,其余留空;历史任务不加列。
|
||||
|
||||
## 4. M6 设备导出流量单位
|
||||
|
||||
- [x] 4.1 设备导出新任务表头改为 `ICCIDn使用的流量(MB)`、“设备合计(MB)”,在最后一列增加“设备合计(GB)”(MB 合计 ÷ 1024,两位小数),`cardGroupCountFromHeaders` 增加对新尾部列数(7)的识别;无绑定卡设备 MB、GB 合计输出格式化零值;历史任务按冻结表头输出。
|
||||
- [x] 4.2 核对三类导出新旧表头与每行列数严格一致,空操作人、到期不可精确推算、无绑定卡设备均不丢行。
|
||||
|
||||
## 5. 文档与测试环境验证
|
||||
|
||||
- [x] 5.1 `gofmt`、`go build ./cmd/api ./cmd/worker`、`go run cmd/gendocs/main.go`。
|
||||
- [x] 5.2 按 ENG-TEST-001(测试库 `junhong_cmp_test`、Redis DB 6):修改密码接口验证四种提示且失败不改密码;七个入口各用 `Abc12345` 成功、`abcd1234` 返回 `1016`、7 位与 13 位返回 `1001`、含空格返回 `1016`;用规则上线前的 6 位旧密码账号登录照常成功。只使用本 Change 自建的测试账号、企业与店铺,验证后清理。
|
||||
- [ ] 5.3 通知测试环境前端同步七个入口的密码提示与前端校验(8~12 位、四类至少三类)。
|
||||
- [ ] 5.4 测试环境为订单、IoT 卡、设备各建一个导出任务,下载核对新表头、值来源、MB/GB 换算与列数;再用变更前创建的任务验证旧表头与行宽不变;只清理本 Change 自建的任务与对象。
|
||||
- [ ] 5.5 运行 `openspec validate --all` 与 `./scripts/context-health.sh`。
|
||||
Reference in New Issue
Block a user