huang
70fb7dadef
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 7m53s
1.7 KiB
1.7 KiB
Why
feature-2026-04-device-import-slot-mapping
当前设备导入会把 Excel 中非空 ICCID 列压缩成连续列表，导致“卡2、卡3”这类原始槽位信息在导入时丢失，最终被错误写入为“槽1、槽2”。该问题会直接造成设备与卡槽关系失真，影响后续设备查询、切卡和运维判断，需要尽快在规格和实现层统一修正。
What Changes
- 修改设备导入规格，明确
卡1~卡4列表示固定槽位，导入时必须保留原始列位信息，不得按非空顺序重排。 - 修改设备导入执行规则，设备卡绑定记录的
slot_position必须与 Excel 列号一一对应。 - 新增越界约束：当
max_sim_slots小于某个已填写 ICCID 的槽位编号时，该行导入失败，避免写入超出设备最大槽位数的绑定关系。 - 补充典型场景，覆盖“仅填写卡2/卡3”“前置空槽保留”“超出最大槽位失败”等业务行为。
Capabilities
New Capabilities
无新增功能
Modified Capabilities
device-import: 设备导入的槽位语义从“按非空 ICCID 顺序绑定”调整为“按 Excel 固定列位绑定到对应槽位”，并补充超出max_sim_slots的失败规则。
Impact
- 受影响规格：
openspec/specs/device-import/spec.md - 受影响代码：
pkg/utils/excel.go中设备导入行的 ICCID 解析结构internal/task/device_import.go中设备卡绑定创建逻辑
- 受影响数据：新导入设备的
tb_device_sim_binding.slot_position写入规则 - 受影响业务链路：设备详情、设备卡绑定列表、依赖槽位判断的运维操作
- 依赖与接口：不新增外部依赖，不新增 API，仅修正既有导入行为