# 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 IP` 与 `LAN IP` 等其他实时网络字段在有数据时 MUST 继续显示