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