feat: 实现物联网卡独立管理和批量导入功能

新增物联网卡独立管理模块，支持单卡查询、批量导入和状态管理。主要变更包括：

功能特性：
- 新增物联网卡 CRUD 接口（查询、分页列表、删除）
- 支持 CSV/Excel 批量导入物联网卡
- 实现异步导入任务处理和进度跟踪
- 新增 ICCID 号码格式校验器（支持 Luhn 算法）
- 新增 CSV 文件解析工具（支持编码检测和错误处理）

数据库变更：
- 移除 iot_card 和 device 表的 owner_id/owner_type 字段
- 新增 iot_card_import_task 导入任务表
- 为导入任务添加运营商类型字段

测试覆盖：
- 新增 IoT 卡 Store 层单元测试
- 新增 IoT 卡导入任务单元测试
- 新增 IoT 卡集成测试（包含导入流程测试）
- 新增 CSV 工具和 ICCID 校验器测试

文档更新：
- 更新 OpenAPI 文档（新增 7 个 IoT 卡接口）
- 归档 OpenSpec 变更提案
- 更新 API 文档规范和生成器指南

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

pkg/utils/csv.go

@@ -0,0 +1,70 @@
+package utils
+
+import (
+	"encoding/csv"
+	"io"
+	"strings"
+)
+
+type CSVParseResult struct {
+	ICCIDs      []string
+	TotalCount  int
+	ParseErrors []CSVParseError
+}
+
+type CSVParseError struct {
+	Line   int
+	ICCID  string
+	Reason string
+}
+
+func ParseICCIDFromCSV(reader io.Reader) (*CSVParseResult, error) {
+	csvReader := csv.NewReader(reader)
+	csvReader.FieldsPerRecord = -1
+	csvReader.TrimLeadingSpace = true
+
+	result := &CSVParseResult{
+		ICCIDs:      make([]string, 0),
+		ParseErrors: make([]CSVParseError, 0),
+	}
+
+	lineNum := 0
+	for {
+		record, err := csvReader.Read()
+		if err == io.EOF {
+			break
+		}
+		lineNum++
+
+		if err != nil {
+			result.ParseErrors = append(result.ParseErrors, CSVParseError{
+				Line:   lineNum,
+				Reason: "CSV 解析错误: " + err.Error(),
+			})
+			continue
+		}
+
+		if len(record) == 0 {
+			continue
+		}
+
+		iccid := strings.TrimSpace(record[0])
+		if iccid == "" {
+			continue
+		}
+
+		if lineNum == 1 && isHeader(iccid) {
+			continue
+		}
+
+		result.TotalCount++
+		result.ICCIDs = append(result.ICCIDs, iccid)
+	}
+
+	return result, nil
+}
+
+func isHeader(value string) bool {
+	lower := strings.ToLower(value)
+	return lower == "iccid" || lower == "卡号" || lower == "号码"
+}

pkg/utils/csv_test.go

@@ -0,0 +1,132 @@
+package utils
+
+import (
+	"strings"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+)
+
+func TestParseICCIDFromCSV(t *testing.T) {
+	tests := []struct {
+		name           string
+		csvContent     string
+		wantICCIDs     []string
+		wantTotalCount int
+		wantErrorCount int
+	}{
+		{
+			name:           "单列ICCID无表头",
+			csvContent:     "89860012345678901234\n89860012345678901235\n89860012345678901236",
+			wantICCIDs:     []string{"89860012345678901234", "89860012345678901235", "89860012345678901236"},
+			wantTotalCount: 3,
+			wantErrorCount: 0,
+		},
+		{
+			name:           "单列ICCID有表头-iccid",
+			csvContent:     "iccid\n89860012345678901234\n89860012345678901235",
+			wantICCIDs:     []string{"89860012345678901234", "89860012345678901235"},
+			wantTotalCount: 2,
+			wantErrorCount: 0,
+		},
+		{
+			name:           "单列ICCID有表头-ICCID大写",
+			csvContent:     "ICCID\n89860012345678901234",
+			wantICCIDs:     []string{"89860012345678901234"},
+			wantTotalCount: 1,
+			wantErrorCount: 0,
+		},
+		{
+			name:           "单列ICCID有表头-卡号",
+			csvContent:     "卡号\n89860012345678901234",
+			wantICCIDs:     []string{"89860012345678901234"},
+			wantTotalCount: 1,
+			wantErrorCount: 0,
+		},
+		{
+			name:           "单列ICCID有表头-号码",
+			csvContent:     "号码\n89860012345678901234",
+			wantICCIDs:     []string{"89860012345678901234"},
+			wantTotalCount: 1,
+			wantErrorCount: 0,
+		},
+		{
+			name:           "空文件",
+			csvContent:     "",
+			wantICCIDs:     []string{},
+			wantTotalCount: 0,
+			wantErrorCount: 0,
+		},
+		{
+			name:           "只有表头",
+			csvContent:     "iccid",
+			wantICCIDs:     []string{},
+			wantTotalCount: 0,
+			wantErrorCount: 0,
+		},
+		{
+			name:           "包含空行",
+			csvContent:     "89860012345678901234\n\n89860012345678901235\n  \n89860012345678901236",
+			wantICCIDs:     []string{"89860012345678901234", "89860012345678901235", "89860012345678901236"},
+			wantTotalCount: 3,
+			wantErrorCount: 0,
+		},
+		{
+			name:           "ICCID前后有空格",
+			csvContent:     "  89860012345678901234  \n89860012345678901235",
+			wantICCIDs:     []string{"89860012345678901234", "89860012345678901235"},
+			wantTotalCount: 2,
+			wantErrorCount: 0,
+		},
+		{
+			name:           "多列CSV只取第一列",
+			csvContent:     "89860012345678901234,额外数据,更多数据\n89860012345678901235,忽略,忽略",
+			wantICCIDs:     []string{"89860012345678901234", "89860012345678901235"},
+			wantTotalCount: 2,
+			wantErrorCount: 0,
+		},
+		{
+			name:           "Windows换行符CRLF",
+			csvContent:     "89860012345678901234\r\n89860012345678901235\r\n89860012345678901236",
+			wantICCIDs:     []string{"89860012345678901234", "89860012345678901235", "89860012345678901236"},
+			wantTotalCount: 3,
+			wantErrorCount: 0,
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			reader := strings.NewReader(tt.csvContent)
+			result, err := ParseICCIDFromCSV(reader)
+			require.NoError(t, err)
+			assert.Equal(t, tt.wantICCIDs, result.ICCIDs, "ICCIDs 不匹配")
+			assert.Equal(t, tt.wantTotalCount, result.TotalCount, "TotalCount 不匹配")
+			assert.Equal(t, tt.wantErrorCount, len(result.ParseErrors), "ParseErrors 数量不匹配")
+		})
+	}
+}
+
+func TestIsHeader(t *testing.T) {
+	tests := []struct {
+		value    string
+		expected bool
+	}{
+		{"iccid", true},
+		{"ICCID", true},
+		{"Iccid", true},
+		{"卡号", true},
+		{"号码", true},
+		{"89860012345678901234", false},
+		{"", false},
+		{"id", false},
+		{"card", false},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.value, func(t *testing.T) {
+			result := isHeader(tt.value)
+			assert.Equal(t, tt.expected, result)
+		})
+	}
+}