Jembi OpenHIM Core Docker镜像文档

镜像概述和主要用途

OpenHIM Core 是 OpenHIM（Open Health Information Mediator）健康信息交换中间件的核心组件，旨在提供医疗健康数据交换的标准化管理、路由与监控能力。作为医疗系统间数据交互的枢纽，其主要用途包括：

• 统一管理健康数据的流转路径
• 确保医疗信息在多系统间的安全、可靠传输
• 提供数据交换的事务追踪与审计能力
• 简化医疗系统集成流程，降低跨平台数据交互复杂度

核心功能和特性

1. 健康数据路由与转发

支持基于规则的健康数据路由，可根据消息内容、来源、目标系统等动态转发数据，适配HL7、FHIR等医疗数据标准。

2. 事务管理

提供端到端事务追踪，确保数据交换的完整性，支持事务重试、失败处理与状态监控。

3. 安全认证与授权

集成身份认证机制（如OAuth2、JWT）和细粒度权限控制，确保只有授权系统能访问敏感医疗数据。

4. 监控与审计

实时监控数据交换流量、成功率、响应时间等指标，生成审计日志，满足医疗行业合规性要求（如HIPAA）。

5. API管理

提供RESTful API接口，支持配置管理、路由规则定义、系统注册等操作，便于集成到现有医疗IT系统。

6. 可扩展性

支持插件机制，可扩展自定义处理逻辑，适配不同医疗场景需求。

使用场景和适用范围

适用场景

• 区域健康信息交换平台：作为区域内医疗数据流转的核心枢纽，连接医院、诊所、公共卫生机构等。
• 医疗机构间数据共享：实现不同医院信息系统（HIS、LIS、PACS）间患者数据、检查结果的安全交换。
• 医疗系统集成：对接电子健康档案（EHR）、医保系统、公共卫生监测系统等，统一数据交互接口。
• 健康数据监控与审计：对医疗数据交换进行全链路追踪，满足监管与合规要求。

适用范围

• 医疗健康领域的软件开发商、系统集成商
• 医院、卫生部门等医疗机构IT团队
• 医疗数据平台运维与管理人员

详细使用方法和配置说明

1. Docker镜像构建与发布流程

以下步骤基于Docker Hub环境，用于创建并发布新的OpenHIM Core Docker镜像版本：

步骤1：创建版本文件夹

为新发布候选版本创建独立文件夹，文件夹名称需与发布版本号一致（如版本v1.0.0对应文件夹1.0.0）。

步骤2：准备Dockerfile

复制历史版本的Dockerfile至新文件夹，并修改文件内的版本号，确保与目标发布版本一致。

步骤3：创建发布标签

在代码仓库中创建发布标签，命名格式为{分支名}-{新发布版本}，例如：core-v1.0.0（core为分支名，v1.0.0为版本号）。

步骤4：配置Docker Hub构建

登录Docker Hub，为新发布版本添加构建设置，具体参数如下：

• 类型：Tag
• 名称：与步骤3创建的标签一致（如core-v1.0.0）
• Dockerfile位置：步骤1创建的文件夹名称（如1.0.0）
• Docker Tag名称：发布版本号（如1.0.0）

2. Docker镜像运行与配置

基本运行命令

docker run -d \
  --name openhim-core \
  -p 5000:5000 \  # API端口
  -p 8080:8080 \  # 管理界面端口
  -v /path/to/config:/etc/openhim \  # 挂载配置文件目录
  -v /path/to/data:/var/lib/openhim \  # 挂载数据持久化目录
  -e DB_HOST=db.example.com \         # 数据库主机
  -e DB_PORT=27017 \                  # 数据库端口
  -e DB_NAME=openhim \                # 数据库名称
  -e DB_USER=openhim-user \           # 数据库用户名
  -e DB_PASSWORD=secure-password \    # 数据库密码
  jembi/openhim-core:1.0.0            # 镜像及版本

关键配置参数与环境变量

注意事项

• 首次运行需通过管理界面（http://localhost:8080）完成初始配置（如管理员账户设置、系统参数调整）。
• 生产环境中需确保JWT_SECRET、数据库密码等敏感信息通过安全方式注入（如Docker Secrets或环境变量加密）。
• 数据持久化目录（/var/lib/openhim）需定期备份，避免数据丢失。
• 镜像版本需与依赖组件（如数据库、前端界面）版本兼容，建议参考官方发布说明。