feat: 实现运营商模块重构，添加冗余字段优化查询性能

主要变更：
- 新增 Carrier CRUD API（创建、列表、详情、更新、删除、状态更新）
- IotCard/IotCardImportTask 添加 carrier_type/carrier_name 冗余字段
- 移除 Carrier 表的 channel_name/channel_code 字段
- 查询时直接使用冗余字段，避免 JOIN Carrier 表
- 添加数据库迁移脚本（000021-000023）
- 添加单元测试和集成测试
- 同步更新 OpenAPI 文档和 specs

openspec/changes/archive/2026-01-27-carrier-module-refactor/specs/carrier-management/spec.md

@@ -0,0 +1,79 @@
+## ADDED Requirements
+
+### Requirement: 创建运营商
+系统 SHALL 允许管理员创建新的运营商记录。创建时必须指定 carrier_code（唯一编码）、carrier_name（显示名称）、carrier_type（运营商类型，枚举值）。description 为选填字段。创建成功后默认状态为启用（status=1）。
+
+#### Scenario: 成功创建运营商
+- **WHEN** 管理员提交有效的创建请求，carrier_code 不重复，carrier_type 为有效枚举值
+- **THEN** 系统创建运营商记录，返回完整的运营商信息
+
+#### Scenario: carrier_code 重复
+- **WHEN** 管理员提交的 carrier_code 已存在
+- **THEN** 系统返回错误"运营商编码已存在"
+
+#### Scenario: carrier_type 无效
+- **WHEN** 管理员提交的 carrier_type 不是 CMCC/CUCC/CTCC/CBN 之一
+- **THEN** 系统返回参数校验错误
+
+### Requirement: 查询运营商列表
+系统 SHALL 提供分页查询运营商列表的接口，支持按 carrier_type、status、carrier_name（模糊搜索）筛选。
+
+#### Scenario: 无筛选条件查询
+- **WHEN** 管理员请求列表，不带筛选条件
+- **THEN** 系统返回所有运营商的分页列表，按 ID 降序排列
+
+#### Scenario: 按运营商类型筛选
+- **WHEN** 管理员指定 carrier_type=CMCC
+- **THEN** 系统仅返回 carrier_type 为 CMCC 的记录
+
+#### Scenario: 按名称模糊搜索
+- **WHEN** 管理员指定 carrier_name=移动
+- **THEN** 系统返回 carrier_name 包含"移动"的记录
+
+### Requirement: 获取运营商详情
+系统 SHALL 允许管理员通过 ID 获取单个运营商的详细信息。
+
+#### Scenario: 成功获取详情
+- **WHEN** 管理员请求存在的运营商 ID
+- **THEN** 系统返回该运营商的完整信息
+
+#### Scenario: 运营商不存在
+- **WHEN** 管理员请求不存在的运营商 ID
+- **THEN** 系统返回错误"运营商不存在"
+
+### Requirement: 更新运营商
+系统 SHALL 允许管理员更新运营商的 carrier_name 和 description 字段。carrier_code 和 carrier_type 创建后不可修改。
+
+#### Scenario: 成功更新运营商
+- **WHEN** 管理员提交有效的更新请求
+- **THEN** 系统更新运营商信息，返回更新后的完整信息
+
+#### Scenario: 尝试修改 carrier_code
+- **WHEN** 管理员尝试修改 carrier_code
+- **THEN** 系统忽略该字段（不报错，但不修改）
+
+### Requirement: 删除运营商
+系统 SHALL 允许管理员软删除运营商记录。
+
+#### Scenario: 成功删除运营商
+- **WHEN** 管理员请求删除存在的运营商
+- **THEN** 系统软删除该记录（设置 deleted_at）
+
+#### Scenario: 删除不存在的运营商
+- **WHEN** 管理员请求删除不存在的运营商 ID
+- **THEN** 系统返回错误"运营商不存在"
+
+### Requirement: 更新运营商状态
+系统 SHALL 允许管理员启用或禁用运营商。状态值：1=启用，2=禁用。
+
+#### Scenario: 启用运营商
+- **WHEN** 管理员将状态设置为 1
+- **THEN** 系统更新运营商状态为启用
+
+#### Scenario: 禁用运营商
+- **WHEN** 管理员将状态设置为 2
+- **THEN** 系统更新运营商状态为禁用
+
+#### Scenario: 无效状态值
+- **WHEN** 管理员提交的状态值不是 1 或 2
+- **THEN** 系统返回参数校验错误

openspec/changes/archive/2026-01-27-carrier-module-refactor/specs/iot-card-import/spec.md

@@ -0,0 +1,19 @@
+## MODIFIED Requirements
+
+### Requirement: 导入物联网卡时记录运营商信息
+系统 SHALL 在导入物联网卡时，将运营商的 carrier_type 和 carrier_name 作为冗余字段存储到 IotCard 记录中。这些字段在导入时从 Carrier 表查询并写入，后续不再依赖 Carrier 表。
+
+#### Scenario: 导入时填充冗余字段
+- **WHEN** 系统处理物联网卡导入任务
+- **THEN** 系统根据 carrier_id 查询 Carrier 表，将 carrier_type 和 carrier_name 写入每条 IotCard 记录
+
+#### Scenario: Carrier 不存在
+- **WHEN** 导入任务指定的 carrier_id 对应的 Carrier 不存在或已删除
+- **THEN** 系统拒绝导入，返回错误"运营商不存在"
+
+### Requirement: 导入任务记录运营商名称
+系统 SHALL 在创建导入任务时，将 carrier_name 作为冗余字段存储到 IotCardImportTask 记录中（已有 carrier_type）。
+
+#### Scenario: 创建导入任务时填充 carrier_name
+- **WHEN** 管理员创建物联网卡导入任务
+- **THEN** 系统根据 carrier_id 查询 Carrier 表，将 carrier_name 写入导入任务记录

openspec/changes/archive/2026-01-27-carrier-module-refactor/specs/iot-card-query/spec.md

@@ -0,0 +1,26 @@
+## MODIFIED Requirements
+
+### Requirement: 查询物联网卡时返回运营商信息
+系统 SHALL 在查询物联网卡列表/详情时，直接从 IotCard 记录的冗余字段返回 carrier_type 和 carrier_name，无需 JOIN Carrier 表。
+
+#### Scenario: 列表查询返回运营商信息
+- **WHEN** 管理员查询物联网卡列表
+- **THEN** 响应中的 carrier_type 和 carrier_name 直接来自 IotCard 记录的冗余字段
+
+#### Scenario: 详情查询返回运营商信息
+- **WHEN** 管理员查询单张物联网卡详情
+- **THEN** 响应中的 carrier_type 和 carrier_name 直接来自 IotCard 记录的冗余字段
+
+### Requirement: 查询导入任务时返回运营商名称
+系统 SHALL 在查询导入任务列表/详情时，直接从 IotCardImportTask 记录的冗余字段返回 carrier_name，无需 JOIN Carrier 表。
+
+#### Scenario: 导入任务列表返回运营商名称
+- **WHEN** 管理员查询导入任务列表
+- **THEN** 响应中的 carrier_name 直接来自 IotCardImportTask 记录的冗余字段
+
+### Requirement: 设备绑定卡查询返回运营商信息
+系统 SHALL 在查询设备绑定的物联网卡时，直接从 IotCard 记录的冗余字段返回 carrier_name，无需 JOIN Carrier 表。
+
+#### Scenario: 设备绑定卡列表返回运营商名称
+- **WHEN** 管理员查询设备绑定的物联网卡列表
+- **THEN** 响应中的 carrier_name 直接来自 IotCard 记录的冗余字段