junhong_cmp_fiber/openspec/changes/client-api-data-model-fixes/specs/carrier-realname-config/spec.md at ec86dbf4636b7e6c0b80a9ee36a2f6620cf930ba

csxj2026/junhong_cmp_fiber

Files

huang ec86dbf463 feat: 客户端接口数据模型基础准备

- 新增资产状态、订单来源、操作人类型、实名链接类型常量
- 8个模型新增字段（asset_status/generation/source/retail_price等）
- 数据库迁移000082：7张表15+字段，含存量retail_price回填
- BUG-1修复：代理零售价渠道隔离，cost_price分配锁定
- BUG-2修复：一次性佣金仅客户端订单触发
- BUG-4修复：充值回调Store操作纳入事务
- 新增资产手动停用接口（PATCH /iot-cards/:id/deactivate、/devices/:id/deactivate）
- Carrier管理新增实名链接配置
- 后台订单generation写时快照
- BatchUpdatePricing支持retail_price调价目标
- 清理全部H5旧接口和个人客户旧登录方法

2026-03-19 10:56:50 +08:00

1.6 KiB

Raw Blame History

ADDED Requirements

Requirement: 运营商实名链接配置字段定义

系统 MUST 在 Carrier 模型新增以下字段：

realname_link_type varchar(20) NOT NULL DEFAULT 'none'
realname_link_template varchar(500) DEFAULT ''

Scenario: 默认配置为不支持在线实名

WHEN 创建新的运营商记录且未显式设置实名链接配置
THEN 系统 MUST 将 realname_link_type 设为 none，realname_link_template 设为空字符串

Requirement: 实名链接三种模式

系统 MUST 支持并仅支持以下实名链接模式：

none：不支持在线实名
template：使用模板 URL 生成实名链接
gateway：通过 Gateway 接口动态获取实名链接

Scenario: none 模式

WHEN realname_link_type=none
THEN 系统 MUST 视为不支持在线实名跳转

Scenario: template 模式

WHEN realname_link_type=template
THEN 系统 MUST 使用 realname_link_template 作为实名链接模板

Scenario: gateway 模式

WHEN realname_link_type=gateway
THEN 系统 MUST 通过 Gateway 能力获取实名链接

Requirement: 模板占位符规则

当 realname_link_type=template 时，系统 MUST 支持模板中的占位符 {iccid}、{msisdn}、{virtual_no}。

本提案阶段 MUST 仅新增字段，不实现实名跳转接口逻辑。

Scenario: 模板占位符可被解析

WHEN 模板 URL 包含 {iccid}、{msisdn} 或 {virtual_no}
THEN 系统 MUST 在后续实名跳转实现中按占位符语义进行参数替换

1.6 KiB Raw Blame History Unescape Escape