feat: 新增运营商停机原因

openspec/changes/add-asset-gateway-extend-display/proposal.md

@@ -0,0 +1,40 @@
+# Change: 补充资产详情 gateway_extend 卡状态扩展展示
+
+## Why
+
+当前后台“资产信息”页还没有消费接口新增的 `gateway_extend` 字段，因此运营人员无法在资产详情中直接看到运营商侧实际停机原因。
+
+最新接口契约已经补充两类返回：
+- 设备资产的绑定卡列表项新增 `gateway_extend`
+- 卡资产详情新增 `gateway_extend`
+
+如果前端不补齐这部分契约和展示规范，资产详情页会继续丢失上游已经返回的停机原因信息，影响停机排查和运营判断。
+
+## What Changes
+
+- 为后台“资产信息”页新增 `gateway_extend` 消费规范：
+  - 卡资产详情需接收并保留 `gateway_extend`
+  - 设备资产绑定卡列表项需接收并保留 `gateway_extend`
+  - 页面展示时需按上游原样展示该字段，不做二次翻译或改写
+- 为后台“资产信息”页新增 `gateway_extend` 展示规范：
+  - 卡资产在“卡信息”区域展示运营商侧实际停机原因
+  - 设备资产在“绑定卡列表”中展示每张卡的运营商侧实际停机原因
+  - 字段为空时展示稳定占位内容
+- 范围约束：
+  - 仅覆盖后台管理端资产详情页
+  - 不要求本次同步修改卡列表、设备列表或 C 端页面
+  - 不改变后端接口路径、方法和字段命名
+
+## Impact
+
+- Affected specs:
+  - `asset-information`
+- Affected code:
+  - `src/types/api/asset.ts`
+  - `src/views/asset-management/asset-information/composables/useAssetInfo.ts`
+  - `src/views/asset-management/asset-information/components/BasicInfoCard.vue`
+  - `src/views/asset-management/asset-information/types.ts`
+- Dependencies:
+  - 依赖后端资产详情相关响应已返回 `gateway_extend`
+- Breaking changes:
+  - 无

openspec/changes/add-asset-gateway-extend-display/specs/asset-information/spec.md

@@ -0,0 +1,41 @@
+## 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 显示稳定占位内容

openspec/changes/add-asset-gateway-extend-display/tasks.md

@@ -0,0 +1,15 @@
+## 1. Contract Alignment
+
+- [x] 1.1 扩展后台资产详情相关类型，支持卡资产详情与设备绑定卡列表中的 `gateway_extend`。
+- [x] 1.2 调整资产详情数据映射与设备绑定卡刷新合并逻辑，确保 `gateway_extend` 在初次加载和后续刷新后都不会丢失。
+
+## 2. UI Display
+
+- [x] 2.1 在卡资产“卡信息”区域新增 `gateway_extend` 展示，作为运营商侧实际停机原因。
+- [x] 2.2 在设备资产“绑定卡列表”中新增 `gateway_extend` 展示，并为缺失值提供稳定占位内容。
+
+## 3. Verification
+
+- [ ] 3.1 验证卡资产详情返回 `gateway_extend` 时页面可按原样展示。
+- [ ] 3.2 验证设备资产绑定卡列表返回 `gateway_extend` 时每条卡记录展示正确。
+- [ ] 3.3 验证资产刷新或实时状态更新后，已展示的 `gateway_extend` 不会被错误清空。