# 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 响应数据结构