break
fcfa347005
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 8m38s
66 lines
2.8 KiB
Markdown
66 lines
2.8 KiB
Markdown
# personal-customer 当前行为
|
||
|
||
## Purpose
|
||
|
||
描述个人客户身份与资产归属隔离的当前行为。
|
||
|
||
## Requirements
|
||
|
||
### Requirement: 个人客户身份
|
||
|
||
系统 SHALL 支持个人客户通过既有认证入口登录、退出并查询当前资料。有效登录材料对应的客户创建、资料同步或资产绑定 SHALL 不因审计事件构造、校验或持久化失败而失败；审计失败 SHALL 按运营审计要求记录。
|
||
|
||
#### Scenario: 个人客户身份
|
||
|
||
- **GIVEN** 个人客户提供有效登录材料
|
||
- **WHEN** 请求认证
|
||
- **THEN** 系统返回个人客户身份和访问凭证
|
||
|
||
#### Scenario: 登录审计失败
|
||
|
||
- **GIVEN** 个人客户提供有效登录材料且登录需要创建或绑定资产
|
||
- **WHEN** 对应审计事件写入失败
|
||
- **THEN** 系统仍完成客户和资产绑定并返回访问凭证
|
||
|
||
### Requirement: 资产归属查询
|
||
|
||
系统 SHALL 只向个人客户返回当前绑定或可识别的卡与设备资产。
|
||
|
||
#### Scenario: 资产归属查询
|
||
|
||
- **GIVEN** 客户已认证
|
||
- **WHEN** 查询资产列表或详情
|
||
- **THEN** 返回该客户可见的资产而不包含其他客户资产
|
||
|
||
## 可达操作索引
|
||
|
||
本节只用于入口导航，不是行为 Requirement；业务义务以上述 Requirements 为准。
|
||
|
||
### 个人客户 - 认证
|
||
|
||
`POST /api/c/v1/auth/bind-phone`（绑定手机号）；`POST /api/c/v1/auth/change-phone`（更换手机号）；`POST /api/c/v1/auth/logout`（退出登录）；`POST /api/c/v1/auth/miniapp-login`（小程序登录）；`POST /api/c/v1/auth/send-code`（发送验证码）；`POST /api/c/v1/auth/verify-asset`（资产验证）；`POST /api/c/v1/auth/wechat-login`（公众号登录）。仅在开发模式开启时，系统 SHALL 额外提供 `POST /api/c/v1/auth/dev-login`。
|
||
|
||
### 个人客户 - 账户
|
||
|
||
`GET /api/c/v1/profile`（获取个人资料）；`PUT /api/c/v1/profile`（更新个人资料）。
|
||
|
||
### 个人客户 - 微信
|
||
|
||
`GET /api/c/v1/wechat/appid`（获取当前生效的公众号 AppID）；`GET /api/c/v1/wechat/jssdk-config`（获取微信 JSSDK 签名配置）。
|
||
|
||
### 个人客户 - 资产
|
||
|
||
`GET /api/c/v1/asset/info`（资产信息）；`GET /api/c/v1/asset/package-history`（资产套餐历史）；`GET /api/c/v1/asset/packages`（资产可购套餐列表）；`POST /api/c/v1/asset/refresh`（资产刷新）。
|
||
|
||
### 个人客户 - 设备
|
||
|
||
`GET /api/c/v1/device/cards`（获取设备卡列表）；`POST /api/c/v1/device/factory-reset`（恢复出厂设置）；`POST /api/c/v1/device/reboot`（设备重启）；`POST /api/c/v1/device/switch-card`（设备切卡）；`POST /api/c/v1/device/wifi`（设备WiFi配置）。
|
||
|
||
### 个人客户 - 实名
|
||
|
||
`GET /api/c/v1/realname/link`（获取实名认证链接）。
|
||
|
||
### 个人客户 - 换货
|
||
|
||
`POST /api/c/v1/exchange/{id}/shipping-info`（提交收货信息）；`GET /api/c/v1/exchange/pending`（查询待处理换货单）。
|