dros/src/domain/series.ts.md

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 对象数组