55 lines
2.7 KiB
Markdown
55 lines
2.7 KiB
Markdown
## ADDED Requirements
|
||
|
||
### Requirement: Binding SHALL distinguish customer and asset phone targets
|
||
|
||
H5 SHALL 按 F1 四种场景组织绑定表单,继续使用 `POST /api/c/v1/auth/bind-phone` 的 `{ phone, code }` 与既有验证码场景。客户号码预填 SHALL 可编辑,SHALL NOT 要求未绑定资产只能绑定客户主号,也 SHALL NOT 用资产布尔字段推导实际号码。
|
||
|
||
#### Scenario: Neither the customer nor the asset has a phone
|
||
|
||
- **WHEN** 客户和资产都无手机号,用户输入号码并成功验证
|
||
- **THEN** H5 SHALL 按后端同时绑定客户和资产的结果完成流程
|
||
|
||
#### Scenario: Only the customer has a phone
|
||
|
||
- **WHEN** 客户已有号码,资产未关联号码
|
||
- **THEN** H5 SHALL 提示给当前资产绑号,允许提交与客户号码不同的号码
|
||
- **AND** 成功后 SHALL NOT 把输入的资产号码当成客户的新号码
|
||
|
||
#### Scenario: Only the asset has a phone
|
||
|
||
- **WHEN** 客户无号码,资产已有号码,用户成功提交客户绑定
|
||
- **THEN** H5 SHALL 仅更新客户手机号状态,不覆盖或改变资产关联
|
||
|
||
#### Scenario: Both the customer and the asset have phones
|
||
|
||
- **WHEN** 客户和资产都已有号码
|
||
- **THEN** H5 SHALL 不要求绑定,无论资产号码是否属于当前客户
|
||
|
||
### Requirement: Asset phone conflicts SHALL direct the user to an administrator
|
||
|
||
H5 SHALL 对 `bind-phone` 的 `code=1192` 提示“该资产已绑定手机号,如需更换请联系管理员”,SHALL NOT 重试当前资产改绑请求、暴露号码或调用后台解除接口。其他错误 SHALL 保留后端消息,失败 SHALL NOT 更新绑定成功状态。
|
||
|
||
#### Scenario: Binding returns 1192
|
||
|
||
- **WHEN** 后端拒绝资产改绑并返回 1192
|
||
- **THEN** H5 SHALL 显示联系管理员提示并停止当前改绑操作,不提供同请求重试
|
||
|
||
#### Scenario: Phone is owned by another customer
|
||
|
||
- **WHEN** 绑定返回既有 1184 错误
|
||
- **THEN** H5 SHALL 保留相应后端错误提示,不误报为绑定成功或转换成 1192
|
||
|
||
### Requirement: Binding completion SHALL preserve existing navigation
|
||
|
||
H5 SHALL 保留强制绑定成功后回登录页、恢复 identifier 并等待用户手动重登的行为,以及普通绑定成功返回上一页的行为。状态更新 SHALL 对应本次客户/资产实际绑定对象,SHALL NOT 一律将输入号码写入资产缓存。
|
||
|
||
#### Scenario: Mandatory binding succeeds
|
||
|
||
- **WHEN** 用户从强制绑定入口成功提交
|
||
- **THEN** H5 SHALL 返回登录页,保留 identifier 并提示手动重登,不自动 OAuth 重登
|
||
|
||
#### Scenario: Ordinary binding succeeds
|
||
|
||
- **WHEN** 用户从首页普通入口成功提交
|
||
- **THEN** H5 SHALL 返回上一页,按后端结果更新相关状态,不强制返回登录页
|