feat: IoT卡新增绑定设备虚拟号快照字段
All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 7m28s

- tb_iot_card 新增 device_virtual_no 字段,存储绑定设备的虚拟号快照
- 列表/详情接口响应新增 device_virtual_no 字段
- 列表接口 is_standalone 改为可选参数(不传返回全部卡)
- 移除列表接口 virtual_no 查询参数
- 绑卡/解绑时同步更新 device_virtual_no 快照
- 设备导入时批量写入 device_virtual_no 快照
- 归档 feat-iot-card-device-virtual-no 变更提案

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-04-09 10:50:46 +08:00
parent cc56e27c01
commit e9df1e7ded
16 changed files with 421 additions and 704 deletions

View File

@@ -0,0 +1,59 @@
## ADDED Requirements
### Requirement: IoT 卡列表展示绑定设备的虚拟号
`tb_iot_card` 表 SHALL 新增 `device_virtual_no VARCHAR(100) NOT NULL DEFAULT ''` 列,存储当前绑定设备的虚拟号快照。未绑定设备时该字段为空字符串。列表和详情接口 SHALL 在响应中返回 `device_virtual_no` 字段。
#### Scenario: 未绑定设备的卡响应 device_virtual_no 为空
- **WHEN** 请求 `GET /api/admin/iot-cards/standalone` 列表
- **THEN** `is_standalone = true` 的卡响应中 `device_virtual_no` 为空字符串 `""`
#### Scenario: 已绑定设备的卡响应包含设备虚拟号
- **WHEN** 请求 `GET /api/admin/iot-cards/standalone` 列表(不带 `is_standalone` 参数)
- **THEN** `is_standalone = false` 的卡也出现在结果中,且 `device_virtual_no` 等于绑定设备的 `virtual_no`
#### Scenario: 详情接口包含设备虚拟号
- **WHEN** 请求 `GET /api/admin/iot-cards/standalone/:iccid` 且该卡绑定了设备
- **THEN** 响应中 `device_virtual_no` 等于绑定设备的 `virtual_no`
### Requirement: `is_standalone` 作为可选查询参数
列表接口 `GET /api/admin/iot-cards/standalone` SHALL 接受可选布尔参数 `is_standalone`。不传时 SHALL 返回全部卡(含绑定设备的卡);传 `true` 时仅返回未绑定设备的卡;传 `false` 时仅返回已绑定设备的卡。
#### Scenario: 不传 is_standalone 返回全部卡
- **WHEN** 请求列表且不携带 `is_standalone` 参数
- **THEN** 返回结果包含独立卡和绑定设备的卡
#### Scenario: 传 is_standalone=true 仅返回独立卡
- **WHEN** 请求列表携带 `is_standalone=true`
- **THEN** 返回结果只包含 `is_standalone = true` 的卡
#### Scenario: 传 is_standalone=false 仅返回绑定卡
- **WHEN** 请求列表携带 `is_standalone=false`
- **THEN** 返回结果只包含 `is_standalone = false` 的卡
### Requirement: 移除列表接口的 virtual_no 查询参数
`GET /api/admin/iot-cards/standalone` 请求 SHALL NOT 再接受 `virtual_no` 查询参数。
#### Scenario: 传入 virtual_no 参数不产生过滤效果
- **WHEN** 请求列表携带 `virtual_no=xxx`
- **THEN** 参数被忽略,接口正常返回全部卡(不报错,不过滤)
### Requirement: 绑定设备时快照写入 device_virtual_no
执行 `BindCard`POST `/api/admin/devices/:virtual_no/cards`)成功后,系统 SHALL 将被绑定卡的 `device_virtual_no` 更新为设备的 `virtual_no`
#### Scenario: 绑卡后卡的 device_virtual_no 被写入
- **WHEN** 成功调用 BindCard 将 IoT 卡绑定到设备
- **THEN** `tb_iot_card.device_virtual_no` = 对应设备的 `virtual_no`
### Requirement: 解绑设备时清空 device_virtual_no
执行 `UnbindCard`DELETE `/api/admin/devices/:virtual_no/cards/:iccid`)成功后,系统 SHALL 将被解绑卡的 `device_virtual_no` 清空为空字符串。
#### Scenario: 解绑后卡的 device_virtual_no 被清空
- **WHEN** 成功调用 UnbindCard 将 IoT 卡从设备解绑
- **THEN** `tb_iot_card.device_virtual_no` = `""`
### Requirement: 设备导入时批量快照 device_virtual_no
设备导入任务处理成功绑定关系后,系统 SHALL 批量将被绑定卡的 `device_virtual_no` 更新为该设备的 `virtual_no`
#### Scenario: 设备导入时绑定的卡 device_virtual_no 被写入
- **WHEN** 设备导入 Excel 中某行包含设备虚拟号和一组 ICCID导入任务处理成功
- **THEN** 该组 ICCID 对应卡的 `device_virtual_no` = 设备的 `virtual_no`