# Change: Add IoT Card and Device Operations ## Why 运营人员和代理商需要更丰富的物联网卡和设备管理功能,包括查询流量使用情况、实名认证状态、卡片状态、启停操作,以及设备的重启、重置、限速、换卡、WiFi设置等操作。这些功能是物联网卡全生命周期管理的核心能力。 ## What Changes ### IoT Card Operations (6 new APIs) - 查询流量使用情况 (GET /api/admin/iot-cards/{iccid}/gateway-flow) - 查询实名认证状态 (GET /api/admin/iot-cards/{iccid}/gateway-realname) - 查询卡片状态 (GET /api/admin/iot-cards/{iccid}/gateway-status) - 获取实名认证链接 (GET /api/admin/iot-cards/{iccid}/realname-link) - 启用物联网卡 (POST /api/admin/iot-cards/{iccid}/start) - 停用物联网卡 (POST /api/admin/iot-cards/{iccid}/stop) ### Device Operations (6 new APIs) - 重启设备 (POST /api/admin/devices/by-imei/{imei}/reboot) - 重置设备 (POST /api/admin/devices/by-imei/{imei}/reset) - 设置限速 (PUT /api/admin/devices/by-imei/{imei}/speed-limit) - 切换SIM卡 (POST /api/admin/devices/by-imei/{imei}/switch-card) - 设置WiFi (PUT /api/admin/devices/by-imei/{imei}/wifi) ### UI Changes - 在 `/asset-management/iot-card-management` 页面添加操作按钮: - "查询流量"按钮(主要操作) - "更多操作"下拉菜单(包含其他5个操作) - 在 `/asset-management/devices` 页面添加操作按钮: - "重启设备"按钮(主要操作) - "更多操作"下拉菜单(包含其他5个操作) ## Impact ### Affected Specs - **NEW**: `specs/iot-card-operations/spec.md` - IoT卡操作相关的所有需求 - **NEW**: `specs/device-operations/spec.md` - 设备操作相关的所有需求 ### Affected Code - **API层**: - 新增 `src/api/modules/iotCard.ts` - IoT卡操作API方法 - 新增 `src/api/modules/device.ts` - 设备操作API方法 - **类型定义**: - 新增 `src/types/api/iotCard.ts` - IoT卡相关类型 - 新增 `src/types/api/device.ts` - 设备相关类型 - **页面组件**: - 修改 `src/views/asset-management/iot-card-management/index.vue` - 添加操作按钮和对话框 - 修改 `src/views/asset-management/devices/index.vue` - 添加操作按钮和对话框 ### Breaking Changes 无破坏性变更。所有变更都是增量式的新功能添加。 ## Dependencies - 后端API已实现(见 `docs/2-3新增接口.md`) - Element Plus UI组件库(已在项目中) - Axios HTTP客户端(已在项目中)