openlmis/hapifhir Docker 镜像 - 轩辕镜像

OpenLMIS HAPI FHIR 镜像文档

镜像概述

OpenLMIS HAPI FHIR镜像是OpenLMIS（开源物流管理信息系统）项目的核心组件之一，基于HAPI FHIR框架构建，提供符合FHIR（健康级别的互操作性资源）标准的健康数据服务。该镜像旨在为供应链管理场景提供标准化的数据交换能力，支持OpenLMIS系统与其他信息系统间的无缝集成，实现***资源数据的规范化存储、检索与共享。

核心功能与特性

1. FHIR标准支持

• 完整实现FHIR R4规范，支持资源创建、读取、更新、删除（CRUD）操作
• 内置FHIR资源验证机制，确保数据符合行业标准
• 支持FHIR搜索参数、包含操作及事务处理

2. 与OpenLMIS集成

• 原生适配OpenLMIS数据模型，支持***产品、库存、订单等核心业务数据的FHIR转换
• 提供标准化API接口，便于OpenLMIS主系统及第三方系统调用
• 支持事件驱动的数据同步，确保物流数据与FHIR资源实时一致性

3. 可扩展性与配置

• 模块化设计，支持自定义FHIR资源类型与扩展
• 基于Spring Boot构建，支持外部化配置与环境变量注入
• 兼容主流关系型数据库（PostgreSQL、MySQL），支持数据持久化

使用场景和适用范围

适用场景

• ***供应链数据标准化：将OpenLMIS系统中的物流数据转换为FHIR标准格式，支持跨机构数据共享
• 多系统集成：作为中间件连接OpenLMIS与电子健康记录（EHR）、医院信息系统（HIS）等***信息系统
• 监管报告生成：基于FHIR资源生成符合公共卫生部门要求的标准化报表

适用范围

• ***机构物流管理部门
• 公共卫生供应链项目实施团队
• 需要实现***数据互操作性的软件开发人员

使用方法和配置说明

前置条件

• Docker Engine 19.03+
• Docker Compose 2.0+（可选，用于多容器部署）
• 可用的关系型数据库实例（PostgreSQL推荐）

快速启动（Docker Run）

bash
docker run -d \
  --name openlmis-hapifhir \
  -p 8080:8080 \
  -e SPRING_PROFILES_ACTIVE=default \
  -e SPRING_DATASOURCE_URL=jdbc:postgresql://db-host:5432/hapifhir \
  -e SPRING_DATASOURCE_USERNAME=dbuser \
  -e SPRING_DATASOURCE_PASSWORD=dbpass \
  openlmis/openlmis-hapifhir:latest

Docker Compose部署示例

yaml
version: '3.8'

services:
  hapifhir:
    image: openlmis/openlmis-hapifhir:latest
    container_name: openlmis-hapifhir
    restart: always
    ports:
      - "8080:8080"
    environment:
      - SPRING_PROFILES_ACTIVE=production
      - SERVER_PORT=8080
      - SPRING_DATASOURCE_URL=jdbc:postgresql://postgres:5432/hapifhir
      - SPRING_DATASOURCE_USERNAME=hapifhir_user
      - SPRING_DATASOURCE_PASSWORD=secure_password
      - FHIR_SERVER_NAME=OpenLMIS FHIR Server
      - FHIR_SERVER_ID=openlmis-hapifhir
    depends_on:
      - postgres

  postgres:
    image: postgres:13-alpine
    container_name: hapifhir-db
    restart: always
    environment:
      - POSTGRES_DB=hapifhir
      - POSTGRES_USER=hapifhir_user
      - POSTGRES_PASSWORD=secure_password
    volumes:
      - hapifhir-data:/var/lib/postgresql/data

volumes:
  hapifhir-data:

核心环境变量配置

验证服务可用性

服务启动后，可通过以下URL验证运行状态：

• 健康检查：http://localhost:8080/actuator/health
• FHIR能力声明：http://localhost:8080/fhir/metadata

数据持久化配置

推荐使用外部数据库实现数据持久化，示例PostgreSQL配置：

bash
-e SPRING_DATASOURCE_URL=jdbc:postgresql://postgres-host:5432/hapifhir \
-e SPRING_DATASOURCE_DRIVER_CLASS_NAME=org.postgresql.Driver \
-e SPRING_DATASOURCE_USERNAME=hapifhir_user \
-e SPRING_DATASOURCE_PASSWORD=strong_password \

自定义扩展

如需添加自定义FHIR资源或业务逻辑，可通过以下方式扩展：

1. 克隆源代码仓库：git clone [***]
2. 修改src/main/java/org/openlmis/hapifhir下的资源定义或处理器
3. 重新构建镜像：docker build -t custom-openlmis-hapifhir .

故障排除

常见问题及解决方法：

• 数据库连接失败：检查SPRING_DATASOURCE_*环境变量是否正确，确保数据库服务可访问
• FHIR资源创建失败：检查请求数据是否符合FHIR R4规范，可通过/fhir/metadata验证支持的资源类型
• 服务启动缓慢：增加容器内存限制（--memory=2g），HAPI FHIR初始化需加载大量元数据