OpenLMIS Fulfillment Service 镜像文档

镜像概述

OpenLMIS履行服务（OpenLMIS Fulfillment Service）是OpenLMIS系统的核心服务组件，专注于提供履行（Fulfillment）相关功能。该服务支持物流管理流程中的订单履行、库存分配及业务流程管理，是OpenLMIS系统架构中的重要组成部分。

项目源代码托管于GitHub：[***]

核心功能和特性

• 履行流程管理：支持订单从接收至完成履行的全流程跟踪与管理
• 库存分配逻辑：根据订单需求自动或手动进行库存分配与调度
• 履行状态监控：提供履行环节各节点的状态更新与监控功能
• 系统集成能力：与OpenLMIS生态中的其他服务（如库存服务、订单服务等）无缝集成

使用场景和适用范围

该镜像主要适用于OpenLMIS系统的部署环境，作为履行环节的核心服务组件，适用于：

• ***物资供应链管理系统中的订单履行环节
• 公共卫生物流信息平台的履行流程处理
• 基于OpenLMIS构建的各类物流管理系统中需要履行功能的场景

使用方法和配置说明

基本部署（Docker Run）

通过以下命令启动服务容器：

bash
docker run -d \
  --name openlmis-fulfillment \
  -p 8080:8080 \
  openlmis/fulfillment-service:latest

环境变量配置

服务支持通过环境变量进行参数配置，关键配置项包括（具体参数请参考GitHub文档）：

• SPRING_PROFILES_ACTIVE：指定运行环境（如dev、prod）
• DB_HOST：数据库主机地址
• DB_NAME：履行服务数据库名称
• DB_USER：数据库访问用户名
• DB_PASSWORD：数据库访问密码

带环境变量的启动示例：

bash
docker run -d \
  --name openlmis-fulfillment \
  -p 8080:8080 \
  -e SPRING_PROFILES_ACTIVE=prod \
  -e DB_HOST=openlmis-db \
  -e DB_NAME=openlmis_fulfillment \
  -e DB_USER=fulfillment_user \
  -e DB_PASSWORD=secure_password \
  openlmis/fulfillment-service:latest

Docker Compose 部署示例

在OpenLMIS系统集群部署中，可通过docker-compose.yml集成该服务：

yaml
version: '3'
services:
  fulfillment-service:
    image: openlmis/fulfillment-service:latest
    ports:
      - "8080:8080"
    environment:
      - SPRING_PROFILES_ACTIVE=prod
      - DB_HOST=postgres
      - DB_NAME=openlmis_fulfillment
      - DB_USER=dbuser
      - DB_PASSWORD=dbpass
    depends_on:
      - postgres
    restart: unless-stopped

  postgres:
    image: postgres:13
    environment:
      - POSTGRES_DB=openlmis_fulfillment
      - POSTGRES_USER=dbuser
      - POSTGRES_PASSWORD=dbpass
    volumes:
      - postgres-data:/var/lib/postgresql/data

volumes:
  postgres-data:

注意事项

• 该服务需与OpenLMIS系统其他组件协同工作，单独部署可能无法正常运行
• 详细配置参数、API文档及扩展说明请参考项目GitHub仓库文档
• 生产环境部署前需根据实际需求调整资源配置（如内存、CPU限制）