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>
3.5 KiB
3.5 KiB
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