one-pipe-system/openspec/changes/add-iot-device-operations/proposal.md

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客户端（已在项目中）