Files
one-pipe-system/openspec/changes/add-asset-gateway-extend-display/specs/asset-information/spec.md
sexygoat 471d1196b3
All checks were successful
构建并部署前端到测试环境 / build-and-deploy (push) Successful in 4m44s
feat: 新增运营商停机原因
2026-05-12 12:11:53 +08:00

42 lines
2.1 KiB
Markdown

## ADDED Requirements
### Requirement: Admin Asset Gateway Extend Contract
The admin asset information integration SHALL accept and preserve `gateway_extend` for card asset details and device bound-card entries.
#### Scenario: Card asset detail preserves gateway_extend
- **GIVEN** 用户正在查看后台“资产信息”中的卡资产详情
- **AND** 资产详情响应返回 `gateway_extend`
- **WHEN** 前端解析并映射卡资产详情数据
- **THEN** 页面状态 MUST 保留 `gateway_extend` 原始字符串
- **AND** 后续页面渲染 MUST 可以直接消费该字段
#### Scenario: Device bound-card entries preserve gateway_extend
- **GIVEN** 用户正在查看后台“资产信息”中的设备资产详情
- **AND** 绑定卡列表数据中的某条记录返回 `gateway_extend`
- **WHEN** 前端解析初次详情响应或后续刷新返回的绑定卡数据
- **THEN** 对应卡记录 MUST 保留各自的 `gateway_extend` 原始字符串
- **AND** 绑定卡列表的刷新合并过程 MUST NOT 无故丢失已有的 `gateway_extend`
### Requirement: Admin Asset Gateway Extend Display
The admin asset information view SHALL display `gateway_extend` as the carrier-side actual stop reason for card assets and device bound cards.
#### Scenario: Show gateway_extend on card asset page
- **GIVEN** 用户正在查看后台“资产信息”中的卡资产详情
- **WHEN** 页面渲染“卡信息”区域
- **THEN** 页面 MUST 提供“运营商停机原因”或等效标签来展示 `gateway_extend`
- **AND** 展示内容 MUST 与上游返回的 `gateway_extend` 保持一致
- **AND** 当 `gateway_extend` 为空时,页面 MUST 显示稳定占位内容
#### Scenario: Show gateway_extend in device bound-card list
- **GIVEN** 用户正在查看后台“资产信息”中的设备资产详情
- **WHEN** 页面渲染“绑定卡列表”
- **THEN** 每条绑定卡记录 MUST 提供“运营商停机原因”或等效展示位来展示本卡的 `gateway_extend`
- **AND** 展示内容 MUST 与该卡返回的 `gateway_extend` 保持一致
- **AND** 当某条卡记录的 `gateway_extend` 为空时,该行 MUST 显示稳定占位内容