dros/src/domain/xImage.ts.md

xImage.ts

文件职责

定义影像对象（XImage） 的数据结构接口，描述从服务端返回的影像详细信息，本质上表达一个体位视图（View）。

实现方式

通过 TypeScript 接口定义影像的数据契约，包含 DICOM 标识符、文件路径、采集信息、状态标志等字段。

实现思路

1. DICOM 标识：使用 sop_instance_uid、series_instance_uid、study_instance_uid 建立影像的层级关联
2. 视图信息：包含 view_id（视图 ID）和 view_description（视图描述）标识具体体位
3. 文件路径：提供 image_file_path、image_file、thumbnail_file 定位图像和缩略图文件
4. 采集上下文：记录 acquisition_mode（采集模式）、acquisition_context（采集上下文）、img_proc_context（图像处理上下文）
5. 状态管理：多个状态字段跟踪影像生命周期（曝光状态、审核状态、发送状态、存储状态）
6. 配置信息：包含 sort（排序）、product（产品类型）、is_pre_install（是否预装协议）

边界

输入边界

• ✅ 符合 XImage 接口的对象结构
• ✅ 从服务端 API 返回的影像数据
• ❌ 不验证字段值的有效性

输出边界

• ✅ 导出 XImage 接口类型定义
• ❌ 不提供影像实例创建方法
• ❌ 不包含业务逻辑实现

职责边界

• ✅ 负责定义影像的数据结构
• ✅ 负责描述影像的状态和属性
• ❌ 不负责影像数据的持久化
• ❌ 不负责影像文件的加载和渲染
• ❌ 不负责影像状态的变更逻辑

涉及概念

SOP Instance UID：DICOM 标准中的服务对象对（Service-Object Pair）实例唯一标识符

Secondary SOP UID：次要 SOP UID，可能用于标识派生或处理后的图像

采集模式（acquisition_mode）：影像采集的模式配置

采集上下文（acquisition_context）：采集时的参数和环境信息

图像处理上下文（img_proc_context）：图像后处理的参数和配置信息

曝光状态（expose_status）：影像的曝光完成状态

审核状态（judged_status）：影像的质量审核状态

发送状态（send_status）：影像的发送状态（如发送到 PACS）

存储状态（storage_status）：影像的存储状态

TODO 注释：代码注释指出该接口应迁移到 API 目录，因为它主要用于描述 API 响应数据结构