Files
one-pipe-system/openspec/changes/update-order-upload-and-device-switch-mode/proposal.md
2026-04-29 11:29:53 +08:00

2.1 KiB
Raw Blame History

Change: 更新订单支付凭证上传反馈与设备切卡模式配置

Why

当前订单创建和设备切卡相关交互与最新需求不一致:

  • 创建订单时,支付凭证上传是异步过程,但提交按钮没有明确反映“图片上传中”状态,用户可能在文件仍在上传时误以为可以提交。
  • 设备切卡模式接口已经调整为必须同时提交 iot_card_idswitch_mode,并要求设备已配置 IMEI当前前端只提交 switch_mode
  • 设备实时信息区域当前仍展示 IP 地址 字段,和最新展示要求不一致。

这些差异会导致误操作、接口调用失败以及页面展示不符合产品预期。

What Changes

  • 更新订单创建弹窗的支付凭证上传反馈:
    • 凭证上传进行中时,提交按钮显示 图片上传中...
    • 上传完成前禁止提交订单
    • 上传结束后恢复正常提交状态
  • 更新设备切卡模式流程:
    • 切卡模式弹窗增加绑定卡选择
    • 提交时调用 POST /api/admin/devices/by-identifier/{identifier}/switch-mode
    • 请求体改为 { iot_card_id, switch_mode }
    • 设备未配置 IMEI 时禁止执行切卡模式设置
  • 更新设备实时信息展示:
    • 删除“设备实时信息”中的 IP 地址 字段展示
    • 保留其他实时网络信息字段不变

Impact

  • Affected specs:
    • order-management
    • device-management
  • Affected code:
    • src/views/order-management/order-list/index.vue
    • src/api/modules/device.ts
    • src/types/api/device.ts
    • src/views/asset-management/device-list/index.vue
    • src/views/asset-management/asset-information/index.vue
    • src/views/asset-management/asset-information/components/dialogs/SwitchModeDialog.vue
    • src/views/asset-management/asset-information/components/BasicInfoCard.vue
    • src/views/asset-management/asset-information/types.ts
  • Dependencies:
    • 依赖现有订单创建流程和对象存储上传流程
    • 与活跃变更 add-order-management 存在同一能力域的补充关系,实施时需要一并核对
  • Breaking changes:
    • 前端 DeviceService.setSwitchMode 的调用签名将发生变化