huang
e9df1e7ded
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>
60 lines
3.5 KiB
Markdown
60 lines
3.5 KiB
Markdown
## 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`
|