# series.ts

## 文件职责

定义**影像系列（Series）** 的数据结构接口，描述 DICOM 检查中的一个序列及其包含的图像集合。

## 实现方式

通过 **TypeScript 接口**定义系列的数据契约，包含 DICOM 标识符、检查关联、部位信息、协议配置和图像列表等字段。

## 实现思路

1. **唯一标识**：使用 series_instance_uid 作为系列的 DICOM 唯一标识符
2. **层级关联**：通过 study_instance_uid、study_id、procedure_id 建立与检查、流程的关联关系
3. **检查信息**：包含 body_part（检查部位）、performed_datetime（执行时间）等检查相关信息
4. **协议配置**：使用 performed_protocol_code_meaning 和 performed_protocol_code_value 描述执行的协议
5. **排序与分类**：使用 sort 字段控制显示顺序，product 标识产品类型，is_pre_install 标识是否为预装协议
6. **图像集合**：包含 images 数组，存储该系列下的所有 XImage 图像对象

## 边界

### 输入边界

- ✅ 符合 Series 接口的对象结构
- ✅ images 字段为 XImage 类型数组
- ❌ 不验证字段值的有效性

### 输出边界

- ✅ 导出 Series 接口类型定义
- ❌ 不提供系列实例创建方法
- ❌ 不包含业务逻辑实现

### 职责边界

- ✅ 负责定义系列的数据结构
- ✅ 负责描述系列与其他实体的关联关系
- ❌ 不负责系列数据的持久化
- ❌ 不负责图像的加载和管理
- ❌ 不负责协议的执行逻辑

## 涉及概念

**系列（Series）**：DICOM 标准中的一个序列，包含同一检查下相同部位、相同协议的一组图像

**Series Instance UID**：DICOM 系列实例唯一标识符，遵循 DICOM 标准

**协议代码（Protocol Code）**：描述检查协议的标准化代码，包含 meaning（含义）和 value（值）

**执行时间（performed_datetime）**：系列执行的日期时间，可能为 null 表示未执行

**预装协议（is_pre_install）**：标识该系列是否使用预装的标准协议配置

**图像集合（images）**：该系列包含的所有 XImage 对象数组