3.1 KiB
3.1 KiB
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 保留同一会话下的共享提醒,进入对应资产首页后展示