nhsdev/nia-ps-adaptor

Patient Switching Adaptor 镜像文档

1. 镜像概述

1.1 主要用途

Patient Switching Adaptor 是一个专为健康领域设计的工具镜像，主要用于在电子健康记录（Electronic Health Record, EHR）系统间实现数据交换。其核心功能包括创建 EHR 请求、生成 GP2GP Spine 消息，以及将 HL7 V3 格式的响应数据转换为 FHIR 标准格式，从而支持系统间标准化的数据交互流程。

2. 核心功能与特性

• EHR 请求创建：支持生成符合***标准的 EHR 数据请求，满足电子健康记录查询与交换需求。
• HL7 V3 至 FHIR 格式转换：提供自动化的数据格式转换能力，将 HL7 V3 响应数据标准化为 FHIR 格式，简化不同系统间的数据解析与集成。
• GP2GP Spine 消息生成：支持生成 GP2GP（General Practitioner to General Practitioner）流程所需的 Spine 消息，适配英国国家***服务（NHS）的 GP 间患者数据转移标准。

3. 使用场景与适用范围

3.1 适用场景

• ***健康系统 EHR 数据交换：适用于需要在不同 EHR 系统间查询、传输患者健康记录的场景。
• GP2GP 数据转移流程：支持英国 NHS 体系中 GP 诊所间患者数据转移的 Spine 消息生成与处理。
• ***数据格式标准化：在需要将 legacy HL7 V3 数据转换为 FHIR 标准格式的系统集成项目中使用，提升数据互操作性。

3.2 适用范围

主要面向健康领域的软件开发人员、系统集成商及机构 IT 团队，用于构建或集成 EHR 数据交换模块，尤其适用于遵循 NHS 数字标准的***信息系统。

4. 使用方法与配置说明

4.1 前提条件

• 已安装 Docker 或 Docker Compose 环境。
• 需获取并配置***系统接入所需的认证凭证（如 API 密钥、证书等，具体依赖目标环境要求）。

4.2 Docker 快速启动（docker run）

通过以下命令可快速启动容器（具体参数需根据实际环境调整）：

bash
docker run -d \
  --name patient-switching-adaptor \
  -p 8080:8080 \  # 映射容器端口至主机（默认端口需参考官方配置）
  -v /path/to/local/config:/app/config \  # 挂载本地配置文件（如有）
  -e LOG_LEVEL=INFO \  # 设置日志级别（示例）
  nhsdigital/nia-patient-switching-standard-adaptor:latest

说明：上述命令中的端口映射、配置文件路径及环境变量需根据实际部署需求调整，具体配置项请参考官方文档。

4.3 Docker Compose 部署

创建 docker-compose.yml 文件，示例配置如下：

yaml
version: '3.8'
services:
  patient-switching-adaptor:
    image: docker.xuanyuan.run/nhsdigital/nia-patient-switching-standard-adaptor:latest
    container_name: patient-switching-adaptor
    ports:
      - "8080:8080"  # 应用服务端口
    volumes:
      - ./config:/app/config  # 挂载本地配置目录
    environment:
      - SPRING_PROFILES_ACTIVE=production  # 激活生产环境配置（示例）
      - API_ENDPOINT=https://spine-api.nhs.uk  # Spine API 端点（示例）
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

4.4 配置参数说明

容器的核心配置需通过环境变量或挂载配置文件实现，主要配置项包括（具体以官方文档为准）：

• 服务端口：容器内应用监听端口（如 8080）。
• 外部 API 端点：如 Spine 服务接口地址、EHR 数据源地址等。
• 认证配置：API 密钥、证书路径、OAuth2 配置等（***系统通常需严格认证）。
• 日志配置：日志级别（INFO/DEBUG/ERROR）、输出路径等。

注意：详细配置参数及默认值请参考 https://github.com/NHSDigital/nia-patient-switching-standard-adaptor 的文档。

5. 维护与支持

5.1 维护方

该镜像由 NHS Digital 维护，确保其符合***行业数据交换标准及安全要求。

5.2 获取帮助与提交问题

• 帮助信息与文档：访问 https://github.com/NHSDigital/nia-patient-switching-standard-adaptor 获取详细使用指南、配置示例及更新日志。
• 问题反馈：通过 https://github.com/NHSDigital/nia-patient-switching-standard-adaptor/issues 提交 bug 报告或功能需求。