61 lines
3.1 KiB
Markdown
61 lines
3.1 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 retain the valid session
|
||
|
||
H5 SHALL 在绑定成功后保留有效 token、identifier 和客户信息;强制绑定成功 SHALL 直接进入首页,普通绑定成功 SHALL 返回上一页。H5 SHALL NOT 因绑定成功清除登录态、跳转登录页或要求自动/手动重新登录。状态更新 SHALL 对应本次客户/资产实际绑定对象,SHALL NOT 一律将输入号码写入资产缓存。
|
||
|
||
#### Scenario: Mandatory binding succeeds
|
||
|
||
- **WHEN** 用户从强制绑定入口成功提交
|
||
- **THEN** H5 SHALL 直接进入首页并保留当前 token、identifier 和客户信息
|
||
- **AND** SHALL 清理旧版本的绑定后重登提示标记,不发送新的 OAuth 登录请求
|
||
|
||
#### Scenario: Ordinary binding succeeds
|
||
|
||
- **WHEN** 用户从首页普通入口成功提交
|
||
- **THEN** H5 SHALL 返回上一页,按后端结果更新相关状态,不强制返回登录页
|
||
|
||
#### Scenario: Prefill received a one-time reminder before binding
|
||
|
||
- **WHEN** 绑定页预填请求收到 expiry_reminder,随后用户绑定成功
|
||
- **THEN** H5 SHALL 保留同一会话下的共享提醒,进入对应资产首页后展示
|