Files
luo 97dec4dc65
All checks were successful
构建并部署前端到生产环境 / build-and-deploy (push) Successful in 2m14s
fix: some
2026-10-13 16:11:02 +08:00

61 lines
3.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
## 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 保留同一会话下的共享提醒,进入对应资产首页后展示