# asset-device 当前行为

## Purpose

描述卡、设备、资产状态与绑定关系的当前可观察行为。

## Requirements

### Requirement: 资产业务状态

系统 SHALL 将资产状态按 1=在库、2=已销售、3=已换货、4=已停用返回，并与运营商网络状态分离。

#### Scenario: 资产业务状态

- **GIVEN** 资产存在且具有业务与网络状态
- **WHEN** 查询资产详情
- **THEN** 响应分别返回业务状态与网络状态

### Requirement: 设备多卡关系

系统 SHALL 允许设备显式绑定和解绑卡，并在设备资产查询中展示当前卡关系。

#### Scenario: 设备多卡关系

- **GIVEN** 设备与卡均存在且操作人有权管理
- **WHEN** 执行绑定或解绑
- **THEN** 后续设备卡列表反映该关系变化

## 可达操作索引

本节只用于入口导航，不是行为 Requirement；业务义务以上述 Requirements 为准。

### IoT卡管理

`GET /api/admin/iot-cards/{iccid}/realname-link`（获取实名认证链接）；`PUT /api/admin/iot-cards/{iccid}/speed-tier`（设置卡固定限速档位）；`POST /api/admin/iot-cards/batch-update-realname-policy`（批量更新卡实名认证策略）；`POST /api/admin/iot-cards/import`（批量导入IoT卡（ICCID+MSISDN））；`GET /api/admin/iot-cards/import-tasks`（导入任务列表）；`GET /api/admin/iot-cards/import-tasks/{id}`（导入任务详情）；`PATCH /api/admin/iot-cards/series-binding`（批量设置卡的套餐系列绑定）；`GET /api/admin/iot-cards/standalone`（单卡列表（未绑定设备））；`POST /api/admin/iot-cards/standalone/allocate`（批量分配单卡）；`POST /api/admin/iot-cards/standalone/recall`（批量回收单卡）。

### 设备管理

`GET /api/admin/devices`（设备列表）；`DELETE /api/admin/devices/{virtual_no}`（删除设备）；`GET /api/admin/devices/{virtual_no}/cards`（获取设备绑定的卡列表）；`POST /api/admin/devices/{virtual_no}/cards`（绑定卡到设备）；`DELETE /api/admin/devices/{virtual_no}/cards/{iccid}`（解绑设备上的卡）；`POST /api/admin/devices/allocate`（批量分配设备）；`POST /api/admin/devices/batch-update-realname-policy`（批量更新设备实名认证策略）；`GET /api/admin/devices/by-identifier/{identifier}/gateway-slots`（查询卡槽信息）；`POST /api/admin/devices/by-identifier/{identifier}/reboot`（重启设备）；`POST /api/admin/devices/by-identifier/{identifier}/reset`（恢复出厂）；`POST /api/admin/devices/by-identifier/{identifier}/switch-card`（切卡）；`POST /api/admin/devices/by-identifier/{identifier}/switch-mode`（设置切卡模式）；`PUT /api/admin/devices/by-identifier/{identifier}/wifi`（设置 WiFi）；`POST /api/admin/devices/import`（批量导入设备）；`POST /api/admin/devices/import/allocations`（创建CSV设备批量分配或回收任务）；`GET /api/admin/devices/import/tasks`（导入任务列表）；`GET /api/admin/devices/import/tasks/{id}`（导入任务详情）；`POST /api/admin/devices/recall`（批量回收设备）；`PATCH /api/admin/devices/series-binding`（批量设置设备的套餐系列绑定）。

### 资产管理

`GET /api/admin/assets/{identifier}/current-package`（当前生效套餐）；`PATCH /api/admin/assets/{identifier}/deactivate`（停用资产）；`GET /api/admin/assets/{identifier}/operation-logs`（查询平台旧资产操作日志）；`GET /api/admin/assets/{identifier}/orders`（资产历史订单）；`GET /api/admin/assets/{identifier}/packages`（资产套餐列表）；`PATCH /api/admin/assets/{identifier}/packages/{package_usage_id}/expires-at`（修改资产套餐过期时间）；`PATCH /api/admin/assets/{identifier}/packages/{package_usage_id}/used-data`（修改资产套餐已用量）；`PATCH /api/admin/assets/{identifier}/polling-status`（更新资产轮询状态）；`PATCH /api/admin/assets/{identifier}/realname-mode`（更新资产实名认证策略）；`PATCH /api/admin/assets/{identifier}/realname-status`（手动更新卡实名状态）；`GET /api/admin/assets/{identifier}/realtime-status`（资产实时状态）；`POST /api/admin/assets/{identifier}/refresh`（刷新资产状态）；`POST /api/admin/assets/{identifier}/start`（复机）；`POST /api/admin/assets/{identifier}/stop`（停机）；`GET /api/admin/assets/{identifier}/wallet`（资产钱包概况）；`GET /api/admin/assets/{identifier}/wallet/transactions`（资产钱包流水列表）；`GET /api/admin/assets/resolve/{identifier}`（解析资产）；`GET /api/admin/expiring-assets`（查询临期资产列表）；`POST /api/admin/expiring-assets/reminder-scan`（手动触发套餐临期提醒扫描）。

### 资产分配记录

`GET /api/admin/asset-allocation-records`（分配记录列表）；`GET /api/admin/asset-allocation-records/{id}`（分配记录详情）。

### 企业卡授权

`POST /api/admin/enterprises/{id}/allocate-cards`（授权卡给企业）；`GET /api/admin/enterprises/{id}/cards`（企业卡列表）；`POST /api/admin/enterprises/{id}/recall-cards`（回收卡授权）。

### 企业设备授权

`POST /api/admin/enterprises/{id}/allocate-devices`（授权设备给企业）；`GET /api/admin/enterprises/{id}/devices`（企业设备列表）；`POST /api/admin/enterprises/{id}/recall-devices`（撤销设备授权）。