# Carrier Management Specification

## ADDED Requirements

### Requirement: 运营商列表查询

系统 SHALL 提供运营商列表查询功能，支持分页和多条件筛选。

#### Scenario: 获取所有运营商列表

- **WHEN** 用户访问运营商管理页面
- **THEN** 系统应显示运营商列表，包含运营商 ID、名称、编码、类型、描述、状态、创建时间、更新时间
- **AND** 列表应支持分页展示

#### Scenario: 按运营商名称模糊搜索

- **WHEN** 用户在搜索框输入运营商名称并点击搜索
- **THEN** 系统应返回名称匹配的运营商列表
- **AND** 支持模糊匹配

#### Scenario: 按运营商类型筛选

- **WHEN** 用户选择运营商类型（CMCC/CUCC/CTCC/CBN）并点击搜索
- **THEN** 系统应返回指定类型的运营商列表

#### Scenario: 按状态筛选

- **WHEN** 用户选择状态（启用/禁用）并点击搜索
- **THEN** 系统应返回指定状态的运营商列表

#### Scenario: 组合条件筛选

- **WHEN** 用户同时指定多个筛选条件
- **THEN** 系统应返回满足所有条件的运营商列表

### Requirement: 创建运营商

系统 SHALL 提供创建运营商的功能，允许运营人员添加新的运营商信息。

#### Scenario: 成功创建运营商

- **WHEN** 用户点击"新增运营商"按钮并填写完整的必填信息（运营商编码、运营商名称、运营商类型）
- **THEN** 系统应创建新的运营商记录
- **AND** 显示成功消息
- **AND** 刷新运营商列表

#### Scenario: 创建运营商时必填字段验证

- **WHEN** 用户提交创建表单但缺少必填字段
- **THEN** 系统应显示验证错误消息
- **AND** 阻止表单提交

#### Scenario: 运营商编码长度验证

- **WHEN** 用户输入的运营商编码长度不在 1-50 个字符之间
- **THEN** 系统应显示验证错误消息

#### Scenario: 运营商名称长度验证

- **WHEN** 用户输入的运营商名称长度不在 1-100 个字符之间
- **THEN** 系统应显示验证错误消息

#### Scenario: 运营商描述长度验证

- **WHEN** 用户输入的运营商描述超过 500 个字符
- **THEN** 系统应显示验证错误消息

### Requirement: 编辑运营商

系统 SHALL 允许用户编辑现有运营商的信息。

#### Scenario: 成功编辑运营商

- **WHEN** 用户点击编辑按钮并修改运营商信息后提交
- **THEN** 系统应更新运营商记录
- **AND** 显示成功消息
- **AND** 刷新运营商列表

#### Scenario: 编辑时只能修改名称和描述

- **WHEN** 用户编辑运营商时
- **THEN** 系统应只允许修改运营商名称和描述
- **AND** 运营商编码、运营商类型应不可修改

#### Scenario: 编辑时表单验证

- **WHEN** 用户修改运营商信息但不符合验证规则
- **THEN** 系统应显示验证错误消息
- **AND** 阻止表单提交

### Requirement: 删除运营商

系统 SHALL 允许用户删除运营商记录。

#### Scenario: 成功删除运营商

- **WHEN** 用户点击删除按钮并确认删除操作
- **THEN** 系统应删除该运营商记录
- **AND** 显示成功消息
- **AND** 刷新运营商列表

#### Scenario: 删除前二次确认

- **WHEN** 用户点击删除按钮
- **THEN** 系统应显示确认对话框
- **AND** 提示用户确认删除操作

#### Scenario: 取消删除操作

- **WHEN** 用户在确认对话框中点击取消
- **THEN** 系统应取消删除操作
- **AND** 保留运营商记录

### Requirement: 运营商状态管理

系统 SHALL 提供运营商状态切换功能（启用/禁用）。

#### Scenario: 成功切换运营商状态

- **WHEN** 用户点击状态开关
- **THEN** 系统应立即更新运营商状态
- **AND** 显示成功消息
- **AND** UI 应反映新的状态

#### Scenario: 状态切换失败时回滚

- **WHEN** 状态切换请求失败
- **THEN** 系统应恢复原状态
- **AND** 显示错误消息

### Requirement: 获取运营商详情

系统 SHALL 提供获取单个运营商详细信息的功能。

#### Scenario: 成功获取运营商详情

- **WHEN** 系统需要获取特定运营商的详细信息
- **THEN** 系统应返回该运营商的完整信息
- **AND** 包含运营商 ID、编码、名称、类型、描述、状态、创建时间、更新时间

### Requirement: 运营商类型定义

系统 SHALL 支持以下运营商类型。

#### Scenario: 运营商类型枚举

- **WHEN** 系统处理运营商类型
- **THEN** 系统应支持以下类型：
  - CMCC: 中国移动
  - CUCC: 中国联通
  - CTCC: 中国电信
  - CBN: 中国广电

### Requirement: 数据展示和格式化

系统 SHALL 正确展示和格式化运营商数据。

#### Scenario: 运营商类型显示

- **WHEN** 在列表中显示运营商类型
- **THEN** 系统应将类型代码转换为可读的中文名称
- **AND** 使用不同的标签颜色区分不同类型

#### Scenario: 状态显示

- **WHEN** 在列表中显示运营商状态
- **THEN** 系统应使用开关组件展示状态
- **AND** 启用状态显示为绿色"启用"
- **AND** 禁用状态显示为红色"禁用"

#### Scenario: 时间格式化

- **WHEN** 显示创建时间和更新时间
- **THEN** 系统应将时间格式化为 YYYY-MM-DD HH:mm:ss 格式

### Requirement: 权限控制

系统 SHALL 对运营商管理功能进行权限控制。

#### Scenario: 基于角色的访问控制

- **WHEN** 用户访问运营商管理页面
- **THEN** 系统应验证用户是否有访问权限
- **AND** 无权限用户应被重定向到 403 页面

### Requirement: 错误处理

系统 SHALL 正确处理各种错误情况。

#### Scenario: API 请求失败处理

- **WHEN** API 请求失败
- **THEN** 系统应显示友好的错误消息
- **AND** 不应中断用户操作流程

#### Scenario: 网络错误处理

- **WHEN** 发生网络错误
- **THEN** 系统应提示用户检查网络连接
- **AND** 允许用户重试操作