2.4 KiB
personal-customer 当前行为
Purpose
描述个人客户身份与资产归属隔离的当前行为。
Requirements
Requirement: 个人客户身份
系统 SHALL 支持个人客户通过既有认证入口登录、退出并查询当前资料。
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(查询待处理换货单)。