Files
junhong_cmp_fiber/openspec/specs/personal-customer/spec.md

2.4 KiB
Raw Blame History

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(获取当前生效的公众号 AppIDGET /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(查询待处理换货单)。