Files
2026-04-29 11:29:53 +08:00

1.9 KiB

Device Management Specification

ADDED Requirements

Requirement: Device Switch Mode Submission

The system SHALL require a bound IoT card when configuring device switch mode and MUST submit both iot_card_id and switch_mode to the switch mode API.

Scenario: Submit switch mode with selected bound card

  • GIVEN 用户从设备列表页或资产信息页打开“设置切卡模式”弹窗
  • AND 目标设备已经配置 IMEI
  • AND 目标设备至少绑定了一张卡
  • WHEN 用户选择一张绑定卡并选择切卡模式后确认提交
  • THEN 系统 MUST 调用 POST /api/admin/devices/by-identifier/{identifier}/switch-mode
  • AND 请求体 MUST 包含 iot_card_id
  • AND 请求体 MUST 包含 switch_mode
  • AND 成功后系统 MUST 给出成功反馈并刷新相关设备数据

Scenario: Device without IMEI cannot submit switch mode

  • GIVEN 用户尝试为一个未配置 IMEI 的设备设置切卡模式
  • WHEN 用户打开弹窗或尝试提交
  • THEN 系统 MUST 阻止提交
  • AND 系统 MUST 明确提示设备需要先配置 IMEI

Scenario: Device without bound card cannot submit switch mode

  • GIVEN 目标设备没有任何绑定卡
  • WHEN 用户打开弹窗或尝试提交
  • THEN 系统 MUST 阻止提交
  • AND 系统 MUST 明确提示必须先选择或绑定一张卡

Requirement: Device Realtime Information Visibility

The system SHALL hide the generic IP 地址 field in device realtime information while preserving other required realtime network information.

Scenario: Device realtime information does not show the IP address field

  • GIVEN 页面正在展示设备实时信息
  • WHEN 实时信息卡片完成渲染
  • THEN 界面 MUST NOT 显示标签为 IP 地址 的字段
  • AND WAN IPLAN IP 等其他实时网络字段在有数据时 MUST 继续显示