fix: 第1批 F1、M12 一资产一号与换货按手机号关联校验
- F1 一个资产同时只能有一个有效手机号关联,他号绑定返回 1192(不含号码),同号幂等 - 登录 need_bind_phone 改看资产是否已有有效关联,新增 asset_phone_bound、asset_phone_is_own;H5 绑定按客户/资产两侧状态分别写入 - 客户换号不再迁移资产关联 - M12 换货新资产有有效手机号关联即拒绝,号码只在 data.phone;换货完成清空旧资产客户绑定并失效旧资产关联(exchange_completed),均不迁移 - OpenSpec Change enforce-single-phone-per-asset:11/16,H5 短信与换货端到端验证待测试部署后完成
This commit is contained in:
@@ -0,0 +1,52 @@
|
||||
## MODIFIED Requirements
|
||||
|
||||
### Requirement: 换货业务数据迁移范围
|
||||
|
||||
系统 SHALL 仅在选择业务数据迁移的换货完成中迁移旧资产的钱包余额、有效套餐使用记录、累计充值字段和资产标签。资产归属 SHALL 继续作为换货完成固有动作,不受业务数据迁移选项控制。换货完成时系统 MUST 清空旧资产上的全部有效个人客户—资产绑定(设备按虚拟号、为空则 IMEI 定位;卡按虚拟号与 ICCID 两种绑定都清),置为无效而非物理删除,同事务写审计(原因“换货完成”);MUST NOT 把客户绑定迁移到新资产,新资产 MUST NOT 新增任何客户绑定;客户自己的手机号与微信绑定不变。清空后原客户已持有的旧资产 H5 令牌在下一次资产归属校验时失效;任何客户(含原客户)重新扫码旧资产时,按普通扫码登录重新建立绑定,系统 MUST NOT 因曾被换货而拒绝。手机号—资产关联 MUST NOT 随换货或业务数据迁移转移,旧资产关联按手机号—资产关联能力在换货完成时失效,新资产首次访问时按其适用的手机号绑定规则处理。
|
||||
|
||||
#### Scenario: 选择业务数据迁移完成换货
|
||||
|
||||
- **WHEN** 换货单选择业务数据迁移并成功确认完成
|
||||
- **THEN** 系统迁移钱包余额、有效套餐使用记录、累计充值字段和资产标签,且不迁移客户绑定与手机号—资产关联
|
||||
|
||||
#### Scenario: 不选择业务数据迁移完成换货
|
||||
|
||||
- **WHEN** 换货单未选择业务数据迁移并确认完成
|
||||
- **THEN** 系统仍完成资产归属的固有换货动作并清空旧资产客户绑定,但不迁移钱包余额、套餐使用记录、累计充值字段或资产标签
|
||||
|
||||
#### Scenario: 换货后原客户用旧令牌访问旧资产
|
||||
|
||||
- **WHEN** 换货完成后,原客户不重新扫码、直接用换货前的旧资产 H5 令牌访问旧资产
|
||||
- **THEN** 系统按资产不属于该客户拒绝访问
|
||||
|
||||
#### Scenario: 换货后重新扫码旧资产
|
||||
|
||||
- **WHEN** 换货完成后,原客户或其他客户重新扫码旧资产登录
|
||||
- **THEN** 系统按普通扫码建立新的有效绑定,可正常访问旧资产,且不重复标记资产已售
|
||||
|
||||
#### Scenario: 卡换货清空两种绑定
|
||||
|
||||
- **WHEN** 旧卡同时存在按虚拟号与按 ICCID 的有效客户绑定,换货完成
|
||||
- **THEN** 两种绑定都变为无效并写审计,新卡不新增客户绑定
|
||||
|
||||
## ADDED Requirements
|
||||
|
||||
### Requirement: 换货新资产手机号关联校验
|
||||
|
||||
创建直接换货与确认物流换货完成时,系统 SHALL 检查新资产是否存在有效手机号—资产关联,存在则拒绝,错误信息为“新资产已绑定手机号,请先在后台解除该资产的手机号绑定,再重新提交换货申请”,错误信息 MUST NOT 包含号码;完整号码 MUST 放在错误响应的 `data.phone` 中,MUST NOT 写入日志。系统 MUST NOT 再以“有人扫过码”(个人客户—资产绑定)作为拒绝依据。直接换货被拒时整体回滚、不留换货单;物流换货被拒时停在已发货待确认,后台解除关联后可重新确认。类型一致、旧资产状态可换、新资产未被其他换货单占用的既有校验不变。
|
||||
|
||||
#### Scenario: 新资产已绑定手机号
|
||||
- **WHEN** 后台为一项已与号码 P 有效关联的新资产创建直接换货
|
||||
- **THEN** 系统拒绝且不产生换货单,错误信息不含号码,`data.phone` 为 P
|
||||
|
||||
#### Scenario: 解除后重新提交
|
||||
- **WHEN** 后台解除新资产的手机号关联后重新创建换货
|
||||
- **THEN** 换货创建成功
|
||||
|
||||
#### Scenario: 只被扫码过的新资产
|
||||
- **WHEN** 新资产没有有效手机号关联,但存在多个客户的扫码绑定
|
||||
- **THEN** 系统不因客户绑定拒绝换货
|
||||
|
||||
#### Scenario: 物流换货确认完成时被拒
|
||||
- **WHEN** 物流换货在确认完成时新资产存在有效手机号关联
|
||||
- **THEN** 换货单保持已发货待确认,解除关联后再次确认成功
|
||||
@@ -0,0 +1,111 @@
|
||||
## MODIFIED Requirements
|
||||
|
||||
### Requirement: H5 验证建立关联与数量上限
|
||||
|
||||
系统 SHALL 保留既有全局 H5 强制绑定开关。开关开启时,客户首次登录一项尚无任何有效手机号关联的资产,必须完成短信验证码校验后才建立关系;资产已有有效关联时不再要求为该资产验证。开关关闭时登录不要求验证,且不查询、不新增、不删除任何关系,已有关系保留。关联只能由 H5 验证建立,卡(`iot_card`)与设备(`device`)分别计为独立资产。
|
||||
|
||||
一个资产同时 MUST 至多存在一条有效手机号关联;单手机号最多关联十项当前有效资产;两项上限都只统计当前有效关系,已失效关系不占用额度。建立关联前系统 MUST 查询该资产的有效关联:无有效关联时写入;有效关联的号码与本次相同时幂等成功、不产生第二条关系;有效关联为其他号码时 MUST 拒绝,提示“该资产已绑定手机号,如需更换请联系管理员”,提示与响应 MUST NOT 包含任何号码。所有建立关联的入口 MUST 经同一写入路径,MUST NOT 绕开上述判断。该判断不加资产锁、不加唯一约束:两个不同号码在同一时刻为同一资产完成验证时可能都写入,属已接受的极小概率情况,由只读统计“同一资产多条有效关联”发现后在后台解除。上线不回填历史客户—资产关系。
|
||||
|
||||
#### Scenario: 第十一项资产验证
|
||||
|
||||
- **WHEN** 已关联十项有效资产的手机号验证第十一项资产
|
||||
- **THEN** 系统拒绝本次新关联,已有十项关系不变
|
||||
|
||||
#### Scenario: 资产已绑定其他号码
|
||||
|
||||
- **GIVEN** 资产 A 已与号码 P 存在有效关系
|
||||
- **WHEN** 任一客户以号码 Q 通过接口为 A 绑定
|
||||
- **THEN** 系统拒绝并提示“该资产已绑定手机号,如需更换请联系管理员”,响应不含 P 或 Q,A 的关系不变
|
||||
|
||||
#### Scenario: 同号重复验证
|
||||
|
||||
- **WHEN** 号码 P 对已与 P 有效关联的资产再次完成验证
|
||||
- **THEN** 系统返回成功且不产生第二条有效关系
|
||||
|
||||
#### Scenario: 开关关闭后登录未关联资产
|
||||
|
||||
- **WHEN** 全局强制绑定开关关闭,客户登录一项未关联其手机号的资产
|
||||
- **THEN** 系统不要求验证、不新增关系,且既有关系不被删除
|
||||
|
||||
#### Scenario: 卡与设备分别计数
|
||||
|
||||
- **WHEN** 同一手机号关联了 `iot_card` 类型 ID 为 5 的资产与 `device` 类型 ID 为 5 的资产
|
||||
- **THEN** 两者计为两项资产,互不覆盖也不合并计数
|
||||
|
||||
### Requirement: 登录提示判定
|
||||
|
||||
系统 SHALL 在登录响应中以 `need_bind_phone` 表示当前客户或当前访问资产是否仍需完成手机号绑定,并额外返回两个布尔字段:当前资产是否已绑定手机号、该手机号是否为当前客户自己的号码;响应 MUST NOT 返回号码。开关开启时:客户无主手机号,返回 `true`(客户手机号仍强制绑定);客户有主手机号且当前资产尚无任何有效关联,返回 `true`;当前资产已有有效关联(无论号码属于谁)且客户有主手机号,返回 `false`。开关关闭时 `need_bind_phone` 恒为 `false`。该字段 MUST 只作为前端提示,系统 MUST NOT 因缺少关系拒绝任何资产业务入口。
|
||||
|
||||
#### Scenario: 已有手机号但资产未关联
|
||||
|
||||
- **WHEN** 客户已有主手机号,登录一项尚无任何有效关联的资产
|
||||
- **THEN** 响应 `need_bind_phone=true`,资产已绑定为 `false`
|
||||
|
||||
#### Scenario: 资产已被他人号码绑定
|
||||
|
||||
- **WHEN** 客户已有主手机号,登录一项已与其他号码有效关联的资产
|
||||
- **THEN** 响应 `need_bind_phone=false`,资产已绑定为 `true`,是否本人号码为 `false`,且不返回号码
|
||||
|
||||
#### Scenario: 客户无手机号而资产已绑定
|
||||
|
||||
- **WHEN** 客户没有主手机号,登录一项已有有效关联的资产
|
||||
- **THEN** 响应 `need_bind_phone=true`,资产已绑定为 `true`,验证通过后只写客户手机号
|
||||
|
||||
#### Scenario: 缺关系不拦截业务接口
|
||||
|
||||
- **WHEN** 客户在 `need_bind_phone=true` 状态下调用其有权访问的资产业务接口
|
||||
- **THEN** 系统按既有资产归属与数据范围规则授权,不因缺少该关系返回拒绝
|
||||
|
||||
### Requirement: H5 绑定与换绑的关联写入
|
||||
|
||||
客户手机号与资产手机号 SHALL 相互独立,不要求一致、不联动。H5 短信验证成功后,系统 MUST 按客户与当前访问资产两侧状态分别写入:
|
||||
|
||||
| 客户 | 资产 | 写入 |
|
||||
|---|---|---|
|
||||
| 无手机号 | 无有效关联 | 一次验证,同时写客户手机号与资产关联 |
|
||||
| 有手机号 | 无有效关联 | 只建立资产关联,号码可与客户手机号不同,不修改客户手机号 |
|
||||
| 无手机号 | 已有有效关联 | 只写客户手机号,不动资产关联 |
|
||||
| 有手机号 | 已有有效关联 | 不需要绑定 |
|
||||
|
||||
请求不含当前访问资产身份时,系统只完成客户手机号绑定,不建立关联。资产关联写入 MUST 遵守“H5 验证建立关联与数量上限”的一资产一号与十项上限。
|
||||
|
||||
客户更换手机号时 MUST 同时验证旧、新号码,只更换客户手机号,MUST NOT 迁移、复制或失效任何资产关联,也不受资产关联名额影响;新号码已被其他客户持有时的既有拒绝行为保持不变。
|
||||
|
||||
#### Scenario: 已有主号为新资产绑定不同号码
|
||||
|
||||
- **WHEN** 客户主手机号为 P,当前访问资产尚无关联,客户提交号码 Q 与有效验证码
|
||||
- **THEN** 系统建立 Q 与该资产的有效关系,客户手机号仍为 P
|
||||
|
||||
#### Scenario: 无主号且资产无关联
|
||||
|
||||
- **WHEN** 客户无主手机号,当前访问资产尚无关联,客户提交号码 P 与有效验证码
|
||||
- **THEN** 系统同时写入客户手机号 P 与 P—资产有效关系
|
||||
|
||||
#### Scenario: 无主号而资产已绑定
|
||||
|
||||
- **WHEN** 客户无主手机号,当前访问资产已与号码 Q 有效关联,客户提交号码 P 与有效验证码
|
||||
- **THEN** 系统只写入客户手机号 P,资产仍只与 Q 关联
|
||||
|
||||
#### Scenario: 客户换号不迁移关联
|
||||
|
||||
- **WHEN** 客户把手机号从 P 换成 R
|
||||
- **THEN** 客户手机号变为 R,P 的全部资产关联保持不变
|
||||
|
||||
### Requirement: 关联不影响换货与其他写入路径
|
||||
|
||||
资产导入、后台资产编辑与个人客户主手机号变更 MUST NOT 创建、推断、复制或迁移手机号—资产关系。换货 MUST NOT 把旧资产的关联转移到新资产;换货完成时系统 MUST 在同一事务内将旧资产的全部有效关联置为失效,失效方式为 `exchange_completed`,失效原因“换货完成”,操作人为确认换货完成的账号,写审计(手机号脱敏),释放该号码名额;旧资产无有效关联时跳过。新资产在客户首次 H5 访问时,按当时全局开关与其自身关联状态重新走验证。
|
||||
|
||||
#### Scenario: 换货不迁移关系并失效旧资产关联
|
||||
|
||||
- **WHEN** 换货完成并用新资产替换旧资产,旧资产与号码 P 存在有效关系
|
||||
- **THEN** 新资产不继承 P,旧资产与 P 的关系变为失效(`exchange_completed`),P 的有效关联数量减一
|
||||
|
||||
#### Scenario: 换货新资产首次登录
|
||||
|
||||
- **WHEN** 全局开关开启,客户换货完成后首次登录尚无关联的新资产
|
||||
- **THEN** 响应 `need_bind_phone=true`
|
||||
|
||||
#### Scenario: 资产导入与后台资产编辑不产生关系
|
||||
|
||||
- **WHEN** 导入资产或修改后台资产属性
|
||||
- **THEN** 关联记录数不变,不产生任何手机号—资产关系
|
||||
Reference in New Issue
Block a user