Files
邹进 9ced14fa1b 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 短信与换货端到端验证待测试部署后完成
2026-10-12 00:10:41 +09:00

7.4 KiB
Raw Blame History

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 关联记录数不变,不产生任何手机号—资产关系