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

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:
  • 无